-
Notifications
You must be signed in to change notification settings - Fork 0
Platform Support
Paper, Purpur, and Folia. Spigot and CraftBukkit are not supported. This matches Towny's own supported platform list as of Towny 0.102.0.0, which is relevant if you're running Exchequer alongside it, though the restriction applies to standalone Exchequer installs as well.
Exchequer is built to be Folia safe from its foundation, not retrofitted afterward. This matters more for Exchequer than it would for a simpler plugin, because its core state, the AMM pools, tax cycle, and GDP figures, is global rather than tied to any single chunk or region, and multiple players across entirely different regions of the map can interact with the same material's exchange pool at the same moment.
In practice this means:
- All ledger and pool reads and writes go through thread safe access, never assuming single threaded execution the way a classic Paper only plugin safely could.
- Global scheduled work, such as the tax cycle and GDP recalculation, runs through Folia's GlobalRegionScheduler.
- Anything tied to a specific player, such as opening the Bank or Exchange GUI, runs through Folia's EntityScheduler for that player.
If you're running Folia, no special configuration is needed on your end, this is handled internally. If you notice inconsistent balances or GUI behavior specifically on a Folia server, this is worth reporting as a bug with your server software clearly noted, see [Troubleshooting](Troubleshooting.md).
Because every tracked currency in Exchequer is backed by a Bukkit Material reference, and material names have been renamed or restructured across Minecraft versions in the past, Exchequer resolves material references through an internal version aware lookup layer rather than hardcoding a single enum value. This avoids failures where a material name valid on one supported version doesn't exist or means something different on another.
If you're running a Minecraft version at the edge of the currently supported range and see a material behaving unexpectedly (missing from the GUI, failing to resolve in a trade), this is the most likely cause and is worth reporting with your exact Minecraft version included.
Check the resource page or the latest release notes for the exact current range, since this shifts as new Minecraft versions release. As a general policy, Exchequer aims to support the current major version plus at least the prior one at any given time.