GAMENAME

From TinyMUX
Jump to navigation Jump to search

GAMENAME is a shell variable that is defined in the mux.config file. It is used as the base name of several other shell variables, most notably those that specify the name of the database files that TinyMUX reads/writes to, and the name of the GAMENAME.conf (or .conf for short) file that is referenced by the Startmux script. The default value of GAMENAME is netmux. Note that this does not affect the proper name of the game as returned by the mudname() softcode function. That is set in the .conf file by the config parameter mud_name.

The purpose of changing GAMENAME is to customize your TinyMUX installation, which is most useful when running multiple games in a shared account or environment. This affects the name of the conf file, the database files, and also any files created by the Backup script and/or @backup command.

Changing GAMENAME

If you decide to customize your TinyMUX installation by changing GAMENAME, it is important to make other changes to your configuration as well. This is a very critical process due to the fact that any confusion with GAMENAME and related settings can result in data loss for your game.

Example default mux.config file. Note the line that looks like this:

 GAMENAME=netmux

In the following example, the default GAMENAME value of netmux will be changed to foof.

TIP: To avoid confusion or mistyping errors, the value for your GAMENAME should be a single word, short, and most importantly all lowercase. The simpler it is, the less likely there will be a mismatch.

1. Make sure the game is not currently running.

2. cd into your game/ directory and edit mux.config and change the netmux in that line to foof

3. Either copy or move the file netmux.conf to foof.conf.

4. Edit foof.conf, and replace all instances of netmux with foof (while you're in here, take the time to change the port and mud_name config parameters to their new values.

5a. If this is a new installation of TinyMUX and you wish to use the minimal database that it ships with, go into the data/ subdirectory of your game directory and move netmux.db to foof.db

5b. If this is an existing game, you will need to rename all of the database files in data/, all netmux.db* files, as well as netmux.pag and netmux.dir. If you only change the config files and do not rename the database files, MUX will not find your data and will instead create new empty database files using the new GAMENAME prefix. This will likely damage your mail and comsys databases.