# KartaEmeraldCurrency<\/p>\n
KartaEmeraldCurrency is a modern, high-performance economy plugin for PaperMC servers that uses the vanilla Emerald item as its core currency. It features a virtual bank system, interactive GUIs, and a powerful developer API, making it a versatile and stable choice for any server.<\/p>\n
Built to be efficient and safe, all database operations are handled asynchronously to prevent server lag.<\/p>\n
**Compatibility:** PaperMC 1.21 \u2013 1.21.8 (Java 21+)<\/p>\n
## Features<\/p>\n
– **Emerald-Based Economy:** Uses physical Emeralds for deposits and withdrawals.
\n– **Virtual Bank:** Securely store your emeralds in a virtual bank account, safe from inventory loss.
\n– **Interactive GUI:** A modern and easy-to-use GUI for all common actions, accessible via `\/emerald`.
\n – **Main Menu:** Shows a summary of your account balance.
\n – **Bank GUI:** A dedicated interface for depositing and withdrawing emeralds. You can deposit all emeralds from your inventory with one click, or deposit\/withdraw a custom amount by entering the value in chat.
\n– **Vault Integration:** Can act as the primary economy provider for any Vault-compatible plugin.
\n– **PlaceholderAPI Support:** A full set of placeholders to display economic data on scoreboards, chat, etc.
\n– **Developer API:** A clean, asynchronous API for other plugins to interact with the economy.
\n– **Async & Performant:** All database I\/O is asynchronous to ensure your server remains lag-free.
\n– **Configurable:** Almost every aspect, from fees to messages, can be customized.<\/p>\n
## Installation<\/p>\n
1. Download the latest release from the Releases page.
\n2. Place the `KartaEmeraldCurrency-x.x.x.jar` file into your server’s `\/plugins` directory.
\n3. Restart your server. The default configuration files will be generated in `\/plugins\/KartaEmeraldCurrency\/`.<\/p>\n
## Commands & Permissions<\/p>\n
### User Commands (`\/emerald` or `\/kec`)
\nThe primary way to interact with the economy is through the main GUI (`\/emerald`). While some direct commands may exist, the GUI provides access to all features, including the Bank, Transfers, and Leaderboards.<\/p>\n
| Command | Permission | Description | ### Admin Commands (`\/emeraldadmin` or `\/kecadmin`) | Command | Permission | Description | ## Placeholders<\/p>\n Requires PlaceholderAPI.<\/p>\n – `%kartaemerald_balance%` – Player’s total bank balance. **Note on custom placeholders:** In configuration files (`gui.yml`, `messages.yml`), you can use context-specific placeholders. These use the ` ## Developer API<\/p>\n KartaEmeraldCurrency provides a clean, easy-to-use API for developers. All data-related methods are asynchronous and return a `CompletableFuture`.<\/p>\n ### Accessing the API<\/p>\n First, get the service from Bukkit’s `ServicesManager`.<\/p>\n “`java public class MyPlugin { public void onEnable() { ### Example Usage: Paying a Player<\/p>\n “`java public void rewardPlayer(Player player, long amount) { Economy plugin for PaperMC servers that uses the vanilla Emerald item as its core currency<\/p>\n","protected":false},"featured_media":89650,"template":"","meta":{"_minecraft_slug":"karta-emeraldcurrency","_minecraft_project_id":"urAaWuRR","_minecraft_author":"MinekartaStudio","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":212,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"karta-emeraldcurrency.zip","_minecraft_size_bytes":8497747,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T12:33:59.950228Z","_minecraft_date_created":"2025-08-25T05:30:13.043547Z","_minecraft_date_modified":"2025-08-31T18:05:05.951654Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/karta-emeraldcurrency","_minecraft_icon_attachment_id":89650,"_minecraft_imported_at":"2026-06-05T02:54:02+00:00","_minecraft_import_hash":"6a8d704d03cc60d5e4adc5bd0ed04752","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,127,128,129,123,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-89649","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n|—|—|—|
\n| `\/emerald` | `kec.gui` | Opens the main interactive GUI. |
\n| `\/emerald balance` | `kec.balance` | Shows your current bank, wallet, and total balance. |
\n| `\/emerald pay
\n| `\/emerald deposit
\n| `\/emerald withdraw
\n| `\/emerald top` | `kec.top` | Shows the leaderboard of the richest players. |
\n| `\/emerald help` | `kec.help` | Displays a help message. |<\/p>\n
\nAll admin commands require the base permission `kec.admin` or granular permissions.<\/p>\n
\n|—|—|—|
\n| `\/kecadmin set
\n| `\/kecadmin add
\n| `\/kecadmin remove
\n| `\/kecadmin give
\n| `\/kecadmin take
\n| `\/kecadmin reload` | `kec.admin.reload` | Reloads the configuration files. |
\n| `\/kecadmin migrate
\n– `%kartaemerald_balance_formatted%` – Player’s bank balance, formatted with suffixes (e.g., 1.2k).
\n– `%kartaemerald_balance_comma%` – Player’s bank balance, formatted with commas (e.g., 1,234,567).
\n– `%kartaemerald_bank%` – An alias for `%kartaemerald_balance%`.
\n– `%kartaemerald_wallet%` – Player’s physical emerald count in their inventory.
\n– `%kartaemerald_top_<1-10>_name%` – **(Not yet implemented)** Name of the Nth player on the leaderboard.
\n– `%kartaemerald_top_<1-10>_amount%` – **(Not yet implemented)** Balance of the Nth player on a leaderboard.<\/p>\n
\nimport com.minekarta.kec.api.KartaEmeraldService;
\nimport org.bukkit.Bukkit;
\nimport org.bukkit.plugin.RegisteredServiceProvider;<\/p>\n
\n private KartaEmeraldService economyService;<\/p>\n
\n RegisteredServiceProvider
\n if (rsp != null) {
\n this.economyService = rsp.getProvider();
\n }
\n }
\n}
\n“`<\/p>\n
\nimport com.minekarta.kec.api.TransferReason;<\/p>\n
\n if (economyService != null) {
\n \/\/ Transfer from no one (server) by using a null UUID for the ‘from’ parameter is not supported.
\n \/\/ Instead, use the addBankBalance method for server-to-player transactions.
\n economyService.addBankBalance(player.getUniqueId(), amount).thenAccept(success -> {
\n if (success) {
\n player.sendMessage(“You have been rewarded ” + amount + ” emeralds!”);
\n }
\n });
\n }
\n}
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"