FAQ & Troubleshooting
Common setup issues, AFK earnings questions, placeholder problems, multipliers, and bounty troubleshooting.
The plugin disables on startup. Why?
- ProCurrency enforces a license gate.
- Check plugins/ProCurrency/config.yml → license.key.
- Restart after setting the key.
AFK earnings are not paying players.
- WorldGuard is required and must be installed.
- Confirm afk.enabled: true in config.yml.
- Confirm the WorldGuard region name(s) match exactly in config.yml.
- Make sure players are actually inside the configured region(s).
Placeholders do not work.
- PlaceholderAPI is optional but required for placeholders.
- Install PlaceholderAPI and restart.
- Confirm you are using %procurrency_*% placeholders, not another plugin’s placeholder.
Multipliers are not applying.
- Multipliers are permission-based.
- Assign the correct procurrency.multiplier.* permission to the player’s group using LuckPerms.
- Use /procurrency status to confirm the multiplier value is updating.
Shop or leaderboard GUI won’t open.
- Confirm the player has permissions: procurrency.shop and/or procurrency.top.
- Check console for GUI load errors.
- Verify the files shop.yml and leaderboard.yml exist and are not malformed YAML.
Bounties won’t place or pay out correctly.
- Bounty placement uses a chat prompt: <amount> <currency>.
- If using Vault money for bounties, Vault + an economy plugin must be installed.
- If using ProCurrency bounties, ensure the player has enough ProCurrency balance.
Support Checklist
- Confirm Paper 1.21+ and Java 21.
- Confirm WorldGuard is installed and enabled.
- Confirm config.yml license.key is set and server restarted.
- Confirm permissions for GUIs (shop/top/bounty/bounties).
- Install PlaceholderAPI if you use placeholders.