Configuring WCCMMUD.INI (sys gotos, etc)
Posted: Thu Jul 24, 2003 1:01 am
this is taken directly from WCCMMUD.RLN, most people just overlook it.
-syn
///////////////////////////////////////////////////////////////////////
3.1) OPTIONAL CONFIGURATION OPTIONS
For various reasons, I want to get away from using CNF options and switch
to an alternative form of adding sysop configurable options to MajorMUD.
The new method will be via the use of a text file called WCCMMUD.INI. I
do not plan on creating any interface to access this file so the only way
you will be able to change options in this file is with a standard text
editor. The file is a series of lines of the form OPTION=VALUE. As new
options are added this section of this document will be updated. Note
that any option not specified in your WCCMMUD.INI file will have a default
value assigned to it.
Note that this file is *NOT* shipped with MajorMUD. The assumption is that
all the options are at their defaults. If you want to use any of these
options then you have to create this file yourself.
Do not include quotes ("") in your values. If you want to leave comments
to yourself you can start a line with # and it will be ignored.
Note that if you enable any of the logging features you will (a) slow your
system down due to the increased disk activity and (b) be responsible for
manually deleting the log file to avoid letting it grow too large.
Options
-------
SYS_LOG_DEATHS
Valid Values: 0 (no logging)
1 (logging)
Default Value: 0
Description:
When enabled, all player deaths, rerolls, and suicides are recorded
in the MajorMud log file.
SYS_DISABLE_GANGS
Valid Values: 3-15 character key name
Default Value: ""
Description:
When a person is given this key, they can use the sys disable
command and sys enable command.
SYS_RESET_ROOMS
Valid Values: 3-15 character key name
Default Value: ""
Description:
When a person is given this key, they can use the sys reset command.
TRACK_LIMITED
Valid Values: 0 (means no tracking)
1 (means tracking)
Default Value: 0
Description:
When enabled, each time a limited item changes location in the game
it will be logged to the MajorMUD log file.
LOGFILE
Valid Values: Any unique filename without path
Default Value: WCCMMUD.LOG
Description:
This can be used to change the name of the log file to which
various game messages are logged (such as the tracking of limited
items)
EXP_IN_TOPGANG
Valid Values: 0 (means do not show exp)
1 (means show exp in topten)
Default Value: 0
Description:
When enabled, the experience associated with each gang will be
shown in the topten gangs listing.
SYS_MAP_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop map command.
SYS_GOTO_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop goto command.
SYS_LIGHTNING_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop lightning command.
SYS_STATUS_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop status command.
SYS_ADDLIFE_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god add life command.
SYS_RETRAIN_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god retrain command.
SYS_ALIGNMENT_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god good/saint/neutral/lawful/unlawful commands
SYS_EDITEVIL_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god add evil command.
SYS_SPEAK_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god speak command.
SYS_LISTUSER_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop list users/evil/gang commands.
SYS_LISTLIMIT_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop list limited_items command.
SYS_USERINFO_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god inventory/profile/spells/powers/
abilities/info/status commands.
SYS_JAIL_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god jail command.
SYS_CHANGE_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god change name or sex commands.
SYS_BUFFERS_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop buffers commands.
SYS_CLEARSUICIDE_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god clear suicide command.
SYS_REPORT_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop report command.
SYS_TOPTEN_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god enable/disable topten commands.
SYS_DISBAND_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop disband command. Note that unlike the other
gameop commands, this is typically only a sysop command
and is therefore not given to a gameop by default.
UPDATE_SPEED
Valid Values: 0, 1, 2, 3, 4, 5
Default Value: 0
Description:
Used to control the speed at which automatic database updates
are applied.
0 == Fastest (most load on system)
1 == Medium
2 == Slow
3 == Slower
4 == Slowest (least load on system)
5 == All at startup (longest bbs start time, no load once started)
Note that an approximate timing is option 0 takes around 9
minutes on a P133 with IDE drives and a 4MB caching controller
under WorldGroup 2.0.
Option 5 takes 8 minutes on a P166 with a SCSI (8ms, 1MB cache)
drive with a regular SCSI controller running in a DOS box under
Win '95 under WorldGroup 1.01.
Another timing we've done here for option 5 also took 8 minutes
but this time it was on a 486-100 with a slow IDE drive and an
8MB caching controller running WorldGroup 3.0 for NT/95 on a
Win '95 system. Interesting comparison: Exact same PC, running
Win '95 in non-gui mode and WG 2.0 took 13 minutes to complete.
LOG_SYSOP_COMMANDS
Valid Values: 0 (means do not log sysop commands)
1 (means log sysop commands)
Default Value: 1
Description:
When enabled, all sysop commands done in MajorMUD will be
logged to the LOGFILE. (This does not include commands
from the sysop menu, just commands in the game.)
MAXIMUM_BANK_BALANCE
Valid Values: 0 (means no maximum)
number (maximum allowed balance)
Default Value: 0
Description:
When set, all bank balances will be limited to this
amount - any excess will be removed from the bank
account for the user with no warning.
The value is in copper pieces (do a 'look' in the
bank for conversion rates).
ENABLE_CLASS_CHANGE
Valid Values: 0 (means do not allow changing class)
1 (means allow changing class)
Default Value: 0
Description:
When enabled, users who had characters prior to version
1.1u will be allowed to change their class in addition
to their race. This only affects characters in this
situation - it does not affect any new characters
created in 1.1u or newer.
RACE_CHANGE_DURATION
Valid Values: 1-720
Default Value: 300
Description:
Characters that existed prior to 1.1u will be given a
chance to change their race (and optionally their
class - see ENABLE_CLASS_CHANGE above). Once they
make the first race change they can continue to change
their race until they have spent this many minutes
playing the game. The default of 300 is 5 hours.
BLANK_LASTNAME_ALLOWED
Valid Values: 0 (Means do not allow blank lastnames)
1 (Means allow blank lastnames)
Default Value: 0
Description:
If you allow blank lastnames then a user can create
a character with just a given/first name and no
last name. If you do not allow blank last names
then the user will be forced to create a lastname.
If you change this setting to force lastnames when
you previously allowed blank lastnames it does not
force users without last names to enter one until
they train stats (and even then there are ways to
get around it that we're not going to remove).
----------------------------------------------------------
Options for MajorMUD Plus (put in wccmmud.ini)
PLUS_PURCHASE_EMAIL_USERID
Valid Values: userid
Default Value: N/A
Description:
If SEND_EMAIL_FOR_PURCHASES is set then this is the
userid who will receive the emails regarding plus
purchases. Note that there is NO default.
SEND_EMAIL_FOR_PURCHASES
Valid Values: 0 (means don't send email)
1 (means only send email)
Default Value: 0
Description:
When set to a non-zero value, MajorMUD Plus will
send email to the sysop (based on the MajorMUD CNF
option '') to record a purchase. The user will NOT
be charged credits, game currency, or days if this
option is set. Typically this is to be used for
sysops running on a DMA server where credits or
account days don't make any sense to use. Note that
you must specify PLUS_PURCHASE_EMAIL_USERID for this
to work.
Here is a sample that gives sys gotos and sys map to everyone:
1) clear your required gameop key:
Security and Accounting > WCCMMUD > GAMEOPKEY= (clear it)
2) for users who you want to have the gameop commands like retrain and such (listed below), give those users the WCCREALGAMEOP key via the remote sysop menu.
3) put this in WCCMMUD.INI:
SYS_LIGHTNING_KEY=SYSOP
SYS_STATUS_KEY=WCCREALGAMEOP
SYS_ADDLIFE_KEY=SYSOP
SYS_RETRAIN_KEY=WCCREALGAMEOP
SYS_ALIGNMENT_KEY=WCCREALGAMEOP
SYS_EDITEVIL_KEY=WCCREALGAMEOP
SYS_SPEAK_KEY=WCCREALGAMEOP
SYS_LISTUSER_KEY=WCCREALGAMEOP
SYS_LISTLIMIT_KEY=WCCREALGAMEOP
SYS_USERINFO_KEY=WCCREALGAMEOP
SYS_JAIL_KEY=WCCREALGAMEOP
SYS_CHANGE_KEY=SYSOP
SYS_BUFFERS_KEY=SYSOP
SYS_CLEARSUICIDE_KEY=WCCREALGAMEOP
SYS_REPORT_KEY=WCCREALGAMEOP
SYS_TOPTEN_KEY=SYSOP
SYS_DISBAND_KEY=SYSOP
SYS_RESET_ROOMS=SYSOP
SYS_DISABLE_GANGS=SYSOP
EXP_IN_TOPGANG=1
-syn
///////////////////////////////////////////////////////////////////////
3.1) OPTIONAL CONFIGURATION OPTIONS
For various reasons, I want to get away from using CNF options and switch
to an alternative form of adding sysop configurable options to MajorMUD.
The new method will be via the use of a text file called WCCMMUD.INI. I
do not plan on creating any interface to access this file so the only way
you will be able to change options in this file is with a standard text
editor. The file is a series of lines of the form OPTION=VALUE. As new
options are added this section of this document will be updated. Note
that any option not specified in your WCCMMUD.INI file will have a default
value assigned to it.
Note that this file is *NOT* shipped with MajorMUD. The assumption is that
all the options are at their defaults. If you want to use any of these
options then you have to create this file yourself.
Do not include quotes ("") in your values. If you want to leave comments
to yourself you can start a line with # and it will be ignored.
Note that if you enable any of the logging features you will (a) slow your
system down due to the increased disk activity and (b) be responsible for
manually deleting the log file to avoid letting it grow too large.
Options
-------
SYS_LOG_DEATHS
Valid Values: 0 (no logging)
1 (logging)
Default Value: 0
Description:
When enabled, all player deaths, rerolls, and suicides are recorded
in the MajorMud log file.
SYS_DISABLE_GANGS
Valid Values: 3-15 character key name
Default Value: ""
Description:
When a person is given this key, they can use the sys disable
command and sys enable command.
SYS_RESET_ROOMS
Valid Values: 3-15 character key name
Default Value: ""
Description:
When a person is given this key, they can use the sys reset command.
TRACK_LIMITED
Valid Values: 0 (means no tracking)
1 (means tracking)
Default Value: 0
Description:
When enabled, each time a limited item changes location in the game
it will be logged to the MajorMUD log file.
LOGFILE
Valid Values: Any unique filename without path
Default Value: WCCMMUD.LOG
Description:
This can be used to change the name of the log file to which
various game messages are logged (such as the tracking of limited
items)
EXP_IN_TOPGANG
Valid Values: 0 (means do not show exp)
1 (means show exp in topten)
Default Value: 0
Description:
When enabled, the experience associated with each gang will be
shown in the topten gangs listing.
SYS_MAP_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop map command.
SYS_GOTO_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop goto command.
SYS_LIGHTNING_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop lightning command.
SYS_STATUS_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop status command.
SYS_ADDLIFE_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god add life command.
SYS_RETRAIN_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god retrain command.
SYS_ALIGNMENT_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god good/saint/neutral/lawful/unlawful commands
SYS_EDITEVIL_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god add evil command.
SYS_SPEAK_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god speak command.
SYS_LISTUSER_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop list users/evil/gang commands.
SYS_LISTLIMIT_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop list limited_items command.
SYS_USERINFO_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god inventory/profile/spells/powers/
abilities/info/status commands.
SYS_JAIL_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god jail command.
SYS_CHANGE_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god change name or sex commands.
SYS_BUFFERS_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop buffers commands.
SYS_CLEARSUICIDE_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god clear suicide command.
SYS_REPORT_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop report command.
SYS_TOPTEN_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop god enable/disable topten commands.
SYS_DISBAND_KEY
Valid Values: 3-15 character key name
Default Value: ""
Description:
If specified then a user needs either the sysop-key or the
game-op key AND the key specified here to execute the
sysop disband command. Note that unlike the other
gameop commands, this is typically only a sysop command
and is therefore not given to a gameop by default.
UPDATE_SPEED
Valid Values: 0, 1, 2, 3, 4, 5
Default Value: 0
Description:
Used to control the speed at which automatic database updates
are applied.
0 == Fastest (most load on system)
1 == Medium
2 == Slow
3 == Slower
4 == Slowest (least load on system)
5 == All at startup (longest bbs start time, no load once started)
Note that an approximate timing is option 0 takes around 9
minutes on a P133 with IDE drives and a 4MB caching controller
under WorldGroup 2.0.
Option 5 takes 8 minutes on a P166 with a SCSI (8ms, 1MB cache)
drive with a regular SCSI controller running in a DOS box under
Win '95 under WorldGroup 1.01.
Another timing we've done here for option 5 also took 8 minutes
but this time it was on a 486-100 with a slow IDE drive and an
8MB caching controller running WorldGroup 3.0 for NT/95 on a
Win '95 system. Interesting comparison: Exact same PC, running
Win '95 in non-gui mode and WG 2.0 took 13 minutes to complete.
LOG_SYSOP_COMMANDS
Valid Values: 0 (means do not log sysop commands)
1 (means log sysop commands)
Default Value: 1
Description:
When enabled, all sysop commands done in MajorMUD will be
logged to the LOGFILE. (This does not include commands
from the sysop menu, just commands in the game.)
MAXIMUM_BANK_BALANCE
Valid Values: 0 (means no maximum)
number (maximum allowed balance)
Default Value: 0
Description:
When set, all bank balances will be limited to this
amount - any excess will be removed from the bank
account for the user with no warning.
The value is in copper pieces (do a 'look' in the
bank for conversion rates).
ENABLE_CLASS_CHANGE
Valid Values: 0 (means do not allow changing class)
1 (means allow changing class)
Default Value: 0
Description:
When enabled, users who had characters prior to version
1.1u will be allowed to change their class in addition
to their race. This only affects characters in this
situation - it does not affect any new characters
created in 1.1u or newer.
RACE_CHANGE_DURATION
Valid Values: 1-720
Default Value: 300
Description:
Characters that existed prior to 1.1u will be given a
chance to change their race (and optionally their
class - see ENABLE_CLASS_CHANGE above). Once they
make the first race change they can continue to change
their race until they have spent this many minutes
playing the game. The default of 300 is 5 hours.
BLANK_LASTNAME_ALLOWED
Valid Values: 0 (Means do not allow blank lastnames)
1 (Means allow blank lastnames)
Default Value: 0
Description:
If you allow blank lastnames then a user can create
a character with just a given/first name and no
last name. If you do not allow blank last names
then the user will be forced to create a lastname.
If you change this setting to force lastnames when
you previously allowed blank lastnames it does not
force users without last names to enter one until
they train stats (and even then there are ways to
get around it that we're not going to remove).
----------------------------------------------------------
Options for MajorMUD Plus (put in wccmmud.ini)
PLUS_PURCHASE_EMAIL_USERID
Valid Values: userid
Default Value: N/A
Description:
If SEND_EMAIL_FOR_PURCHASES is set then this is the
userid who will receive the emails regarding plus
purchases. Note that there is NO default.
SEND_EMAIL_FOR_PURCHASES
Valid Values: 0 (means don't send email)
1 (means only send email)
Default Value: 0
Description:
When set to a non-zero value, MajorMUD Plus will
send email to the sysop (based on the MajorMUD CNF
option '') to record a purchase. The user will NOT
be charged credits, game currency, or days if this
option is set. Typically this is to be used for
sysops running on a DMA server where credits or
account days don't make any sense to use. Note that
you must specify PLUS_PURCHASE_EMAIL_USERID for this
to work.
Here is a sample that gives sys gotos and sys map to everyone:
1) clear your required gameop key:
Security and Accounting > WCCMMUD > GAMEOPKEY= (clear it)
2) for users who you want to have the gameop commands like retrain and such (listed below), give those users the WCCREALGAMEOP key via the remote sysop menu.
3) put this in WCCMMUD.INI:
SYS_LIGHTNING_KEY=SYSOP
SYS_STATUS_KEY=WCCREALGAMEOP
SYS_ADDLIFE_KEY=SYSOP
SYS_RETRAIN_KEY=WCCREALGAMEOP
SYS_ALIGNMENT_KEY=WCCREALGAMEOP
SYS_EDITEVIL_KEY=WCCREALGAMEOP
SYS_SPEAK_KEY=WCCREALGAMEOP
SYS_LISTUSER_KEY=WCCREALGAMEOP
SYS_LISTLIMIT_KEY=WCCREALGAMEOP
SYS_USERINFO_KEY=WCCREALGAMEOP
SYS_JAIL_KEY=WCCREALGAMEOP
SYS_CHANGE_KEY=SYSOP
SYS_BUFFERS_KEY=SYSOP
SYS_CLEARSUICIDE_KEY=WCCREALGAMEOP
SYS_REPORT_KEY=WCCREALGAMEOP
SYS_TOPTEN_KEY=SYSOP
SYS_DISBAND_KEY=SYSOP
SYS_RESET_ROOMS=SYSOP
SYS_DISABLE_GANGS=SYSOP
EXP_IN_TOPGANG=1