# 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. - `/balance` and `/bal` to view balances. - `/pay` for player-to-player payments. - `/eco` for 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 set ` - `/shop set ` - `/shop add ` - `/shop set ` - `/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.yml` templates. ## 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 ` - `/sell set ` - `/sell remove ` 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.x` folders. - 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` → YAML - `1.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 `. - 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 `/cesell` and `/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

CeraNT