CeraEconomy

# CeraEconomy

CeraEconomy is a lightweight, accurate, and reliable economy plugin built specifically for Paper 1.21.x servers.

Designed with simplicity, stability, performance, and accuracy in mind, CeraEconomy provides a complete economy foundation without unnecessary complexity. Whether you are running a small Survival or SMP server, or a larger Skyblock, Prison, Towny, RPG, Lifesteal, or economy-focused network, CeraEconomy provides the essential tools needed to build and maintain a reliable in-game economy.

At its core, CeraEconomy uses BigDecimal-based monetary calculations to provide precise and consistent financial operations while avoiding common floating-point rounding issues. Player accounts are linked to Minecraft UUIDs, ensuring economy data remains connected to players even when their usernames change.

CeraEconomy provides everything expected from a modern server economy, including player balances, player-to-player payments, administrative economy management, balance leaderboards, transaction tracking, configurable economy limits, decimal support, number formatting, automatic account management, and a complete item selling system.

The plugin also includes a complete Bank system with deposits, withdrawals, persistent balances, configurable limits, and daily interest. Server owners can configure the economy and banking systems to fit their server's progression and gameplay style.

CeraEconomy's Sell system provides a configurable GUI-based item selling experience. Server owners can define which items are sellable, configure individual prices, customize GUI layouts and slots, and safely handle item placement, cancellation, transactions, and inventory returns.

For data management, CeraEconomy supports YAML, SQLite, and MySQL, with built-in migration support between all storage types. Automatic saving and HikariCP connection pooling help provide reliable performance and reduce the risk of data loss.

CeraEconomy also integrates with popular Minecraft systems such as Vault and PlaceholderAPI, making it compatible with a wide range of existing plugins and server setups.

Additional features such as Playtime Rewards, diagnostics, version checking, configurable messages, automatic saving, transaction validation, and extensive configuration options allow server owners to customize the economy around their own gameplay experience.

## ✨ Key Features

- Precise BigDecimal-based economy
- UUID-based player accounts
- Player-to-player payments
- Balance leaderboard
- Transaction tracking
- Full Bank system with interest
- Configurable Sell GUI
- Per-item selling prices
- Configurable Playtime Rewards
- YAML storage
- ️ SQLite storage
- MySQL storage
- Storage migration between all backends
- ⚡ HikariCP connection pooling
- Vault integration
- PlaceholderAPI integration
- Built-in diagnostics
- Version and update checking
- Automatic and manual data saving
- ⚙️ Extensive configuration options
- ️ Economy limits and transaction validation
- Support for large number formats such as K, M, B, T, and more
- Built for Paper 1.21.x

## Sell System

CeraEconomy includes a configurable GUI-based Sell system designed for safe and flexible item selling.

Server owners can configure:

- Sellable items
- Individual item prices
- GUI title and layout
- Sell slots
- Sell and Cancel buttons
- Filler items
- Sell system enable/disable state

### Sell Commands

- `/sell`
- `/sell add <item> <price>`
- `/sell set <item> <price>`
- `/sell remove <item>`

Sell item management requires:

`ceraeconomy.sell.admin`

The Sell system uses precise BigDecimal calculations and validates transactions before removing items. Items are safely returned when a sale is cancelled or the GUI is closed, with overflow items dropped at the player's location instead of being silently lost.

## Bank System

CeraEconomy includes a complete configurable Bank system with:

- Deposits
- Withdrawals
- Persistent bank balances
- Maximum balance limits
- Minimum balance limits
- Daily interest
- Configurable interest rates
- Maximum daily interest limits

The Bank system can be enabled or disabled independently through the configuration.

## Storage

CeraEconomy supports multiple storage backends:

- YAML
- SQLite
- MySQL

Storage migration is supported between the available backends, allowing server owners to change their storage solution without rebuilding their economy from scratch.

Automatic saving helps keep economy data persistent while minimizing unnecessary disk operations.

## Integrations

CeraEconomy supports:

- Vault
- PlaceholderAPI

These integrations allow CeraEconomy to work alongside other popular Minecraft server plugins and economy-related systems.

## ⚙️ Configuration

CeraEconomy provides extensive configuration options for:

- Economy limits
- Starting balances
- Decimal precision
- Number formatting
- Payment tax
- Bank settings
- Sell settings
- Playtime rewards
- Storage
- Automatic saving
- Messages
- Vault integration
- Other plugin behavior

## Built for Your Server

CeraEconomy is designed to be flexible enough for different server types while remaining simple to configure and maintain.

Whether your server focuses on Survival, SMP, Skyblock, Prison, Towny, RPG, Lifesteal, or a custom economy system, CeraEconomy provides a solid foundation without adding unnecessary complexity.

## Philosophy

> Simple by design. Lightweight by nature. Accurate by default. Reliable for your server.

CeraEconomy focuses on delivering a dependable economy system that is easy to configure, efficient to operate, and reliable at scale.

**CeraEconomy — A simple, accurate, and reliable economy system for Paper servers.**

# Changelog — 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.x

## License

MIT License