A New Breed of MUSH Server

Configuring the Channel System

  • [config]

To configure the Channels plugin:

  1. Select Admin -> Setup.
  2. Edit channels.yml

Creating Channels

In-game commands let you create, delete, and rename channels. You can also set channel permissions, colors, and and other settings. See help manage channels.

start_marker and end_marker

You can configure the characters that appears at the beginning and end of the channel name. This lets you alter the appearance to do things like:

<Chat> Faraday says, "This is MUSH style."
[Chat] Faraday says, "This is MUX style."

Start and end markers can include ansi color and other formatting codes.


You can configure which channels new characters join by default when they are first created. Guests will also be added to those same channels when they connect.

This should be a list. For example:

- Questions
- Chat


You can also configure which channels characters join when they are approved. Like default_channels, this should be a list. For example:

- RP Requests


This is the channel where various OOC game announcements will go, like who records being broken or events starting.


Linking a channel to the OOC lounge/Offstage room ensures that all chit-chat in that room is echoed to the selected channel. This ensures that chatter can be accessible to all players - including ones on the web portal - and also subject to reporting with the Ares harassment tools. Just set ooc_lounge_channel to the channel name. Leave it blank to allow people to chat in the OOC room as normal.

recall_timeout_days and clear_history_cron

Messages in channel recall will be automatically deleted after the specified timeout, in days. This helps keep the recall reasonably current for someone looking at the channel history - particularly on the web portal.

The clearing happens on the timetable specified by the cron config. See the Cron Job Tutorial for help if you want to change this.


Sets the number of messages available in the channel recall (and thus the web portal chat) for all channels.

discord_gravatar_style and discord_prefix

These two options are used by the Discord App, an extension for AresMUSH that lets you connect your in-game chat channels to a Discord server. If you don’t have the app installed, they do nothing.


Set this to ‘true’ if you’re having trouble with your discord bot; it enables extra debugging that may help you diagnose the problem.