MINECRAFTBIBLE
Loading...
Full-featured economy mod with mod compatability, multi-server support, database backends, Redis Pub/Sub, player chest shops, bank notes, and transaction history. Server-side only!
A server-side only economy mod for Minecraft 1.21.10 & 1.21.11 (Fabric), designed for SMP servers and multi-server networks. It provides a robust and modern economy system with support for JSON, SQLite, MySQL, and PostgreSQL storage, offline player support, leaderboards, physical bank notes, and player chest shops. No client installation required!
/baltop.The following mods have been tested and confirmed to work seamlessly with Savs Common Economy:
/bal or /balance: Check your own balance./bal <player>: Check another player's balance (Online or Offline)./pay <player> <amount>: Pay a specific amount to another player./baltop or /balancetop: View the top 10 richest players on the server./withdraw <amount>: Withdraw money as a physical bank note (vanilla paper item)./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: List all sellable items and their prices./worth <item>: Check the value of a specific item (e.g., minecraft:apple)./sell: Sell the item stack currently in your hand./sell all: Sell all items in your inventory matching the one in your hand./shop create sell <price>: Create a selling shop for the item in your hand (requires looking at a chest)./shop create buy <price>: Create a buying shop for the item in your hand./shop remove: Enter "remove mode" - click your shop sign to remove it./shop list: List all shops you own./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 create sell <price> (then /shop admin): Create an Admin Shop (infinite stock)./ecolog <target> <time> <unit> [page]: Search transaction logs (e.g., /ecolog * 1 h).target: Player name or * for all.time: Number of time units (e.g., 1, 30).unit: Time unit (s=seconds, m=minutes, h=hours, d=days).page: Optional page number for pagination./ecodebug verify: Test database connection and transaction safety (creates a temporary test account)./ecodebug cleanup: Remove the test account created by /ecodebug verify.The configuration file is located at config/savs-common-economy/config.json.
{
"defaultBalance": 1000,
"currencySymbol": "$",
"symbolBeforeAmount": true,
"enableSellCommands": false,
"enableChestShops": true,
"storage": {
"type": "JSON",
"host": "localhost",
"port": 3306,
"database": "savs_economy",
"user": "root",
"password": "password",
"tablePrefix": "savs_eco_"
},
"apiNotificationMode": "ACTION_BAR",
"commandNotificationMode": "CHAT"
}
defaultBalance: The amount of money new players start with (default: 1000).currencySymbol: The symbol used for currency (e.g., "$", "€", "Coins").symbolBeforeAmount: If true, shows "$100"; if false, shows "100$".enableSellCommands: Set to true to enable /worth and /sell commands.enableChestShops: Set to true to enable the chest shop system.storage.type: Storage backend to use (JSON, SQLITE, MYSQL, POSTGRESQL).storage.host: Database host (for MySQL/PostgreSQL).storage.port: Database port (for MySQL/PostgreSQL).storage.database: Database name (for MySQL/PostgreSQL).storage.user: Database username (for MySQL/PostgreSQL).storage.password: Database password (for MySQL/PostgreSQL).storage.tablePrefix: Prefix for database tables (for SQL backends).storage.poolSize: Connection pool size (default: 10, for SQL backends).storage.connectionTimeout: Connection timeout in milliseconds (default: 30000).storage.idleTimeout: Idle connection timeout in milliseconds (default: 600000).apiNotificationMode: Controls generic notifications (e.g., "Balance updated") triggered by other mods via the API.CHAT, ACTION_BAR, NONE.ACTION_BAR (Recommended to reduce spam).commandNotificationMode: Controls feedback for direct commands (e.g., /pay, /givemoney).CHAT, ACTION_BAR, NONE.CHAT.For multi-server networks, you can enable Redis Pub/Sub for real-time cache synchronization:
"redis": {
"enabled": false,
"host": "localhost",
"port": 6379,
"password": "",
"channel": "savs-economy-updates",
"debugLogging": false
}
redis.enabled: Set to true to enable Redis Pub/Sub (default: false).redis.host: Redis server hostname.redis.port: Redis server port (default: 6379).redis.password: Redis password (leave empty if no auth).redis.channel: Pub/Sub channel name (default: "savs-economy-updates").redis.debugLogging: Enable verbose Redis logging for debugging (default: false).The mod supports multiple storage backends for economy data:
config/savs-common-economy/balances.jsonconfig/savs-common-economy/economy_data.sqlite"type": "SQLITE" in configCREATE DATABASE savs_economy;CREATE USER 'minecraft'@'%' IDENTIFIED BY 'password';GRANT ALL PRIVILEGES ON savs_economy.* TO 'minecraft'@'%';Example MySQL/MariaDB Config:
"storage": {
"type": "MYSQL",
"host": "your-database-server.com",
"port": 3306,
"database": "savs_economy",
"user": "minecraft",
"password": "your_secure_password",
"tablePrefix": "savs_eco_"
}
Note: For multi-server networks:
For networks with multiple Minecraft servers sharing the same economy:
With Redis enabled:
Without Redis:
If enableSellCommands is true, a worth.json file will be created in the same directory. Use this to define item prices:
{
"itemPrices": {
"minecraft:apple": 10.0,
"minecraft:diamond": 100.0
}
}
Chest shops allow players to buy and sell items using chests and signs.
How to create a Shop:
/shop create sell <price> to create a shop that sells to players./shop create buy <price> to create a shop that buys from players.Interaction:
all).Bank notes are physical representations of currency that can be traded between players or used with chest shop mods. They appear as vanilla paper items with a custom name showing their value.
How to use:
/withdraw <amount> to convert your balance into a bank noteFeatures:
This mod supports the Fabric Permissions API. To manage these permissions, you will need a permissions management mod such as LuckPerms (recommended) or any other mod that implements the Fabric Permissions API.
If no permissions mod is installed, the mod falls back to vanilla OP levels (Level 2 for admin commands).
savscommoneconomy.command.bal: Access to /bal (self).savscommoneconomy.command.bal.others: Access to /bal <player>.savscommoneconomy.command.pay: Access to /pay.savscommoneconomy.command.withdraw: Access to /withdraw.savscommoneconomy.command.baltop: Access to /baltop.savscommoneconomy.command.worth: Access to /worth.savscommoneconomy.command.sell: Access to /sell.savscommoneconomy.shop.create: Access to /shop create.savscommoneconomy.shop.remove: Access to /shop remove (own shops).savscommoneconomy.shop.info: Access to /shop info.savscommoneconomy.shop.list: Access to /shop list.savscommoneconomy.admin: Grants access to all admin features:/givemoney, /takemoney, /setmoney, /resetmoney/ecolog (view transaction logs)/ecodebug verify and /ecodebug cleanup (database testing)/shop admin (create admin shops)