FAQ & Troubleshooting

Advancements don't show up after creating them

Run /padv reload to refresh the advancement UI. This re-initializes all tabs and shows them to all online players.

The L menu doesn't update after /padv reload

Close and reopen the advancement menu (press L again). The server has updated the data, but the client cache may still show the old view.

/padv apply fails with "stale session"

Your web editor session is outdated. The server data was modified externally (via /padv reload or in-game edits). Re-upload by running /padv editor again, or use --force to override.

Error "An AdvancementTab with 'namespace' already exists"

This is normal during reload and is handled automatically in v2.0+. If you see this, update to the latest version.

GUI buttons don't work / items can be taken

Ensure you have the correct version of the plugin. GUI title checks are version-specific. The issue was fixed in v2.0.

config.yml has duplicated comments after update

This was a bug in the ConfigUpdater's comment re-insertion logic (fixed in v2.0). Delete the corrupted config.yml and run /padv reload to regenerate it from resources.

Can I use ItemsAdder/Oraxen textures?

Yes, use iconCustomModelData for the advancement icon and customModelData for item types. Set the custom model data number that matches your resource pack configuration.

How do I migrate from another advancements plugin?

PremiumAdvancements does not have an import tool for other plugins. You'll need to recreate your advancements manually via the web editor or YAML files.

MySQL connection fails

Verify MySQL server is running
Check host, port, username, and password
Ensure the database exists
Check that MySQL user has CREATE TABLE privileges
Check firewall rules (port 3306)

Web editor shows "Failed to upload"

Check that editor.api-url in config.yml is correct
Verify the server can reach the API URL (outbound HTTPS)
Check console for detailed error messages (enable editor.debug: true)

Placeholders return empty

Ensure PlaceholderAPI is installed
Verify the placeholder uses the correct format
Check that the advancement ID exists
Reload PlaceholderAPI: /papi reload

Money rewards don't work

Ensure Vault and an economy plugin are installed
Verify the economy plugin is functioning
Check that money.enabled: true and money.amount is set

Discord webhooks don't send

Enable globally: webhook.enabled: true in config.yml
Set the webhook URL in webhook.yml
Enable per-advancement: webhook-enabled: true
Check that the Discord webhook URL is valid and active