Skip to content

Troubleshooting

Jump to bottom
Create: Hydraulics edited this page Jul 13, 2026 · 1 revision

Troubleshooting

Plugin Fails to Start

Check your console log for the specific error. Common causes:

  • Running Spigot or CraftBukkit instead of Paper, Purpur, or Folia. This is not supported, see [Platform Support](Platform-Support.md).
  • Java version below 21.
  • A malformed config.yml after manual editing. Delete or rename the file to let Exchequer regenerate a default one, then reapply your changes carefully, or validate your YAML syntax with an online validator before restarting.

Towny or Vault Not Detected

Run /exchequer status to see exactly what was detected on startup. If a plugin you expect to be found isn't showing up:

  • Confirm it's actually enabled, not just present in the plugins folder. Check for its own startup errors in the console.
  • Confirm you're running a Towny version that supports your server software (Paper, Purpur, or Folia), older Towny builds that predate this may not initialize correctly alongside Exchequer.
  • Restart the server after installing either plugin, detection happens at startup, not live.

Deposits or Withdrawals Failing

  • Vault capacity reached. Check /exchequer bank balance against your tier limit.
  • The material isn't currently tracked. If it was recently removed from config.yml, see the section below on deprecated materials.

GUI Not Opening or Appearing Broken

  • Confirm the player has the relevant permission node, see [Permissions](Permissions.md).
  • If running Folia, and this issue is reproducible specifically on Folia and not on Paper, this is worth reporting as a bug with your exact server software and version noted.

Balances Inconsistent Across a Network

See the Common Issues section of [Cross Server Setup](Cross-Server-Setup.md) first, this is almost always a MySQL or Redis configuration mismatch between servers rather than a bug in the plugin itself.

Handling a Deprecated (Removed) Material

Removing a material from materials.tracked does not delete player balances in that material, it only removes it from GUIs and commands. If you intend to remove a material permanently:

  1. Announce the change in advance so players can convert their balance in that material through the exchange system before removal.
  2. After removal, any remaining balances are inert but preserved in the database. Re-adding the material later restores access to them.

There is currently no automated forced conversion tool for balances left in a removed material. This is a manual process by design, to avoid silently converting player value without their input.

Reporting a Bug

If none of the above resolves your issue, open a bug report on the GitHub issue tracker using the provided issue form. Include your Exchequer version, server software and Minecraft version, whether Towny and Vault are installed, and any console errors. Reports missing this information take significantly longer to diagnose. General setup questions that aren't bugs should go through the resource page's comment or ticket system instead, not the issue tracker.

Clone this wiki locally