Achievements is an optional plugin that lets you set up in-game achievements for characters to earn. To configure the Achievements plugin:
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
Don't erase the existing types, because they're used by various plugins. You can change their icons, though, and add new types.
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:
custom_achievements: something_special: message: "Did something special." type: "story"
You can award custom achievements with the
If you want some piece of code to award a custom achievement automatically, just call:
Achievements.award_achievement(char, achievement_name). For example:
You don't have to check to see if the person already has the award; the Achievements plugin does that automatically.
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: