Repository navigation
Releases
PureEconomy 1.2.0
Paper-only thin JAR, no MySQL on the scoreboard thread, and SQL that scales.
Drop PureEconomy-1.2.0.jar on Paper, Purpur, or Folia. First boot downloads Kotlin, Hikari, Caffeine, and JDBC drivers through Paper libraries: and therefore needs access to Maven Central once. Spigot is no longer supported.
For proxy networks, install PureEconomy-Velocity-1.2.0.jar or PureEconomy-Bungee-1.2.0.jar on the proxy and the Bukkit artifact on every backend. Configure the same shared MySQL database and currency definitions on every instance.
Highlights
- Native Velocity and BungeeCord/Waterfall plugins with authoritative, strongly consistent MySQL transactions.
- Thin Bukkit JAR using Paper's library loader; heavy JDBC and runtime dependencies are no longer shaded.
- SQL schema v2 with
DECIMAL(20,8), UPSERT saves, indexed server-side/baltop, and automatic VARCHAR-to-DECIMAL migration. - Multi-currency
PureEconomyAPI, reason-coded mutation results, Vault support, and PlaceholderAPI wallet/bank placeholders. - Memory-only PlaceholderAPI balance reads with deduplicated stale-while-refresh network caching.
- Folia-aware scheduling and globally dispatched post-success economy events.
Reliability and threading
- Scoreboard rendering never waits for MySQL.
- Successful network mutations update the balance cache immediately and preserve specific failure reasons such as insufficient funds and maximum balance.
- Bukkit command parsing, permissions, player lookup, messaging, and transaction events run on their proper Paper/Folia thread.
- Network account setup on join runs asynchronously.
- Dirty cache evictions remain queued across overlapping save passes.
Upgrade notes
- Back up
plugins/PureEconomy/before upgrading or changing storage. - Existing configuration and language files are merged with new defaults without overwriting custom values.
- Existing SQL amount columns are migrated automatically on startup.
- YAML remains suitable for small servers; SQLite or MySQL is recommended for busy installations.
See the README and full changelog for setup and technical details.
PureEconomy 1.0.2
Spigot servers can enable PureEconomy again.
Fixed
- Fixed the Spigot enable crash caused by missing Adventure (
Component) classes. Adventure is now shaded, and messages are delivered throughBukkitAudiences. - Replaced Paper-only
getPluginMeta()usage with Spigot-compatible APIs. - Made schedulers Folia-safe without falling back to
BukkitScheduleron Paper/Folia. - Made
/payrecipient notifications region-safe on Folia. - Improved command registration safety and post-disable message handling.
Upgrade notes
Replace the existing JAR and restart the server. No configuration changes are required.
PureEconomy 1.0.1
PureEconomy 1.0.1 adds an optional GitHub update checker, config-driven permission nodes, and admin bank commands.
Highlights
- Optional asynchronous GitHub release checker (on by default). Console is notified of newer releases, and players with the configured admin permission get a clickable release link on join.
/eco bank give|take|set|resetfor admin bank adjustments, with matchingpureeconomy.eco.bank.*permissions.permissions:section inconfig.ymlto rename nodes and seteveryone/op/nobodydefaults./eco reloadapplies changes./balancenow also shows the matching bank amount.- Tab completion for
/currency. - Error message when
/bank transferor/bank withdrawfails after pre-checks. - Currency IDs that do not match
[a-z0-9_]are skipped at load with a warning. /eco resetremains wallet-only. Use/eco bank resetto clear a bank balance.addBank,takeBank, andresetBankonEconomyServicefor admin and integrator bank changes.
Downloads
PureEconomy-1.0.1.jar— drop this inplugins/and restart.config.yml— default config for new installs (includes the newpermissions:andupdate-checker:sections).lang-en.yml— default English language file (includes bank amounts on/balanceand new eco-bank / update-checker strings).
Upgrading from 1.0.0
Replace the old jar and restart. /eco reload does not load new Java from a replaced jar.
Existing config.yml and lang/en.yml are not overwritten. To use configurable permissions, paste the permissions: section from the downloaded config.yml. To show bank amounts on /balance, update these keys in lang/en.yml (or delete that file and restart so the default is recopied):
balance-self: "{prefix}&7Your {currency}: &f{amount} &8(&7bank &f{bank}&8)"
balance-other: "{prefix}&f{player}&7's {currency}: &f{amount} &8(&7bank &f{bank}&8)"
balance-all-line: "&8- &f{currency}&7: &f{amount} &8(&7bank &f{bank}&8)"Requirements
- Minecraft 1.21.4 or newer
- Java 21 or newer
- Paper/Folia 26.1 or newer requires Java 25
- Vault and PlaceholderAPI are optional
PureEconomy 1.0.0
PureEconomy 1.0.0 is the first public release of a lightweight, multi-currency economy for Bukkit-compatible servers.
Highlights
- Configurable wallet and bank balances
- Multiple currencies with custom names, symbols, precision, starting balances, limits, and transfer settings
- Player payments, balance lookup, bank transfers, and paginated balance leaderboards
- Administrative give, take, set, reset, and reload commands
- Vault support for the configured default currency
- PlaceholderAPI placeholders for every configured currency
- Folia-compatible scheduling and thread-safe balance operations
- Atomic YAML persistence with automatic saves
- Optional anonymous bStats metrics
Requirements
- Minecraft 1.21.4 or newer
- Java 21 or newer
- Paper/Folia 26.1 or newer requires Java 25
- Vault and PlaceholderAPI are optional
Installation
- Download PureEconomy-1.0.0.jar below.
- Place it in your server's plugins folder.
- Restart the server.
- Configure currencies in
plugins/PureEconomy/config.ymlif desired.