BlanketEconomy

BlanketEconomy is a versatile mod for managing economy on Minecraft servers, offering a flexible system for working with currencies, player balances, and financial transactions. Whether you're running a small server for friends or a large gaming network, this mod easily adapts to your needs thanks to intuitive commands, customizable parameters, and support for multiple currencies.

Key Features

• Multiple Currency Support: Create and manage various currencies with unique names, descriptions, materials, and identifiers.
• Item Integration: Use Minecraft items with custom models and descriptions as physical representations of currencies.
• Database Integration: Store player balance data in MySQL, SQLite, or use local JSON storage.
• Dynamic Economy: Configure starting balances for new players, manage transactions, and track account status.
• Console Management: All commands are available for execution directly from the server console.
• Permission System: Fine-tuned access rights for various economic operations.
• Flexible Configuration: Customize messages, interfaces, currency parameters, and other aspects through a convenient JSON system.

Commands and Permissions

The mod provides a wide range of commands for economy management:

/beco balance <currency_type>

• Permission: blanketeconomy.balance
• Shows the player's current balance for the specified currency.

/beco balance <player> <currency_type>

• Permission: blanketeconomy.balance.others
• Displays another player's balance.

/beco pay <amount> <player> <currency_type>

• Permission: blanketeconomy.pay
• Transfers the specified amount to another player.

/beco add <amount> <player> <currency_type>

• Permission: blanketeconomy.add
• Adds an amount to the player's balance.

/beco remove <amount> <player> <currency_type>

• Permission: blanketeconomy.remove
• Reduces the player's balance by the specified amount.

/beco deposit <currency_type>

• Permission: blanketeconomy.deposit
• Converts currency items into digital balance.

/beco withdraw <amount> <currency_type>

• Permission: blanketeconomy.withdraw
• Withdraws currency as items for trading or storage.

/beco reload

• Permission: blanketeconomy.reload
• Reloads configuration without server restart.

/beco top

• Permission: blanketeconomy.top
• Shows a leaderboard of balances for the selected currency.

Configuration

BlanketEconomy configuration is highly flexible and adjusted through the config/blanketeconomy/config.json file:

• Creation of custom currencies with unique parameters (name, description, material, symbol, etc.)
• Setting starting balances for each currency
• Enabling/disabling withdrawal, deposit, and transfer functions
• Customization of all game messages with support for color codes and placeholders
• Configuration of database parameters for persistent storage

Adding New Currencies

To add a new currency to the economic system:

1. Locate the configuration file: Open config/blanketeconomy/config.json in your server's config folder.
2. Define a new currency: Add a new entry to the economy list.

Each currency must contain:

• name: Display name of the currency
• lore: Description or legend for the currency item
• material: Minecraft item type representing the currency (e.g., minecraft:gold_ingot)
• custommodeldata: Custom item model data
• currencyType: Unique currency identifier (e.g., gold_coin)
• balanceStart: Starting balance for new players
• symbol: Currency symbol (e.g., $)
• isPrimary: Set to true for primary currency
• transfer: Enable/disable /beco pay function
• withdraw: Enable/disable /beco withdraw function

Example:

{
  "name": "&eCobble Coin",
  "lore": [
    "&8This is a &bcurrency",
    "&8Lore 2"
  ],
  "material": "minecraft:paper",
  "custommodeldata": 7381,
  "currencyType": "cobblecoins",
  "balanceStart": 500,
  "symbol": "$",
  "isPrimary": true,
  "transfer": true,
  "withdraw": true
}

Example for SQLite database:

"localSave": false,
"databaseSave": true,
"database": {
  "type": "sqlite",
  "host": null,
  "port": null,
  "databaseName": "economy.db",
  "username": null,
  "password": null
}

Example for MySQL/MongoDB/PostgreSQL:

"localSave": false,
"databaseSave": true,
"database": {
  "type": "mysql", // here you specify the type of database to use!
  "host": "localhost",
  "port": 3306,
  "databaseName": "economy",
  "username": "root",
  "password": "password"
}

3. Save and reload: After adding the new currency, save the configuration file and execute the /beco reload command to apply the changes.