Migrating to Minecraft 1.13

This guide is intended for users who were previously running Advanced Achievements on a Minecraft 1.12 or older server and want to update their installation. If you only first started using the plugin on Minecraft 1.13 or more recent, you can safely ignore this page!

Advanced Achievements 5.9.0 is the first version to officially support Minecraft 1.13. Unfortunately, the Spigot team has changed their traditional stance on backwards-compatibility and has introduced a large amount of breaking changes to the Bukkit API. Advanced Achievements developers and testers have invested many hours of work to ensure that the plugin runs as smoothly as possible on Minecraft 1.13, but the following steps are recommended if you have been using the plugin with previous Minecraft versions:

• go through the material names used in config.yml for the Breaks, Places, Crafts and TargetsShot categories, as well as for item rewards. Many of the previously used names have changed, they now systematically match the Vanilla ones. You can find the updated material list here or refer to the "ID names" documented on Gamepedia. Do the same for the names used in gui.yml (updated default here).
• go through the Kills, Breeding and TargetsShot categories and verify that the entity names are still correct, they now systematically match the Vanilla ones. You can find the updated entity list here or refer to the "Entity IDs" documented on Gamepedia.
• backup your database and run the hidden /aach upgrade13 command. This command will attempt to convert as many as possible old material names stored in the database for the Breaks, Places and Crafts categories. Note that only plugin versions up to 7.3.0 feature this command.

Please bear in mind that when the entity name has changed for a Breeding or Kills achievement or when the /aach upgrade13 has not managed to convert a material for a Breaks, Places and Crafts achievement, progress for that achievement will be reset. Entity or material names that haven't changed in Minecraft 1.13 should be unaffected.

Once you're done with the few steps above, Advanced Achievements should happily run on Minecraft 1.13. Enjoy!