A New Breed of MUSH Server

Configuring the Achievements System

  • [config]

Achievements is an optional plugin that lets you set up in-game achievements for characters to earn. To configure the Achievements plugin:

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


By default, announcements are only shown to the person who received them. You can optionally have them announced on a channel. Just set announce_channel to the name of the channel you wish to use. Leave the setting blank to disable the announcement.


You can configure what achievement types exist and what their icon is. Standard types include things like community, story, and portal. Icons come from the Font Awesome icon library, so you’ll see codes like fa-globe and fa-users.


The standard plugins come with a number of achievements. You can also define your own using the custom_achievements setting. For each achievement, you define:

  • Internal name (e.g. something_special)
  • Displayed Message (e.g. Did something special.)
  • Achievement Type (e.g. story, portal, etc.)

For example:

    message: "Did something special."
    type: "story"

You can award custom achievements with the achievement/add command.

If you want some piece of code to award a custom achievement automatically, just call: Achievements.award_achievement(char, achievement_name). For example:

Achievements.award_achievement(enactor, "something_special")

Each achievement can only be received one time, though you can define different ‘levels’ of the achievement with different names. For example, joining combats has several levels: fs3_joined_combat_1, fs3_joined_combat_10, etc.