Frequently asked questions about CustomAchievements1653.
General
Q: What server software is required?
A: Spigot/Paper 1.21 or newer (or forks like Purpur, Pufferfish).
Q: What Java version is required?
A: Java 21 or newer.
Q: Does the plugin support Folia?
A: Yes, Folia is supported.
Q: Can I use this on a BungeeCord/Velocity network?
A: Yes, using the MySQL database option. Each server will share the same advancement data.
Configuration
Q: How do I create a new advancement?
A: Either edit advancements.yml directly, or use the admin GUI with /ca admin.
Q: How do I change the language?
A: Set language: de_DE (or any locale code) in config.yml and reload.
Q: Can I create my own language?
A: Yes! Copy any language file in plugins/CustomAchievements1653/lang/, rename it (e.g., my_lang.yml), translate it, and set language: my_lang in the config.
Q: What happens to my config when I update the plugin?
A: New config keys are automatically added without overwriting your existing settings. Same for language files.
Q: Can I use MiniMessage and Legacy at the same time?
A: No, you must choose one format in config.yml. If you use MiniMessage, your language file values should use MiniMessage syntax.
Advancements
Q: How many trigger types are there?
A: Over 150 trigger types covering blocks, movement, combat, items, food, entities, fishing, interactions, redstone, throwables, vehicles, chat, commands, experience, world exploration, and more.
Q: Can I combine multiple conditions?
A: Yes! You can combine location, state, and world conditions. For example: "Eat food WHILE falling in the Nether at night with full diamond armor." See Conditions System.
Q: Can I disable specific rewards per advancement?
A: Yes! Use per advancement toggles like sound-enabled: false, firework-enabled: false, etc. See Rewards.
Q: Do advancements show in the vanilla advancement GUI?
A: Yes! Advancements are registered with the vanilla system and appear as tabs and entries in the advancement GUI (press L).
Q: Are toast notifications shown?
A: Yes! When a player completes an advancement, they see the vanilla toast notification popup. This can be disabled per advancement with toast-enabled: false.
Technical
Q: Does the plugin support PlaceholderAPI?
A: Yes! See PlaceholderAPI for all available placeholders.
Q: Does the plugin support Vault?
A: Yes! Money rewards require Vault and an economy plugin. See Vault Integration.
Q: Is the plugin performance optimized?
A: Yes! Distance and time based checks use configurable intervals. Player data is cached in memory. Database operations are asynchronous.
Q: How is data stored?
A: Using SQLite (local file) or MySQL (remote server). See Database.
Troubleshooting
Q: Advancements are not showing in the GUI
A: Make sure the advancement has a valid category, trigger type, and icon material. Check the console for loading errors.
Q: Economy rewards are not working
A: Make sure Vault and an economy plugin (like EssentialsX) are installed and working.
Q: PlaceholderAPI placeholders are not working
A: Make sure PlaceholderAPI is installed. The placeholders start with %customachievements_.
Q: Where can I get support?
A: Support is available on Discord: Join Support. Please do not request support in SpigotMC reviews.
