BEconomy

BEconomy is a powerful and customizable economic system modification for Minecraft servers, offering flexible tools for managing currencies, player balances and financial transactions. Whether you're running a small friends-only server or a large network, BEconomy enables you to adapt the economy to your needs through intuitive commands, advanced settings and multi-currency support.

Key Features

• Multiple Currency System: Create and manage different monetary units with unique names, descriptions, appearance and identifiers.
• Item Integration: Use in-game items with custom models and descriptions as physical representations of currency.
• Database Support: Work with MySQL, SQLite databases or local JSON storage to save user balance information.
• Dynamic Economy: Configure starting amounts for newcomers, control transactions and track player account status across different currencies.
• Full Console Control: All main commands are available for execution through the server console.
• Flexible Permission System: Fine-tune user access rights to various financial operations.
• Extensive Settings: Change messages, interfaces, currency parameters and more through convenient JSON configuration.

Commands and Permissions

BEconomy includes a comprehensive set of commands for server economy management:

/beco balance <currencyType>

• Permission: beconomy.balance
• Shows the player's current balance in the specified currency.

/beco balance <player> <currencyType>

• Permission: beconomy.balance.others
• Displays another user's balance.

/beco pay <amount> <player> <currencyType>

• Permission: beconomy.pay
• Transfers the specified currency amount to another participant.

/beco add <amount> <player> <currencyType>

• Permission: beconomy.add
• Replenishes the player's balance by the specified amount of money.

/beco remove <amount> <player> <currencyType>

• Permission: beconomy.remove
• Deducts the specified amount from the user's balance.

/beco deposit <currencyType>

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

/beco withdraw <amount> <currencyType>

• Permission: beconomy.withdraw
• Converts digital currency into physical items for storage or exchange.

/beco reload

• Permission: beconomy.reload
• Updates plugin configuration without requiring server restart.

/beco top

• Permission: beconomy.top
• Shows a leaderboard of players with highest balances in the specified currency.

/beco set <amount> <currencyType> <player>

• Permission: beconomy.set
• sets the exact money amount for the specified user.

/beco offline set <amount> <currencyType> <player>

• Permission: beconomy.offline.set
• enables setting an amount for a user disconnected from the server.

/beco offline balance <player> <currencyType>

• Permission: beconomy.offline.balance
• views the balance of a player who is not currently online.

/beco offline add <player> <amount> <currencyType>

• Permission: beconomy.offline.add
• replenishes the account of an absent user.

/beco offline remove <player> <amount> <currencyType>

• Permission: beconomy.offline.remove
• deducts a specific amount from the offline financial status of a participant.

Configuration Settings

BEconomy's configuration system provides extensive customization options for your server economy parameters through the config/beconomy/config.json file:

• Creation of custom currencies with individual characteristics (name, description, material, symboiden).
• Assignment of starting balances for each currency.
• Enabling or disabling withdrawal, deposit and transfer functions for individual monetary units.
• Modification of game messages with support for color codes and variables.
• Work with database settings for permanent preservation of financial system state.

Adding New Currency

To create a new monetary unit, perform the following:

1. Open Configuration File: Locate the config/beconomy/config.json file in your server's settings directory.

2. Define Currency Parameters: Add a new entry to the economy section of the configuration file.

Each coin requires the following characteristics:

• name: custom name of the monetary unit
• lore: description of the currency item
• material: type of game item to represent currency (e.g., minecraft:gold_ingot)
• custommodeldata: custom model data for the item when necessary
• currencyType: unique currency identifier (e.g., gold_coin)
• balanceStart: amount for newly joined server participants
• symbol: monetary designation symbol (e.g., $)
• isPrimary: set to "true" for the main monetary unit of the economy
• transfer: allow or prohibit transfers between accounts in this coin unit
• withdraw: show or hide cashout commands for this system

Configuration 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
}

Sample for Sqlite Database:

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

Sample for MySQL/MongoDB/PostgreSQL:

"localSave": false,
"databaseSave": true,
"database": {
  "type": "mysql", // here you choose the type of database used by the plugin!
  "host": "localhost",
  "port": 3306,
  "databaseName": "economy",
  "username": "root",
  "password": "password"
}

3. Saving and Updating: After adding currency, s apping change из applied through вы inications.