EcoPulse — Dynamic Supply & Demand Market (Paper 1.21+)
EcoPulse is a dynamic supply & demand market plugin built for modern servers.
✔ MySQL support (network-ready)
✔ Transaction logging & admin tools
✔ Stable chat-based search
✔ Clean GUI & Vault economy
Paper 1.21+ • Vault compatible • SQLite • PlaceholderAPI
Why EcoPulse?
- Live market prices that react to your players (buying ↑ = price ↑, selling ↑ = price ↓)
- Clean, modern GUI with categories, sorting & pagination
- Lightweight & fast, async storage, easy to configure
Features
- Dynamic supply/demand pricing
- Modern market GUI
- Categories, sorting, pagination
- Optional glass filler
- Vault economy support (EssentialsX Economy, CMI, etc.)
- SQLite storage (MySQL planned)
- PlaceholderAPI support
- /shop + /price command
- Optional transaction tax (money sink)
- Clean code structure (service pattern) + async DB
Requirements
Required
- Paper 1.21+
- Vault
- Economy plugin (e.g. EssentialsX Economy / CMI)
Optional
- PlaceholderAPI
Installation
- Put EcoPulse.jar into /plugins/
- Install Vault + an Economy plugin
- Start the server once (generates config.yml + messages.yml)
- Edit configs if needed
- Apply changes with /ecopulse reload (or restart)
Commands
- /shop — open the market GUI
- /price [item] — show market/buy/sell price + Δ% change
- /ecopulse status — diagnostics (Vault/economy/storage/tracked items/settings)
- /ecopulse reload — reload config + messages (and refresh open GUIs)
- /ecopulse add <item> <base> — add/update an item base price
- /ecopulse setbase <item> <base> — set base price
- /ecopulse remove <item> — remove item from market
- /ecopulse resetstats <item> — reset stats for item
Permissions
- ecopulse.shop — default: true
- ecopulse.price — default: true
- ecopulse.status — default: true
- ecopulse.admin — default: op
PlaceholderAPI
- %ecopulse_price_DIAMOND% → market price
- %ecopulse_buy_DIAMOND% → buy price
- %ecopulse_sell_DIAMOND% → sell price
- %ecopulse_change_DIAMOND% → price change % (trend snapshots)
Configuration
EcoPulse uses two files:
config.yml
- market settings (volatility, multipliers, limits)
- tax settings
- GUI settings & categories
- base prices (tracked items)
messages.yml
- all texts, GUI titles, colors (MiniMessage + HEX)
Important: Only items listed in config.yml -> prices: are tracked and shown in the GUI.
Quick Tuning
- Prices too wild? → lower market.volatility (e.g. 0.15)
- Prices too static? → increase market.volatility (e.g. 0.30)
- Want a stronger money sink? → increase market.tax.percent
- Want higher buy costs? → increase market.buyMultiplier
- Want better sell payouts? → increase market.sellMultiplier
FAQ
Q: “No Vault economy provider found.”
A: Vault is installed but no economy plugin. Install EssentialsX Economy (or another economy plugin) and restart.
Q: Items don’t show up in the GUI.
A: EcoPulse only shows items listed in config.yml -> prices:.
Q: Can I change GUI texts/colors?
A: Yes, everything is in messages.yml (MiniMessage supported).
Q: Search?
A: Search is currently disabled by default while it’s being reworked for better stability.
Roadmap
- MySQL support
- Improved search
- Price history / charts
- More GUI customization
