Installation

Installing the plugin

Setting up the plugin is pretty straightforward. It is recommended to do this procedure on a test server first (or on your personal computer) and then upload the files generated on your main servers, to prevent users from getting achievements while you're still setting the plugin up.

• Download Advanced Achievements from Bukkit or Spigot. If you are running an old Minecraft version (1.7.9/1.7.10) refer to the section below.
• Put the plugin in your plugins folder and restart the server.
• Edit the generated config.yml file (you can find the default here), tune the plugin as you wish and create your achievements! Please do read the comments in the header of the configuration file, and the other pages of the wiki.
• If you want to use the PetMasterGive and PetMasterReceive achievement categories, you must download the Pet Master plugin and put it in your plugins folder as well. You can also choose to disable these two categories by adding them to the DisabledCategories list.
• Configure permissions if you want to change default behaviour and optionally edit lang.yml file. A bunch of more or less up-to-date translations for 12 different languages can be found here.
• Restart the server another time. You're done setting up Advanced Achievements!

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 on your server, for instance in the lib folder of Bukkit/Spigot.
• We 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 file and restart your server.

Compiling the plugin for Minecraft 1.7.9/1.7.10

The compiled version of Advanced Achievements you can find on Bukkit or Spigot is not compatible with the old Minecraft 1.7.9/1.7.10 versions. Nevertheless you can build your own compatible version:

• Clone or fork the repository by following the instructions given on the home page.
• Replace the contents of the pom.xml file by this version. Be sure to edit the <version> tag.
• In ListCommand.java and ListGUIListener.java, replace Material.BARRIER by any other material that existed in Minecraft 1.7 and that isn't yet used in the GUI (for instance Material.OBSIDIAN).
• Compile your custom version. Be sure to set TitleScreen to false in config.yml when running the plugin.
• Enjoy, you should have a perfectly functional version for Minecraft 1.7.9/1.7.10!