Ares contains a robust help system that can be accessed from the game (via the
help command) or through the Web Portal.
Help files live in a
help\<language code> folder under the plugin folder. This supports having help files in multiple languages, based on the game’s locale.
"en" is the language code for English, so help files will typically be in the
Help files use Markdown Text. This lets you use formatting and hyperlinks that will show up nicely on the Web Portal and also in-game.
You can link to other help files using
See also [Jobs](/help/jobs).
Inside the help file, the first few lines are embedded YAML, where you can set various fields.
Table of contents categories are free-form, so you can use anything you like in your help files. However, it's probably best to look at what already exists so you don't create similar-but-subtly-different categories.
The name of the help file will be the topic name. For instance, if we name the file
traits.md then you can type
The help system has a number of automatic features that try to help players find the help file they wanted even if they don’t type in the exact topic name. For example:
You can also set up manual aliases in the help metadata. This is particularly important when you have old-school MUSH shortcuts. For example, the help entry for ‘profile’ defines an alias for ‘finger’ and ‘info’ since those are common old-school names for the same basic command.
--- toc: Community summary: Using character profiles. aliases: - finger - info ---