StormEconomy

# StormEconomy StormEconomy is a native economy plugin for Paper servers. It provides player balances, payments, shared bank accounts, transaction history, admin controls, secure storage, and configurable rewards from other Thunder plugins. It is not a Vault shim or a wrapper around another economy system. StormEconomy runs its own economy and exposes `StormEconomyApi` for plugins that want direct integration. ## Features - Player balances with configurable currency name, symbol, decimal places, and starting balance. - `/money` balance checks for self and, with permission, other players. - `/pay` player-to-player transfers. - `/baltop` richest-account leaderboard. - Shared bank accounts with owners, members, deposits, withdrawals, transfers, and deletion. - Configurable bank name pattern. - Optional negative balance support for player accounts and bank accounts. - Account freeze and unfreeze admin controls. - Admin give, take, set, and reset tools. - Transaction history for payments, admin actions, banks, and rewards. - Audit, storage, history, top, backup, save, and reload commands. - Configurable maximum transaction history size. - Optional backup before destructive account actions. - Emits Bukkit events for balance and bank changes. - Registers `StormEconomyApi` through Bukkit services. ## Integrations - ThunderPerms: uses ThunderPerms for permission checks when available, with Bukkit permissions as fallback. - StormMMO: can reward players for level-ups and optional XP gain. - Lifesaver: can reward protection events and larger save events. - Teamwork: can reward cooperation events and optionally reward trusted teammates. - Alignments: can reward players when their alignment changes to a new milestone. - BlockLedger, NPCs, and Bodyguard are soft-detected so StormEconomy can run cleanly alongside them. StormEconomy also registers `StormEconomyApi` and `StormEconomyPermissionBridge`. Developer events: - `StormEconomyBalanceChangeEvent` - `StormEconomyBankChangeEvent` - `StormEconomyRewardEvent` Other plugins can query balances, transfer funds, charge accounts, manage banks, inspect history, and check storage health. ## Commands Main commands: - `/money [player]` - `/pay ` - `/baltop [page]` Bank commands: - `/bank create ` - `/bank balance ` - `/bank deposit ` - `/bank withdraw ` - `/bank transfer ` - `/bank members ` - `/bank add ` - `/bank remove ` - `/bank delete ` Admin and maintenance commands: - `/stormeconomy status` - `/stormeconomy audit` - `/stormeconomy storage` - `/stormeconomy history` - `/stormeconomy top` - `/stormeconomy backup` - `/stormeconomy save` - `/stormeconomy reload` - `/stormeconomy admin give ` - `/stormeconomy admin take ` - `/stormeconomy admin set ` - `/stormeconomy admin reset ` - `/stormeconomy admin freeze ` - `/stormeconomy admin unfreeze ` ## Permissions - `stormeconomy.defaults` - `stormeconomy.use` - `stormeconomy.balance` - `stormeconomy.balance.others` - `stormeconomy.pay` - `stormeconomy.top` - `stormeconomy.bank` - `stormeconomy.admin` - `stormeconomy.admin.give` - `stormeconomy.admin.take` - `stormeconomy.admin.set` - `stormeconomy.admin.reset` - `stormeconomy.admin.freeze` - `stormeconomy.admin.audit` - `stormeconomy.admin.backup` - `stormeconomy.admin.reload` - `stormeconomy.admin.history` - `stormeconomy.admin.save` ## Storage and Security StormEconomy supports YAML, SQLite, MySQL, and MariaDB. SQLite is the default storage backend. Security-focused storage behaviour includes: - Secure MySQL and MariaDB JDBC examples using certificate or hostname verification. - JDBC credential redaction in diagnostics and storage status. - Credential-like JDBC query parameters stripped before database connections are opened. - Prepared SQL statements for stored economy data. - Autosave with manual `/stormeconomy save`. - Local backups with `/stormeconomy backup`. - Optional backup before destructive account actions. - Storage health reporting through commands and API. - Transaction history stored separately from account state for auditing. Use `/stormeconomy storage` or `/stormeconomy status` to verify the active backend. Use `/stormeconomy backup` before major admin changes or data migration. ## Notes StormEconomy does not require Vault, PlaceholderAPI, WorldGuard, or any external economy plugin. It is designed as a native economy service for servers and other Thunder plugins that want direct, auditable economy operations.