Savs Common Economy

# Savs Common Economy A comprehensive, **server-side only** economy mod for Minecraft 26.1 (Fabric), designed for SMP servers and multi-server networks. It provides a robust economy system with support for JSON, SQLite, MySQL, and PostgreSQL storage, offline player support, leaderboards, physical bank notes, player chest shops, and cross-server network synchronization. No client installation required. ## Core Features * **Server-Side Only**: No client modifications needed. Works perfectly for vanilla clients joining your Fabric server. * **Database Support**: Start simple with JSON (default), or scale up to SQLite, MySQL, or PostgreSQL for high-traffic environments. * **Redis Network Sync**: Built-in support for Redis Pub/Sub. Synchronize balances and transaction notifications across proxy setups and multi-server networks. * **Common Economy API**: Full support for the (https://github.com/Patbox/common-economy-api), integrating with Universal Shops, Mob Money, and other compliant economy mods. * **Offline Transactions**: Perform seamless administrative actions and payments to players even when they are offline. * **Chest Shops**: Player shops. Create buy and sell chest shops using vanilla signs. * **Buy & Sell System**: Quickly configure official server prices and empower your players to directly trade with the server using `/buy` and `/sell` commands. (Customizable via `worth.json`). * **Bank Notes**: Players can withdraw their digital balance into physical vanilla paper items to trade or stash away. * **Transaction Logging**: Searchable in-game transaction ledger for server admins (`/ecolog`). * **Vanilla Permissions Setup**: Easily configure command access levels using the `permissions.json` config using vanilla OP clearance levels. ## Commands ### Player Commands * `/bal` or `/balance`: Check your own balance. * `/bal <player>`: Check another player's balance. * `/pay <player> <amount>`: Pay an amount to another player. * `/baltop` or `/balancetop`: View the richest players on the server. * `/withdraw <amount>`: Withdraw money as a physical bank note. * `/worth`: Check the value of the item in your hand. * `/worth all`: Check the value of all items in your inventory matching the one in your hand. * `/worth list`: View an organized, colored table of all server buy and sell prices. * `/worth <item>`: Check the value of a specific item. * `/buy <item> `: Purchase items directly from the server. * `/sell`: Sell the item stack currently in your hand. * `/sell all`: Sell all identical items in your inventory. ### Shop Commands * `/shop create sell <price>`: Create a selling shop (sells items TO players). * `/shop create buy <price>`: Create a buying shop (buys items FROM players). * `/shop remove`: Enter remove-mode to delete a shop by clicking on its sign. * `/shop info`: Display information about the shop you are looking at. * `/shop list`: List all active shops you own. ### Admin Commands (Level 2+ / Configurable) * `/givemoney <player> <amount>`: Add money to a player's account. * `/takemoney <player> <amount>`: Remove money from a player's account. * `/setmoney <player> <amount>`: Set a player's balance to a specific amount. * `/resetmoney <player>`: Reset a player's balance to the default starting value. * `/shop admin`: Toggle Admin Shop creation (infinite stock/funds). * `/ecolog <target> <time> <unit> `: Search transaction logs (e.g., `/ecolog * 1 h`). --- ## Configuration Guide The main configuration file is automatically created at `config/savs-common-economy/config.json`. From here, you can change the default starting balances, currency symbols, and database details. ```json { "defaultBalance": 1000.0, "currencySymbol": "$", "symbolBeforeAmount": true, "enableSellCommands": false, "enableChestShops": true, "storage": { "type": "JSON", "host": "localhost", "port": 3306, "database": "savs_economy", "user": "root", "password": "password", "tablePrefix": "savs_eco_", "poolSize": 10, "connectionTimeout": 30000, "idleTimeout": 600000 }, "redis": { "enabled": false, "host": "localhost", "port": 6379, "password": "", "channel": "savs-economy-updates", "debugLogging": false, "timeout_ms": 5000, "client_name": "Savs-Economy-Node" }, "apiNotificationMode": "ACTION_BAR", "commandNotificationMode": "CHAT" } ``` ### Config Settings Explained #### General * `defaultBalance`: How much money new players start with when they first join. * `currencySymbol`: The symbol shown next to money amounts (e.g. "$", "€", "Coins"). * `symbolBeforeAmount`: If `true`, output shows `$100`. If `false`, output shows `100$`. * `enableSellCommands`: Turns the `/worth`, `/buy`, and `/sell` server market on or off. * `enableChestShops`: Turns the player chest shop sign system on or off. #### Storage Options Controls how