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

FAQ (Frequently Asked Questions)

Pyves edited this page Jul 30, 2018 · 66 revisions

General questions about the configuration

1. Name, DisplayName, Goal and Message, what's all this about?

  • Name: used by the database, and when you use the /aach delete and /aach check commands. Once set for an achievement, Name should never be changed. This parameter is compulsory and must be uniquely defined in the configuration.
  • DisplayName: used in books, in the list GUI and when receiving an achievement. If not found, Name will be used.
  • Message: used in books, in the list GUI and when receiving an achievement. This parameter is compulsory, and stored in the database when a player receives an achievement.
  • Goal: used in the list GUI when the achievement is not yet received, and in advancement descriptions. If not found, Message will be used.

2. How can I hide a category in /aach list GUI?

Simply set its name to "" in lang.yml. This will not disable the achievement at a global level.


Issues

3. Why do the items I specify for the achievements or rewards not work?

Make sure you are using material names from this page. Please specify the names fully in lower-case. For Minecraft versions prior to 1.13, metadata information is supported for the Places, Crafts and Breaks achievements; for instance sand:1 is red sand.

4. I have changed the Name parameter of an achievement, why do players who had previously received it no longer have it?

As only the names in config.yml have changed, but not the ones in the database, you would have to also update the values in the database. More generally, you should only change DisplayName, Message and Goal, but not Name.

5. How can I track multiple types for categories with sub-categories (Places, Kills, Breaks, Crafts, Breeding, PlayerCommands)?

Separate the different types using |. For instance:

Kills:
  zombie|pig_zombie|zombie_horse|zombie_villager:
    1:
      Message: The first time you killed any kind of zombie!
      DisplayName: The Walking Dead
      Name: kills_1_any_zombie

Note that when you create a new group of types with |, progress will start at 0 regardless of existing player statistics for any of the types considered individually. Also, if ever you add/remove a type from the group, progress for this sub-category group will start back at 0 as well.

6. Why isn't MySQL/PostgreSQL working?

Advanced Achievements with MySQL has been thoroughly tested and is used flawlessly by hundreds of servers on a daily basis. Please ensure that your database is correctly configured, that you have specified the correct username, password and address (which must include the database name). Also do one full restart of your server (/aach reload is not sufficient). If you still can't get it working, please send me your login information privately and I will send you back the correct configurations to insert in config.yml.

For information about how to set up PostgreSQL, please visit the Installation section of this Wiki.

7. Why is everything messed up in the /aach list GUI?

If you don't want the obfuscation effect, set ObfuscateNotReceived to false in the configuration. Also, use F3 + H when playing to hide the extra information that appears when hovering over an object.

8. Why are achievement descriptions greyed out in the /aach list GUI?

When an achievement has not yet been received, the plugin automatically replaces any colours you have specified in your configuration (for instance the Goal parameter of an achievement) and displays texts in grey and italic.


Other

9. Can the dev add support for MCMMO or any other exotic plugin?

This has been requested quite a few times and unfortunately I will not be adding such features myself. These are not plugins I use, therefore I don't know anything about them and I wouldn't find it interesting to work with them. Nevertheless, feel free to open a pull request with your own implementation!

10. Why isn't the dev responding to my messages?

I am active on various websites, but tend to only reply to messages posted on GitHub, especially if you are lacking basic good manners (for instance saying "hello" or "thank you"). If you need help or want to make a request, please use the issue tracker, which serves as a centralised and organised place to provide efficient support.

Clone this wiki locally