CeraEconomy
A lightweight economy plugin for Paper Minecraft servers.
Автор: CeraNT570обновлён 23 авг. 2026 г.
Экономика
Описание
CeraEconomy — Overview
CeraEconomy is a lightweight and configurable economy plugin for Paper Minecraft, designed to provide a complete server economy system with player balances, payments, banking, leaderboards, shops, selling, persistent storage, and legacy data migration.
Core Systems
Economy
- Player balance management.
/balanceand/balto view balances./payfor player-to-player payments./ecofor economy administration.- Supports setting, adding, removing, and transferring money.
- Uses BigDecimal for accurate monetary values.
- Persistent economy storage.
- Autosave support.
- Transaction management.
Bank
- Separate bank balance system.
- Deposit and withdrawal support.
- Bank balance management.
- Bank GUI.
Commands:
/bank balance/bank deposit/bank withdraw
Balance Top
Commands:
/baltop/balancetop/topbalance
Displays players with the highest economy balances.
Shop System
The Shop system provides a configurable GUI-based marketplace where players can browse sections, view shops, purchase configured items, and pay directly using their economy balance.
Player commands:
/shop/ceshop/cshop
Features:
- Main shop GUI.
- Shop sections.
- Individual shop GUIs.
- Configurable item slots.
- Configurable item prices.
- Automatic economy payments.
- Direct item delivery.
- Balance checks.
- Inventory space protection.
- Clickable GUIs.
Shop Management
Admins can create and manage shops and shop items.
Commands:
/shop add <shop> <slot>/shop set <shop> <slot>/shop set <shop> <name>/shop <shop> add <item> <price> <slot>/shop <shop> set <item> <price>/shop <shop> reset
The reset command only clears the shop's Items section. It does not delete the shop, section, slot, name, title, or display settings.
Shop & Section Architecture
Shop data is separated into Shops/ and Sections/.
Example:
Shops/ └── Food.yml
Sections/ └── Food.yml
Shop and Section files use the same filename to remain linked.
Automatic features:
- Creates missing shop files.
- Creates missing section files.
- Automatically finds available section slots.
- Synchronizes Shops and Sections.
- Provides
Example.ymltemplates.
Shop GUI
The Shop GUI can be configured through config.yml.
Supported GUI sizes:
- 9
- 18
- 27
- 36
- 45
- 54
Default configuration:
shop: Enabled: true Size: 54 Fill: Enabled: true Block: BLACK_STAINED_GLASS_PANE
Sell System
The Sell system allows players to sell configured items through the economy system.
Player commands:
/sell/cesell/csell
Admin commands:
/sell add <item> <price>/sell set <item> <price>/sell remove <item>
Includes item and price validation.
Data & Storage
CeraEconomy uses persistent data storage to keep player economy information between server restarts.
The plugin also uses versioned data folders to keep data separated between plugin versions.
Example:
CeraEconomy-1.4.5/ ├── config.yml ├── Shops/ ├── Sections/ └── ...
Legacy Data Import
CeraEconomy includes a Legacy Data Import system for migrating data from older CeraEconomy versions.
The importer:
- Detects older
CeraEconomy-x.x.xfolders. - Selects the newest valid legacy version.
- Automatically determines supported legacy storage formats.
- Imports compatible economy data.
- Logs the import source and version.
- Reports imported accounts and skipped data.
- Safely handles missing or invalid legacy data.
- Automatically disables the import option after completion.
Supported legacy storage:
< 1.3.0→ YAML1.3.0 - 1.3.3→ YAML + MySQL> 1.3.3→ YAML + MySQL + SQLite
Import can be enabled through:
import-data: true
The option defaults to false and is automatically reset to false after the import process.
Compatibility
- Paper API 1.21
- Vault — soft dependency
- PlaceholderAPI — soft dependency
Architecture
CeraEconomy is organized around several independent systems:
CeraEconomy │ ├── Economy │ ├── Balance │ ├── Payments │ ├── Administration │ └── Storage │ ├── Bank │ ├── Deposit │ ├── Withdrawal │ └── Bank GUI │ ├── Shop │ ├── Sections │ ├── Shops │ ├── Shop Items │ ├── Shop GUI │ └── Purchasing │ ├── Sell │ ├── Sell GUI │ └── Sell Configuration │ ├── Balance Top │ └── Legacy Data Import
Version History
CeraEconomy 1.4.6
- Added Legacy Data Import.
- Added automatic legacy version detection.
- Added YAML, MySQL, and SQLite legacy import support.
- Added safer migration handling.
- Added detailed import logging.
- Updated plugin version to 1.4.6.
CeraEconomy 1.4.5
- Expanded the Shop system.
- Added shop item management.
- Added shop purchasing.
- Integrated Shop with the Economy system.
- Added
/shop <shop>. - Added item reset functionality.
- Added clickable shop and item GUIs.
- Added balance and inventory checks.
- Updated the default shop fill material.
CeraEconomy 1.4.4
- Introduced the Shop system.
- Added
/shop,/ceshop, and/cshop. - Added configurable Shop GUI sizes.
- Added configurable GUI fill.
- Added Shops and Sections folders.
- Added Shop ↔ Section synchronization.
- Added automatic free-slot detection.
- Added
/ceselland/csell.
CeraEconomy 1.4.3
- Previous stable foundation before the Shop system.
Summary
CeraEconomy is an all-in-one economy solution for Paper servers.
It combines:
Economy + Bank + Balance Top + Shop + Sell + Persistent Storage + Legacy Migration
The plugin is designed to provide a simple but extensible economy experience for both players and administrators, while keeping shop data, economy data, and version-specific data organized and manageable.
MIT License
Последние версии
Все версии →release
CeraEconomy 1.4.6
1.4.623 авг. 2026 г.20Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Что нового
# CeraEconomy 1.4.6
## Added
- Added Legacy Data Import system.
- Added `import-data` option to `config.yml`.
- `import-data` defaults to `false`.
- When `import-data: true`, legacy data is imported automatically on plugin startup.
- `import-data` is automatically reset to `false` after the import process.
## Legacy Import Support
- Automatically detects old `CeraEconomy-x.x.x` folders.
- Selects the newest valid older CeraEconomy version for import.
- Requires the legacy folder to follow the `CeraEconomy-x.x.x` format.
### Import Rules
- `< 1.3.0` → YAML
- `1.3.0 - 1.3.3` → YAML + MySQL
- `> 1.3.3` → YAML + MySQL + SQLite
## Improved
- Added version-aware legacy data detection.
- Added logging for import source, version, imported accounts, and skipped data.
- Added safer handling for missing or invalid legacy data.
- Updated plugin version to `1.4.6`.
release
CeraEconomy 1.4.5
1.4.522 авг. 2026 г.3Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Что нового
# CeraEconomy 1.4.5
## 🛒 Shop System
- Added shop management commands:
- `/shop add <shop> <slot>`
- `/shop set <shop> <slot>`
- `/shop set <shop> <name>`
- `/shop <shop> add <item> <price> <slot>`
- `/shop <shop> set <item> <price>`
- `/shop <shop> reset`
- Added `/shop <shop>` to directly open a specific shop.
- Added shop item rendering from `Items` configuration.
- Added item purchase system.
- Added balance checking before purchase.
- Added automatic money deduction when purchasing.
- Added item delivery to player inventory.
- Added inventory-full protection.
- Added invalid item/price protection.
- Shop reset now clears only the shop's `Items` section.
## 🗂️ Shop & Section Files
- Shops and Sections are synchronized automatically.
- Missing shop files are created automatically.
- Missing section files are created automatically.
- Missing sections automatically receive the first available slot.
- Shop title and section display settings are preserved during item reset.
## 🖼️ Shop GUI
- Added clickable shop sections.
- Added clickable shop items.
- Added item prices to item lore.
- Added purchase hint to shop items.
- Shop border/fill now uses:
- `BLACK_STAINED_GLASS_PANE`
## 💰 Economy Integration
- Integrated shop purchases with CeraEconomy's existing economy system.
- Uses `getBalance()` for balance checks.
- Uses `removeBalance()` for purchases.
## 🔧 Configuration
- Updated shop fill material:
- `GLASS`
→ `BLACK_STAINED_GLASS_PANE`
## 📦 Version
- Version bumped:
- `1.4.4` → `1.4.5`
## 🛠️ Compatibility
- Paper API `1.21`
- Vault remains soft-dependent.
- PlaceholderAPI remains soft-dependent.
release
CeraEconomy 1.4.4
1.4.421 авг. 2026 г.2Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Что нового
# CeraEconomy 1.4.4 — Overview
CeraEconomy is a lightweight, accurate, and reliable economy plugin designed for Paper 1.21.x servers.
It provides a complete economy experience with player balances, payments, leaderboards, transaction tracking, banking, selling, shopping, rewards, and multiple storage options.
## ✨ Core Features
- 💰 Precise BigDecimal-based economy
- 👤 UUID-based player accounts
- 💸 Player-to-player payments
- 🏆 Balance leaderboard
- 📜 Transaction tracking
- 🏦 Full Bank system with configurable interest
- 🛒 Configurable Shop system
- 💵 GUI-based Sell system
- 🎁 Playtime Rewards
- 💾 YAML, SQLite, and MySQL storage
- 🔄 Storage migration support
- ⚡ HikariCP connection pooling
- 🔌 Vault integration
- 🧩 PlaceholderAPI integration
- 🩺 Built-in diagnostics and version checking
- 🛡️ Transaction validation and economy limits
- 🔢 Support for large number formats such as K, M, B, and T
## 🆕 What's New in 1.4.4
Version 1.4.4 introduces the new Shop system with /shop, /ceshop, and /cshop commands.
Shop GUIs can be customized with configurable sizes, borders, filler materials, and enable/disable settings.
Shop data is separated into Shops/ and Sections/ folders, making shop management easier and more organized.
The system also automatically creates missing files, synchronizes Shops and Sections, and detects available slots for new Sections.
## 🛒 Sell System
The Sell system allows server owners to create configurable item-selling GUIs with individual prices, customizable layouts, sell slots, buttons, and filler items.
Items are safely handled during transactions, cancellations, and GUI closing, with overflow items returned or dropped safely when necessary.
## 🏦 Bank System
The Bank system supports deposits, withdrawals, persistent balances, balance limits, daily interest, configurable interest rates, and maximum daily interest limits.
## 💾 Storage & Compatibility
CeraEconomy supports YAML, SQLite, and MySQL, with migration support between storage types.
It also integrates with Vault and PlaceholderAPI for compatibility with existing server setups.
## 🚀 Built for Modern Minecraft Servers
Whether you're running a Survival, SMP, Skyblock, Prison, Towny, RPG, Lifesteal, or economy-focused server, CeraEconomy provides a simple and reliable foundation for managing your server's economy.
CeraEconomy — Simple by design. Lightweight by nature. Accurate by default. Reliable for your server.
release
CeraEconomy 1.4.3
1.4.320 авг. 2026 г.0Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Что нового
# CeraEconomy 1.4.3
## ✨ Added
- Added configurable Sell system toggle:
- `Sell.Enabled: true`
- Added `/sell add <item> <price>`
- Added `/sell set <item> <price>`
- Added `/sell remove <item>`
- Added `ceraeconomy.sell.admin` permission.
- Added more default sellable minerals, ores, raw ores, deepslate ores, and Nether ores.
## 🔧 Improved
- Improved Sell GUI interaction protection.
- Protected filler, SELL, and CANCEL slots.
- Improved shift-click, number-key, double-click, hotbar swap, and drag protection.
- Improved item return handling when cancelling or closing the Sell GUI.
- Improved inventory overflow handling when returning items.
- Sell prices use precise `BigDecimal` calculations.
- Sell configuration is saved directly to `sell.yml`.
- `/sell` now respects the global `Sell.Enabled` setting.
## 🐛 Fixed
- Fixed filler being placed inside sell slots.
- Fixed filler interaction issues.
- Fixed Sell GUI session handling when cancelling/closing.
- Fixed sellable item removal behavior.
- Removed duplicate `pay:` configuration entries.
- `config.yml` now contains only one `pay.tax` section.
## 🧹 Configuration
- Added:
Sell:
Enabled: true
- Expanded the default `sell.yml` item list.
- Removed duplicate payment tax configuration.
## 📦 Version
- Updated CeraEconomy from `1.4.2` to `1.4.3`.
- Java 21
- Paper API 1.21.11
release
CeraEconomy 1.4.2
1.4.219 авг. 2026 г.1Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Что нового
# Changelog
## CeraEconomy 1.4.2
### Added
- Added `/sell` command.
- Added Sell GUI for selling items.
- Added configurable Sell GUI layout.
- Added configurable sell slots.
- Added configurable Sell and Cancel button slots.
- Added configurable GUI title.
- Added configurable filler items.
- Added per-item selling prices.
- Added separate `sell/sell.yml` configuration.
- Added automatic creation of the Sell configuration folder and file.
- Added support for selling item quantities based on their configured unit price.
- Added transaction logging for successful sales.
### Configuration
- Sell configuration is stored separately from the main `config.yml`.
- Sell items can be enabled or disabled individually.
- Item prices use `BigDecimal` values.
- GUI size and slots can be customized.
- Filler configuration is applied only to protected GUI slots.
- Sell slots remain available for player item placement.
### Safety / Fixes
- Items that are not configured in `sell.yml` cannot be sold.
- Sell GUI filler items cannot be taken or moved.
- Sell and Cancel button items cannot be taken or moved.
- Protected GUI slots are blocked against normal clicks, shift-clicks, number-key swaps, hotbar swaps, double-click collection, and invalid drag operations.
- Only configured sell slots accept player items.
- Items are returned when cancelling or closing the Sell GUI.
- Fixed item return handling when cancelling the Sell GUI.
- Selling respects the economy maximum balance.
- Failed sales do not remove the player's items.
- Only successfully sellable items are removed after payment succeeds.
- Full inventories are handled safely when returning items.
- Sell filler items do not affect sell calculations or transaction totals.
### Command
- `/sell` — Open the Sell GUI.
### Notes
- Sell prices are calculated per item.
- Example: Diamond price `100`, selling 32 Diamonds gives `3200`.
- Currently configured example:
- `DIAMOND` → `100` per item.
- `GOLD_INGOT` → `25` per item.
- `IRON_INGOT` → `10` per item.
- `COAL` → `5` per item.
- `DIAMOND_ORE` and `DEEPSLATE_DIAMOND_ORE` are not sellable unless explicitly added to `sell.yml`.
- Sell transactions are recorded through CeraEconomy's TransactionManager.
- Transactions are saved through the existing AutoSave system rather than being forced to disk after every sale.
release
CeraEconomy 1.4.1
1.4.118 авг. 2026 г.0Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Что нового
CeraEconomy 1.4.1
Added
- Added a new Playtime Rewards system.
- Players can now earn money based on their total playtime.
- Added configurable playtime reward milestones:
- 30 minutes → $10
- 1 hour → $25
- 6 hours → $50
- 12 hours → $100
- 18 hours → $250
- 1 day → $500
- 1 week → $1,000
- Added a configurable reward message with "{time}" and "{reward}" placeholders.
- Added an "enabled" option to easily enable or disable the Playtime Rewards system.
Configuration
play-time:
enabled: true
message: "&aYou have played for &e{time} &aand received &f{reward}$!"
rewards:
30m: 10
1h: 25
6h: 50
12h: 100
18h: 250
1d: 500
1w: 1000
Notes
- Playtime rewards are fully configurable through the main configuration file.
- Reward amounts and milestones can be changed without modifying the plugin.
- The Playtime Rewards feature can be disabled by setting "enabled" to "false".
release
CeraEconomy 1.4.0
1.4.017 авг. 2026 г.0Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Что нового
CeraEconomy v1.4.0
Added
- Added support for number suffixes in economy-related commands.
- Supported suffixes include:
- "K" — Thousand
- "M" — Million
- "B" — Billion
- "T" — Trillion
- "Qa"
- "Qi"
- "Sx"
- "Sp"
- Additional suffixes are supported where applicable.
- Suffix notation is now available for commands such as "/pay", "/eco", and other commands that accept monetary values.
Examples
/pay Steve 10K
/pay Steve 2.5M
/eco give Steve 1B
/eco take Steve 500K
Improvements
- Improved monetary value parsing.
- Simplified the input of large amounts.
- Maintained compatibility with standard numeric values.
Notes
This release focuses on improving usability when working with large economy values, making transactions and administrative commands faster and more convenient.
Version: "1.4.0"
release
CeraEconomy 1.3.8
1.3.816 авг. 2026 г.1Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Что нового
# CeraEconomy 1.3.8
## ✨ Added
### Cera Bank GUI
- Added interactive /bank GUI.
- Added Bank Balance display.
- Added Deposit button.
- Added Withdraw button.
- Added Refresh button.
- Added Close button.
- Added chat-based amount input.
- Added cancel support while entering amounts.
### Payment Tax
- Added configurable tax system for /pay.
- Default tax rate: 5%.
- Tax can be enabled/disabled from config.yml.
- Tax is deducted from the sender.
- Receiver receives the full payment amount.
- Added tax-aware insufficient-funds checking.
## ⚙️ Configuration
Added:
pay:
tax:
enabled: true
rate: "5.0"
## ️ Improvements
- Improved Bank GUI input handling.
- Prevented repeated chat-listener registration.
- Improved bank transaction feedback.
- Updated plugin version from 1.3.7 to 1.3.8.
## Data
- Existing economy/bank data is preserved.
- Previous version's old log history is not migrated.
## Technical
- Updated Maven/plugin version to 1.3.8.
- Cleaned up Bank GUI implementation.
- Built successfully with Maven Shade.
## Tested
- The entire new GUI bank system has been tested.
##Note
- “Steal” and “Store” are provided by a client-side mod and are not features of CeraEconomy.
License: MIT License
release
CeraEconomy 1.3.7
1.3.715 авг. 2026 г.0Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Что нового
# CeraEconomy 1.3.7
## Added
- Added automatic update checking via GitHub.
- Added `ceraeconomy.version.doctor` permission.
- Players with the permission are notified when a newer version is available.
- Added `/ce doctor` for plugin health diagnostics.
## Improved
- Improved version information in `/ce version`.
- Improved plugin startup and status diagnostics.
- Improved version checking and update notifications.
## Fixed
- Fixed plugin version reporting to correctly show `1.3.7`.
- Fixed version metadata between `pom.xml` and `plugin.yml`.
## Build
- Java 21
- Paper 1.21.11
release
CeraEconomy 1.3.6
1.3.615 авг. 2026 г.1Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Что нового
# CeraEconomy Changelog
## 1.3.6
### 🏦 Bank System
- Added full Bank system.
- Added `/bank` command.
- Added `/bank balance`.
- Added `/bank deposit <amount>`.
- Added `/bank withdraw <amount>`.
- Added console-compatible Bank testing commands:
- `/bank <player>`
- `/bank balance <player>`
- `/bank deposit <player> <amount>`
- `/bank withdraw <player> <amount>`
- Added configurable bank maximum balance.
- Added configurable bank minimum balance.
- Added Bank enable/disable configuration.
- Added daily Bank interest.
- Default daily interest rate: `5% / 24 hours`.
- Added configurable maximum interest.
- Added `lastInterest` storage support.
- Added Bank balance persistence.
### 💾 Storage
- Extended Storage interface with Bank support.
- Added:
- `getBankBalance`
- `setBankBalance`
- `getBankBalances`
- `getLastInterest`
- `setLastInterest`
- YAML storage supports Bank data.
- SQLite storage supports Bank data.
- MySQL storage supports Bank data.
### 🔌 Vault
- Updated Vault economy bridge.
- Vault bridge now loads correctly with CeraEconomy.
- Economy integration remains compatible with Vault.
### 🛠️ Commands & Permissions
- Added `ceraeconomy.bank` permission.
- Bank permission defaults to `true`.
- Added `/bank` tab completion.
- Improved Bank command handling.
### 💾 Reliability
- Bank deposits and withdrawals are persisted immediately.
- Daily interest updates are persisted.
- Economy and transaction auto-save remains enabled.
- Fixed Storage compilation issues related to Bank balances.
### 📦 Version
- Updated version from `1.3.5` → `1.3.6`.
## 1.3.5
### Storage
- Added Bank and daily-interest storage support.
- Added Bank balance storage methods.
- Added last-interest tracking.
- Fixed SQLite/MySQL storage compilation.
### Economy
- Fixed balance and transaction saving behavior.
- Fixed numeric parsing exception handling.
---
**CeraEconomy 1.3.6 — Bank System Update 🏦💰**