# Azrova’s Economy – This project is no longer managed by Azrova, you can fork but please make sure to give us credits!<\/p>\n
A robust and feature-rich economy plugin for PaperMC\/Bukkit servers, designed to provide essential economic functionalities with support for Vault and optional PlaceholderAPI integration.<\/p>\n
—<\/p>\n
## Features<\/p>\n
* **Core Economy via Vault:** Leverages Vault for broad compatibility with other economy-related plugins.
\n* **Player Account Management:** Complete user account creation, removal, and access control system.
\n* **User Access Control:** Administrators can remove users from the economy system, preventing access to all economy commands.
\n* **Configurable Starting Balance:** Set a starting amount for new players.
\n* **Daily Rewards:** Allow players to claim a configurable daily reward.
\n* **Player-to-Player Payments:** `\/pay` command for transferring money.
\n* **Banknotes:** `\/withdraw` command to create physical banknotes that can be redeemed.
\n* **Balance Checking:** `\/balance` command for players to check their own or others’ balances (permission-based).
\n* **Richest Players List:** `\/money top` command to display the top N richest players.
\n* **Organized Admin Commands:** Separate command sets for balance management and user management.
\n* **Comprehensive Help System:** In-game help via `\/eco help [topic]` for economy, admin, and user management commands.
\n* **PlaceholderAPI Support (Optional):** Display player balances via `%azrovaseconomy_balance%`.
\n* **Configurable Currency Symbol:** Customize the currency symbol (e.g., $, \u20ac, etc.) in `config.yml`.
\n* **SQLite Data Storage:** Player data is saved locally using SQLite, requiring no external database setup.<\/p>\n
—<\/p>\n
## Dependencies<\/p>\n
* **Vault (Required):** Azrova’s Economy relies on Vault to provide the economy API. This plugin will not function without Vault installed.
\n* **PlaceholderAPI (Optional):** If you wish to use placeholders like `%azrovaseconomy_balance%` in other plugins (e.g., scoreboards, chat), PlaceholderAPI must be installed. The plugin will function normally without it, but placeholders will not be available.<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Ensure your server is running PaperMC 1.21.x or a compatible version.
\n2. Install **Vault** if you haven’t already. Download it from SpigotMC and place the JAR file in your server’s `plugins` folder.
\n3. (Optional) Install **PlaceholderAPI** if you intend to use placeholders. Download it from SpigotMC and place the JAR file in your server’s `plugins` folder.
\n4. Download the latest release of `AzrovasEconomy.jar` from the Releases Page.
\n5. Place the `AzrovasEconomy.jar` file into your server’s `plugins` folder.
\n6. Restart or reload your server.<\/p>\n
—<\/p>\n
## Configuration<\/p>\n
The plugin will generate a `config.yml` file in its plugin folder (`plugins\/AzrovasEconomy\/config.yml`) upon first run. You can modify these settings:<\/p>\n
“`yaml
\nstarting-balance: 100.0
\ndaily-reward-amount: 100.0
\ncurrency-symbol: “$”
\ndaily-enabled: true
\n“`<\/p>\n
* `starting-balance`: The amount of money a player receives when they join the server for the first time and an account is created for them.
\n* `daily-reward-amount`: The amount of money a player receives when they use the `\/daily` command.
\n* `currency-symbol`: The symbol used before amounts in messages (e.g., “$100.00”).
\n* `daily-enabled`: Whether the daily reward system is enabled. Set to `false` to disable the `\/daily` command entirely.<\/p>\n
—<\/p>\n
## Commands & Permissions<\/p>\n
Below is a list of commands and their associated permissions. Permissions set to `true` under `default` are enabled for all users by default. Permissions set to `op` are enabled for server operators by default.<\/p>\n
### Player Commands<\/p>\n
| Command | Description | Permission | Default |
\n| —————————- | ———————————————— | ——————————— | ———- |
\n| `\/pay [user] [amount]` | Pay a user an amount of money. | `azrova.economy.pay` | `true` |
\n| `\/withdraw [amount]` | Withdraw money as a physical banknote. | `azrova.economy.withdraw` | `true` |
\n| `\/balance` or `\/bal` | Shows your current balance. | `azrova.economy.balance` | `true` |
\n| `\/balance [user]` | Shows another user’s balance. | `azrova.economy.balance.others` | `op` |
\n| `\/money top` | Shows the top richest players. | `azrova.economy.money.top` | `true` |
\n| `\/daily` | Claim your daily reward. | `azrova.economy.daily` | `true` |<\/p>\n
### Admin Commands<\/p>\n
#### Help System
\n| Command | Description | Permission | Default |
\n| —————————- | ———————————————— | ——————————— | ———- |
\n| `\/eco help` | Shows available help topics. | `azrova.admin` | `op` |
\n| `\/eco help economy` | Shows general economy commands help. | `azrova.admin` | `op` |
\n| `\/eco help admin` | Shows admin balance commands help. | `azrova.admin` | `op` |
\n| `\/eco help user` | Shows user management commands help. | `azrova.admin` | `op` |<\/p>\n
#### Balance Management (Legacy \/eco commands)
\n| Command | Description | Permission | Default |
\n| —————————- | ———————————————— | ——————————— | ———- |
\n| `\/eco set [user] [amount]` | Set a user’s balance. | `azrova.admin.set` | `op` |
\n| `\/eco remove [user] [amount]`| Remove money from a user. | `azrova.admin.remove` | `op` |
\n| `\/eco delete [user]` | Delete a user’s economy account. | `azrova.admin.delete` | `op` |<\/p>\n
#### Balance Management (New \/eco admin commands)
\n| Command | Description | Permission | Default |
\n| —————————— | ———————————————— | ——————————— | ———- |
\n| `\/eco admin set [user] [amount]`| Set a user’s balance. | `azrova.admin.set` | `op` |
\n| `\/eco admin add [user] [amount]`| Add money to a user’s balance. | `azrova.admin.add` | `op` |
\n| `\/eco admin remove [user] [amount]`| Remove money from a user. | `azrova.admin.remove` | `op` |
\n| `\/eco admin delete [user]` | Delete a user’s economy account. | `azrova.admin.delete` | `op` |<\/p>\n
#### User Management
\n| Command | Description | Permission | Default |
\n| —————————— | ———————————————— | ——————————— | ———- |
\n| `\/eco user create [username]` | Create an economy account for a user. | `eco.admin.user.create` | `op` |
\n| `\/eco user remove [username]` | Remove a user’s economy account. | `eco.admin.user.remove` | `op` |<\/p>\n
### Base Admin Permission
\n| Permission | Description | Default |
\n| —————————- | ———————————————— | ———- |
\n| `azrova.admin` | Base permission for all admin commands. | `op` |<\/p>\n
—<\/p>\n
## User Access Control<\/p>\n
Azrova’s Economy includes a comprehensive user access control system:<\/p>\n
### Account Management
\n– **Account Creation:** Administrators can create economy accounts for users with `\/eco user create [username]`
\n– **Account Removal:** Administrators can remove users from the economy system with `\/eco user remove [username]`
\n– **Access Prevention:** Removed users cannot use any economy commands until their account is recreated<\/p>\n
### Removed User Behavior
\nWhen a user’s economy account is removed:
\n– All economy commands (`\/balance`, `\/pay`, `\/withdraw`, `\/daily`) will fail with a clear error message
\n– The user receives the message: “You do not have an economy account. Contact an administrator.”
\n– No automatic account recreation occurs – accounts must be manually recreated by administrators
\n– Other players cannot pay money to removed users<\/p>\n
### Account Recreation
\n– Removed users can have their accounts recreated using `\/eco user create [username]`
\n– New accounts start with the configured starting balance
\n– All economy functionality is restored upon account recreation<\/p>\n
—<\/p>\n
## Help System<\/p>\n
The plugin features a comprehensive in-game help system accessible through `\/eco help`:<\/p>\n
– **`\/eco help`** – Shows all available help topics
\n– **`\/eco help economy`** – Lists all player economy commands
\n– **`\/eco help admin`** – Lists all admin balance management commands
\n– **`\/eco help user`** – Lists all user management commands with usage notes<\/p>\n
—<\/p>\n
## Placeholders (PlaceholderAPI)<\/p>\n
If PlaceholderAPI is installed, the following placeholder is available:<\/p>\n
* `%azrovaseconomy_balance%`: Displays the player’s current balance, formatted with the configured currency symbol.
\n * Example: `You have: %azrovaseconomy_balance%` might display as `You have: $150.50`
\n * Returns `$0.00` for users without economy accounts<\/p>\n
—<\/p>\n
## Building from Source<\/p>\n
If you wish to build the plugin from source:<\/p>\n
1. Clone the repository: `git clone https:\/\/github.com\/Azrova\/AzrovasEconomy.git`
\n2. Navigate to the project directory: `cd AzrovasEconomy`
\n3. Ensure you have Java 21 (or the version specified in `build.gradle.kts`) installed and configured.
\n4. Run the Gradle build command:
\n * On Windows: `.gradlew build`
\n * On Linux\/macOS: `.\/gradlew build`
\n5. The compiled JAR file will be located in `build\/libs\/`.<\/p>\n
—<\/p>\n
## Authors & Support<\/p>\n
* **Authors:** CNethuka, Sobble
\n* **Support & Bug Reports:** Please use the Issues Page on GitHub.
\n* **Project Repository:** https:\/\/github.com\/Azrova\/AzrovasEconomy<\/p>\n
—<\/p>\n
Made with \u2764 by CNethuka and Sobble<\/p>\n","protected":false},"excerpt":{"rendered":"
A robust and feature-rich economy plugin for PaperMC\/Bukkit servers, designed to provide essential economic functionalities with support for Vault and optional PlaceholderAPI integration.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"azrovas-economy","_minecraft_project_id":"LCTtjdhK","_minecraft_author":"cnethuka","_minecraft_license":"Apache-2.0","_minecraft_downloads":175,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"azrovas-economy.zip","_minecraft_size_bytes":27010166,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T13:05:29.190628Z","_minecraft_date_created":"2025-06-08T06:45:37.408814Z","_minecraft_date_modified":"2025-06-08T12:29:53.312224Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/azrovas-economy","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-01T08:27:22+00:00","_minecraft_import_hash":"6aa981e7ae020001964c3cefc75d255d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,126,127,92],"mod_loader":[130,132],"minecraft_version":[62,37,73,74,38,78],"class_list":["post-24496","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-economy","mod_category-management","mod_category-paper","mod_category-utility","mod_loader-bukkit","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5"],"yoast_head":"\n