# UniversalEconomy UniversalEconomy is an economy plugin made for Endstone focused on performance, simplicity, and multi-database support.
## Commands | Name | Description | Usage | Permission | |---------------|----------------------------------|---------------------------------------------------|-------------------| | balance | Show your and others balance | `balance [player: string]` | `economy.balance` | | pay | Pay others with your balance | `pay ` | `economy.pay` | | rich | View the top balances | `rich [page: int]` | `economy.rich` | | addbalance | Add funds to others balance | `addbalance ` | `economy.admin` | | removebalance | Remove funds from others balance | `removebalance ` | `economy.admin` | | setbalance | Set others balance | `setbalance ` | `economy.admin` | ## Features - [x] MySQL Database - [x] SQLite Database - [x] Service API for other plugins - [x] Easy to use - [x] Lightweight - [x] Fast and efficient - [x] TTL-based cache system - [x] Multi-language support (English, Vietnamese, Russian, Korean) - [x] Customizable currency formatting - [x] Transaction events (cancellable) ## Examples ### Retrieving a Player's Balance You can retrieve a player's balance using the `get` method. This reads from cache and returns instantly. ```cpp #include auto eco = server.getServiceManager().load("Economy"); if (!eco) { // Economy service not available return; } double balance = eco->get("player_xuid"); ``` ### Retrieving Top Balances You can retrieve the top balances using the `bulk` method. ```cpp auto top = eco->bulk(10); // top 10 players for (auto &entry : top) { logger.info("{}: {}", entry.player, entry.balance); } ``` ### Adding Funds to a Player's Balance You can add funds to a player's balance using the `add` method. ```cpp auto future = eco->add("player_xuid", 500.0); bool success = future.get(); if (!success) { // Failed (e.g., event was cancelled) } ``` ### Subtracting Funds from a Player's Balance You can subtract funds from a player's balance using the `subtract` method. ```cpp auto future = eco->subtract("player_xuid", 100.0); bool success = future.get(); if (!success) { // Failed (e.g., insufficient funds, or event was cancelled) } ``` ### Transferring Funds Between Players You can transfer funds from one player to another using the `transfer` method. ```cpp auto future = eco->transfer("source_xuid", "target_xuid", 250.0); bool success = future.get(); if (!success) { // Failed (e.g., insufficient funds, same player, or event was cancelled) } ``` ## Configuration The default configuration is generated at `plugins/universal_economy/config.yml`: ```yaml locale: "en-US" database: type: "sqlite" mysql: host: "localhost" port: 3306 database: "economy" username: "root" password: "" currency: name: "United States Dollar" code: "USD" symbol: "$" formatter: "compact" # compact or commadot default: amount: 0 decimals: "00" decimals: false cache: invalidation: 300 # Cache TTL in seconds, 0 to disable rich-rows: 100 # Max rows for /rich command, 0 for all balance-command: true # Cache /balance reads ``` ## Language Support Language files are generated at `plugins/universal_economy/language/`. Supported locales: - `en-US` (English) — default - `vi-VN` (Vietnamese) - `ru-RU` (Russian) - `ko-KR` (Korean) To add a new language, create a new `.yml` file in the `language/` folder following the same key structure as `en-US.yml`, then set `locale` in `config.yml`.

UniversalEconomy

Quick Install (CLI)

UniversalEconomy