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 Dec 7, 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.
  • If you have PlaceholderAPI installed on your server, you can use the placeholders listed here.
  • 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. If you need help setting up your own working copy, please refer to this guide.
  • 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.
  • Compile your custom version and enjoy Advanced Achievements for Minecraft 1.7.9/1.7.10!
  • 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.

Wiki pages

Clone this wiki locally