Installation

General procedure

Setting up the plugin is pretty straightforward and does not require any specific knowledge. It is recommended to do this procedure on a test server first, or on your personal computer, and then upload the configuration files on your main servers. This will prevent users from getting achievements while you're still setting the plugin up.

• Download Advanced Achievements from Bukkit or Spigot, put the plugin in your plugins folder and restart the server.
• Edit the generated config.yml (default here), gui.yml (default here) and lang.yml (many translations available here). Please do read the comments in the header of each configuration file, as well as the other pages of this Wiki. Tune the plugin as you wish and be creative when adding achievements!
• Make sure your YAML syntax is right by pasting your configuration files here.
• To use the PetMasterGive and PetMasterReceive achievement categories, you must download the Pet Master plugin and put it in your plugins folder. You can also choose to disable these two categories by adding them to the DisabledCategories list.
• If you have BungeeTabListPlus installed on your server, you can use the achievement_count placeholder in your tab list. If you have PlaceholderAPI, you can use all the placeholders listed here.
• Configure permissions if you want to change default behaviour of Advanced Achievements.
• Restart the server. You're done setting up the plugin!
• If running Minecraft 1.12, you can run the /aach generate command to generate a Minecraft advancement for every achievement you have defined! On older versions of Minecraft, you may see a few warnings in your server's logs when the plugin is loaded. Read the messages, Advanced Achievements will guide you through which configuration items you should tune!

---

Using PostgreSQL

Setting up SQLite or MySQL is straightforward as the libraries are included with Bukkit/Spigot, but PostgreSQL is a bit more tricky. Please bear in mind that only PostgreSQL 9.5 or more recent versions are supported.

• Download the latest JDBC driver from this page. Select JDBC42 if you are running Java 8, JDBC41 if you are running Java 7.
• Place the jar file on your server, for instance in the lib folder of Bukkit/Spigot.
• You now have to make sure that the driver is loaded when the server is launched. Include something similar to the following in your server's start script: java -cp craftbukkit.jar;lib/postgresql.jar org.bukkit.craftbukkit.Main
• Include the login information about your PostgreSQL database in the plugin's config.yml file and restart your server.