Skip to content
This repository has been archived by the owner on Nov 2, 2021. It is now read-only.

Installation

Jump to bottom
Pyves edited this page May 31, 2017 · 38 revisions

General procedure

If you are running an old Minecraft version (1.7.9/1.7.10), please refer to the next section.

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.
  • Configure permissions if you want to change default behaviour of Advanced Achievements.
  • Restart the server. You're done setting up Advanced Achievements!
  • If running Minecraft 1.12, you can run the /aach generate command to generate a Minecraft advancement for every achievement you have defined!

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 so that it matches the latest version of the plugin.
  • 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 and enjoy Advanced Achievements for Minecraft 1.7.9/1.7.10!

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.

Wiki pages

Clone this wiki locally