EmeraldEconLink 2: real currency system for Minecraft servers

EmeraldEconLink 2 turns emeralds into a real currency for Minecraft: full inventory sync with Vault, ATM signs, and multi-currency support for any server.

Download EmeraldEconLink

Original name: EmeraldEconLink

FileVersionLoaderSize
EmeraldEconLink.jar——6 КБDownload

EmeraldEconLink 2: Turn Emeralds into Real Currency in Minecraft

When a Minecraft server evolves from a simple sandbox into a thriving economic hub, every block and item begins to carry weight. Trade routes, banking systems, heists, and the slow accumulation of wealth transform the game from a purely creative outlet into a dynamic social simulation. The plugin EmeraldEconLink 2: Turn Emeralds into Real Currency in Minecraft is engineered precisely for this transformation. It acts as a sophisticated bridge between the physical items you hold—emeralds, gold ingots, diamonds—and the virtual balance tracked by your server's economy plugin through the Vault API. If an emerald slips from your inventory into a void, your account balance drops instantly. If you scoop up a fallen enemy's loot, your funds rise accordingly. The system is transparent, fair, and relentlessly synchronized.

Core Mechanics: How the Item-to-Balance Link Works

The underlying logic of EmeraldEconLink 2 is elegantly simple yet remarkably flexible. The plugin hooks directly into your chosen economy system—be it Essentials Economy, iConomy, or any other Vault-compatible solution—and monitors the movement of designated currency items. In the configuration file, you define which items are treated as money. By default, emeralds (item ID 388) serve as the primary currency, but you are free to add iron ingots, gold nuggets, diamonds, or even create a full multi-currency ecosystem. Each item is assigned a specific monetary value. When a player loses or gains a qualifying item, the plugin recalculates their virtual balance in real time.

This mechanic unlocks a treasure trove of gameplay possibilities, especially for PvP and roleplay servers. Imagine orchestrating a bank heist where the vault chests are packed with solid emerald blocks. Or consider the adrenaline spike of sprinting back to base with a full inventory of diamonds, knowing that a single misstep into lava will erase your hard-earned fortune. The plugin makes every item decision meaningful.

Feature Breakdown: What the Plugin Brings to Your Server

EmeraldEconLink 2 is not a one-trick pony. It comes packed with features designed to integrate seamlessly into a wide variety of server setups. Here is a detailed look at its capabilities:

  • Multi-Currency Support: Define multiple item types as legal tender, each with its own configurable exchange rate.
  • Full Vault Integration: Works with any Vault-compatible economy plugin, ensuring existing player balances remain intact.
  • Sign-Based ATMs: Create functional bank terminals using simple sign text. The [take] sign allows players to withdraw virtual funds as physical items. The [deposit] sign lets them convert items back into account credit. A [change] sign facilitates currency exchange between different item types.
  • Villager Trade Integration: Transactions with villager NPCs automatically adjust player balances, adding a layer of realism to trading halls.
  • Command Block and Give Compatibility: Works harmoniously with command blocks and item-giving plugins, including Creative mode scenarios.
  • Backpack and Shopkeepers Support: Pairs well with popular inventory and shopkeeper plugins for a cohesive economic experience.
  • Full Inventory Sync Mode: When enabled, the number of currency items in a player's inventory always mirrors their virtual balance, creating a perfect 1:1 representation.
  • Multi-World Support: Disable the plugin in specific worlds via the configuration, allowing for distinct economic zones.
  • Automatic Block Conversion: The plugin intelligently recognizes both ore blocks and ingots, correctly calculating their combined value without manual conversion.

Commands and Sign Management

All financial operations are channeled through the primary command /eel (with the alias /cash). This command gives players direct control over their funds:

  • /eel info — Displays the current exchange rates for all active currencies.
  • /eel take 100 — Withdraws 100 units of virtual currency as physical items.
  • /eel add 50 — Deposits 50 units worth of items from the inventory into the account.
  • /eel send 200 PlayerName — Transfers funds directly to another player.
  • /eel reload — Applies configuration changes without a full server restart.
  • /eel change — Swaps the currency type held in the player's hand.

However, the true magic of the plugin lies in its sign-based dispensers. To create a withdrawal ATM, place a sign and write [take] on the second line. A right-click adjusts the withdrawal amount, while a shift-right-click cycles through available currency types. A left-click dispenses the items. For deposits, use the [deposit] sign: a left-click deposits the item in your hand, while a right-click deposits all items of that type from your inventory. The [change] sign enables players to swap one currency for another, which is perfect for servers running both emeralds and diamonds with different values.

Configuration and Customization

The flexibility of the configuration file is one of the plugin's greatest strengths. In config.yml, you can define the itemsId and itemsCost lists to establish which items are currency and their respective values. The EnableItemOnEarnMoney parameter activates the full synchronization mode, ensuring a player's balance is always represented by physical items in their inventory. If you prefer a simpler system, oneItemOnEarnMoney forces the plugin to dispense only a single type of item rather than calculating an optimal combination.

The plugin also allows for fine-tuning of performance. The tiksPerChecksForEnableItemOnEarnMoney setting controls how often the plugin verifies balances (defaulting to 100 ticks, or 5 seconds). You can exclude specific worlds via DisabledWorlds, and the DisableChatMessage option suppresses chat notifications for a cleaner experience. Localization is fully customizable; while the default messages are in French, they can be easily translated to English or any other language.

Permissions and Security

Administrators have granular control over who can access which financial features. The permission nodes are structured to allow for precise delegation:

  • eel.info — View currency information.
  • eel.take and eel.add — Withdraw and deposit funds via commands.
  • eel.send — Transfer money to other players.
  • eel.change — Exchange currency types.
  • eel.dispenser.create.take, create.add, create.change — Permission to create the respective ATM signs.
  • eel.dispenser.take, dispenser.add, dispenser.change — Permission to use existing ATM signs.

Parent nodes like eel.* and eel.dispenser.* provide blanket access with a single flag. It is crucial to remember that the plugin requires both Vault and a functioning economy plugin to operate; without them, EmeraldEconLink 2 will not start.

Installation and Setup Guide

To get started, you will need to download EmeraldEconLink 2: Turn Emeralds into Real Currency in Minecraft from a trusted source. Ensure your server is running a compatible version of Minecraft and has Vault installed. The plugin is designed to work across several recent Minecraft versions and supports both Bukkit and Spigot server loaders. After placing the JAR file into your plugins folder, restart the server. The plugin will generate a default configuration file that you can edit to suit your server's economy. For a quick start, the default settings with emeralds as currency work out of the box.

For those seeking a streamlined setup, consider using a server launcher that offers one-click plugin installation. This can save time and reduce the risk of configuration errors. Once the plugin is active, you can begin creating ATM signs and defining your currency rules. The process for how to install is straightforward: drop the file, restart, and configure.

Conclusion: A Robust Economic Backbone

EmeraldEconLink 2: Turn Emeralds into Real Currency in Minecraft is more than a simple bridge between items and virtual accounts. It is a comprehensive toolkit for building a living, breathing economy within your server. Whether you are running a hardcore PvP server where bank robberies are a weekly event, or a cozy roleplay server with bustling market stalls and money changers, this plugin adapts to your vision. With its support for multiple currencies, intuitive sign-based ATMs, and granular permission controls, you can construct an economic system of any complexity without worrying about balance desynchronization. If you have ever wanted the emeralds in your chest to mean exactly as much as the numbers on your balance sheet, this plugin deserves a permanent spot in your server's modpack.