Bukkit

Description

This plugin allows you to run server commands when a player gains an achievement.

Please not that this does NOT add custom achievements to the game. There are other plugins to do that.

You can use this plugin reward players when they achieve something. For example, you might want to give some extra diamonds to a player when they mine their first diamond. Or give them some steak to go with their "bake bread" achievement. Or, to prevent spambots and the ubiquituous "Can i live with someone?" "try to /tpa to everyone on the player list" newbies, you might not allow players to use chat or teleport commands until they get the "benchmarking" or "hot topic" achievement, to prove they have abilities that exceed those of a cabbage.

Installation

Download the plugin. Put it into your jars folder. Reload, or restart, the server.

Optional: Install PlaceholderAPI. This plugin doesn't require it, but uses it if present.

Configuration

When you start the plugin for the first time, it will generate an directory and an example config.yml file. This config.yml has (empty) templates for all standard achievements, and examples for the first two achievements (open inventory, mine wood). Edit and you're done.

You will not need to reload anything after editing config.yml; the plugin detects changed time stamps on the config file itself and reloads if neccesary. New achievements is not something that happens several times a second, or even several times a minute, so the advantage of not needing console access and a reload command outweighs the disadvantage of the modification time check, in the opinion of the creator.

Configuration example

This is an excerpt from the example config:

open_inventory:
  - You have opened your inventory.
  - Now, %player_name%, fell a tree!
  - /give %player_name% iron_axe 1
mine_wood:
  - Well done.
  - Next, build a workbench!
build_workbench:

Each achievement has a list of commands, and chat notes. Entries that start with a / are executed as console commands. Entries that do not start with a / are sent to the player as chat messages.

Color codes in chat messages are supported, using & as the color code start character.

If PlaceholderAPI is installed, all its placeholders are supported in commands and messages. If you just need the name of the current player, %player_name% works even without PlaceholderAPI.