
******************** Modifier ********************
*  A Mod Configuration Tool for S.T.A.L.K.E.R. SOC
*  Copyright  2007-2009 Metacognix
*  All Worldwide Rights Reserved
*
*  Change History:
*    NatVac, 2009/09/12 - Added SMM warning
*    NatVac, 2009/01/25 - Added Field alias support
*    NatVac, 2008/11/01 - Added FileChoice warning
*    NatVac, 2008/02/15 - Checkbox support added
*    NatVac, 2007/11/08 - Initial release 1.0
**************************************************

Please see the warning about mod compatibility below before using this 
program.  Also note that some changes may require starting a new game.

==================================================
Installation:

This program and its configuration and help files must be placed in the 
gamedata directory of the mod you wish to configure. A shortcut can be 
placed on your desktop by right-click-dragging the Modifier.exe icon 
from the Windows Explorer pane to the desktop, then selecting "Create 
shortcuts here". 

You will need write permission for the STALKER gamedata directory and 
subdirectories to run this program, as it needs to modify the game's 
configuration and script files.  While the easiest way to do this is 
to run the program with administrator rights or at least sufficient 
privilege to allow this modification, it is recommended that you simply 
change the directory access permission.

To find out how to do this, consult the help support for your version of 
Windows.  In Windows XP:  Open Explorer and select Help > Help and 
Support Center.  Select "System Administration", then select "Access 
Control".  Select "Set, view, change, or remove file and folder 
permissions".


==================================================
Running the program:

Choose the configuration set from those in the list in the drop-down 
combobox in the upper left corner. The configurable items will appear 
in the listbox on the left. 

Select an item in the listbox by clicking on it. This will show the 
possible choices for that item in the panel on the right. 

Hover the mouse pointer over the radio button groupbox or the various 
edit boxes to see pop-up hints about the item. 

Edit boxes will usually have a default value shown to the right as well 
as the current setting for the parameter if any. 

Select a radio button or change the contents of the edit boxes to suit 
your desires. 

You will see error messages if the configuration is invalid, or if the 
expected files are missing. The situation needs to be corrected before 
the program can be used to change the associated settings. The 
configuration files can be edited with a text editor; see the 
ModifierNotes.txt file for details. 


*******************************************************************

                   Mod Compatibility Warning:

Some mods have their own custom screens and configuration files.  You 
should take care not to replace the custom mod's files with ones from 
the ZRP.

There are different kinds of entries, FileChoice, Field and LineToggle. 
Only one of these types can cause conflicts with mods:  FileChoice.
As of version 1.1 alpha r3, the potentially-dangerous file copy entries 
are indicated by a red warning above the FileChoice radio-button group.

It is recommended to make FileChoice changes before installing other 
mods.  This should be done outside of Smart Mod Manager, if you use it. 
To do this, extract the ZRP directory from the archive, the run the 
Modifier program in the gamedata directory there to make your changes.  
Then install the modified ZRP with SMM and follow with the other mods.

It is okay to modify entries afterward if they do not have the warning 
text on the entry's page.  The SMM program changes files when it merges 
them, and this might cause the Modifier program to complain.  Follow 
the advice in the previous paragraph if necessary, or don't use SMM.

You can merge these optional files with other mods beforehand.  View 
the *.cfg file in a text editor to see what files are copied.  Then 
compare the related files with the corresponding files in other mods.

*******************************************************************


==================================================
The APPLY button:

When done with the panel changes, click the Apply button. Changes are 
NOT applied until you do so! Currently, if you select a new item in the 
listbox without clicking Apply, any changes will be abandoned -- even 
if you select the same item. 

The REVERT button: 

When the Apply button is first clicked for a setting, the original 
files if they exist are copied to "filenames.ext.orig_bkup", so that 
you can revert to the original file if you want by clicking on the 
Revert button. NOTE: This original file is never overwritten, so 
reverting will always copy the original unmodified file back. 

The revert process will show a status pop-up of what was copied or not 
copied. 

The DEFAULT button: 

Currently, this button only appears on panels with fields (edit boxes). 
It allows you to restore the vanilla values as shown to the right of 
the edit boxes. You will need to click the Apply button to accept the 
changes. 

The HELP button will show this file, while the ABOUT button will show 
info about the program. 

