AresMUSH
A New Breed of MUSH Server

Configuring Ares

AresMUSH is ready to go out of the box with a default configuration based on a Battlestar Galactica setting. Most games will want to customize Ares to their own theme and preferences. These tutorials will show you how.

Beta Warning

Ares is still in beta, including the documentation. While it's stable overall, features are subject to change and some bugs are to be expected. Watch the Forum for updates.

Configuration Files

The easiest way to configure your game is through the game’s Web Portal. Log in as an admin user and visit Admin -> Setup.

You’ll see a list of configuration files with settings you can change.

Clicking on any config file will present you with a screen where you can edit the settings.

Ares configuration files use YAML, so you should check out the Understanding YAML tutorial before diving into the advanced configuration.

Tip: Coders can also edit the config files in the server shell, but you’ll need to ue the load config command afterwards to reload the configuration. The Web Portal automatically reloads the config, so that step is not necessary when using the web editor.

Essential Config

These are settings that pretty much every game will want to configure.

FS3 Config

If you intend to use the FS3 skills/combat systems, you’ll want to review these settings.

Basic FS3 Config

These are the basic configuration options that most games will need to tweak for their theme/setting.

FS3 Gear Config

The default gear lists are designed for a Battlestar setting. If you’re using another setting, you’ll probably need to tweak the gear lists. If you have custom vehicles or unusual combatant types (like six-legged aliens), you’ll need to adjust the hit location tables.

Advanced FS3 Config

These are advanced customization settings that most games won’t need to alter.

Other Config

A variety of other settings exist, but the defaults will work well for most games.

Uncommon Config

These configuration options will probably not need to be changed unless your server or database changes.

General Config Topics