Ledgerune

**Ledgerune** is more than a simple balance plugin. Instead of treating money as a number that can be freely modified, every financial operation is recorded as an immutable transaction with corresponding ledger entries. Payments, fees, taxes, marketplace purchases, loans, payrolls, auctions, investments, and administrative operations are committed atomically, providing a reliable financial foundation for small servers and large multi-server networks. ## Why Ledgerune? Most economy plugins store a player's balance as a mutable value. Ledgerune uses a proper financial ledger where every balance change has a traceable origin. This architecture provides: - Immutable transaction history - Atomic debit, credit, fee, and tax operations - Double-spend protection - Idempotent transaction processing - Append-only, hash-chained audit logs - Persistent recovery state for complex operations - Safe asynchronous database access - Multi-server coordination through shared SQL databases If an operation fails, its related changes are rolled back together. ## Features ### Ledger-Based Economy - Personal, wallet, bank, business, government, joint, escrow, treasury, administrative, and system accounts - Available, locked, and pending balances - Immutable transactions and ledger entries - Statements and transaction history - Refunds and reversals - Correlation and idempotency keys - Deterministic account locking - Controlled currency issuance and removal - Independent ledger integrity verification ### Multiple Currencies Create and manage currencies with: - Configurable decimal precision - Explicit rounding rules - Transfer and conversion permissions - Exchange rates - Conversion spreads - Transaction fees - Administrative enable and disable controls Currency conversions are executed atomically through the ledger. ### Banking Ledgerune includes a configurable banking system with: - Banks and treasury accounts - Customer bank accounts - Account statements - Interest payments - Maintenance charges - Inventory-based interfaces - Secure PIN authentication - PIN attempt lockouts PINs are PBKDF2-hashed with random salts and are never stored or logged as plain text. ### Loans and Credit - Player loan requests - Creditor approval workflows - Loan disbursement - Simple or compound interest - Installment schedules - Early repayment - Payment history - Credit scores - Persistent recovery state ### Companies and Payroll - Business accounts - Company partners and ownership shares - Invitations and employees - Roles and permissions - Salary configuration - Atomic payroll processing - Share transfer history - Bankruptcy workflows ### Player Marketplace - Item listings - Item escrow - Quantity reservations - Atomic purchases - Listing expiration - Cancellation - Persistent delivery claims - Duplication-resistant item delivery Marketplace deliveries use a durable state machine designed to prevent duplicate item claims. ### Auctions - Dedicated escrow accounts - Atomic bid placement - Automatic replacement and refund of previous bids - Reserve prices - Buyouts - Auction settlement - Restart-safe operations - Persistent item delivery ### Investments - Financial instruments - Holdings and positions - Market and limit orders - Price-time order matching - Cash and security reservations - Trade history - Order cancellation - Ledger-funded dividends ### Contracts and Recurring Payments Create persistent financial agreements for: - Subscriptions - Rent - Employment - Loan payments - Custom recurring payments Contracts support multiple signatures, pausing, resuming, cancellation, recovery, and configurable breach policies. ### Taxes and Analytics - Rule-based transfer taxes - Monetary issuance and removal tracking - Money supply snapshots - Currency velocity metrics - Inflation snapshots - Ledger-to-balance integrity checks ### Localization Included languages: - English — en\_US - Brazilian Portuguese — pt\_BR Ledgerune supports: - Per-player language settings - Minecraft client locale detection - Safe language reloading - Fallback validation - Locale-aware numbers, currencies, dates, and times - MiniMessage formatting - Titles, action bars, and boss bars