Economy Overview
Understand how CyberTokens models balances, formatting, storage, and account limits.
CyberTokens is intentionally simple: one global currency, one balance per player, one transaction history stream, and one shared set of formatting and payment rules.
Core model
| Area | How it behaves |
|---|---|
| Currency count | One currency for the entire plugin |
| Names | Separate singular and plural labels |
| Symbol | Customizable string such as $, €, or S/. |
| Formatting | Compact suffixes, decimal trimming, rounding mode, and overflow style |
| Starting balance | Applied to first-time users |
| Maximum balance | Hard cap that prevents balances from growing past the configured value |
| Negative balances | Blocked when prevent-negative is enabled |
Number formatting
config.currency.format controls how large values are presented to players. That includes:
- custom suffix labels like
K,M,B,Qa, orQi - decimal precision for compact output
- whether
.00should be trimmed away - rounding mode and overflow style
This matters most for /money, /baltop, /pay, placeholders, and any plugin that reads the formatted balance string.
Storage backends
CyberTokens supports:
SQLITEMYSQL/MARIADBPOSTGRES/POSTGRESQL
SQLite is the easiest default for a single server. SQL backends make more sense if you want shared storage, backups outside the server folder, or easier external inspection.
Runtime behavior
- Balances are cached to reduce repeated database reads.
- Autosave can run on online users, offline users, or both.
- After each autosave cycle, cached data can be cleared and reloaded.
- Transaction history can be retained and purged over time.
Single-currency by design
If your economy needs distinct currencies with their own files, representation ranges, and shops, move to XenoTokens instead of trying to stretch CyberTokens past its intended model.
Placeholders
PlaceholderAPI values provided by CyberTokens through the %ctk_*% expansion.
Payments & Transactions
Configure how CyberTokens handles /pay, taxes, transaction history, rollback, and cleanup.
Last updated on