What Is the GoldIsMoney Plugin?
GoldIsMoney transforms the way Minecraft servers handle economy by turning physical items into a fully functional currency system. Instead of storing digital numbers in a database, this plugin reads the amount of gold (or other chosen items) directly from a player’s inventory. It seamlessly integrates with Vault, allowing dozens of other plugins to charge, pay, or reward players using the items they actually carry. The result is an immersive, tangible economy that feels much more grounded in the survival world.
Core Mechanics: How Gold Becomes Money
At its heart, GoldIsMoney works by scanning a player’s inventory for a configured currency family — by default, gold nuggets, ingots, and blocks. The plugin automatically calculates the total value in a base unit (like nuggets) and reports that as the player’s balance. When a shop plugin requests a payment, GoldIsMoney deducts the appropriate number of items, converting larger denominations into smaller ones when needed. The reverse happens for deposits: items are added to the inventory, filling existing stacks or creating new ones intelligently.
One of the most clever aspects is offline support. When a player logs out, the plugin remembers their balance in a cache. This allows towny plots, faction upkeep, or rent systems to continue working even while the player is away. When they log back in, the cached balance syncs back to their physical inventory — items are removed or added to match what was spent or earned offline. It’s a hybrid system that feels like a real item economy without breaking compatibility with virtual-money plugins.
Key Features at a Glance
- Reads gold (or custom items) as currency directly from inventories.
- Full Vault integration for compatibility with hundreds of economy plugins.
- Offline transaction support using a cached balance that syncs on login.
- Configurable currency families: gold, emerald, diamond, iron, snow, clay, or fully custom items.
- Creative mode gold can be blocked via config to prevent abuse.
- Permissions node to allow or deny item-based currency per player or group.
- Bank and fake player account support (v2.0+) for deeper plugin compatibility.
- Lightweight and easy to set up — just drop the jar into the plugins folder.
Commands and Permissions
The plugin keeps things simple with a minimal command set. Players can check their balance with /balance, which displays their current gold value in the configured naming scheme. Server administrators have access to two additional commands in version 2.0 and above:
- /goldismoney test — runs a series of internal checks to verify that the plugin is functioning correctly, mainly for debugging.
- /goldismoney reload — reloads the configuration file without needing a full server restart.
The only permission node is goldismoney.use, which defaults to true for all players. Setting it to false for a group will prevent those players from using their inventory items as money, effectively locking them out of the item-based economy.
Installation and Vault Compatibility
Installing GoldIsMoney follows the standard Bukkit/Spigot plugin routine: place the GoldIsMoney.jar file into your server’s /plugins/ directory and restart. If you’re pairing it with Vault, make absolutely sure you’re using Vault version 1.2.19 or higher. Earlier versions contained a typo that prevented GoldIsMoney from loading correctly. Once both are in place, any Vault-compatible shop, reward, or region plugin will automatically treat a player’s gold as their balance.
For those managing a modded server or a custom modpack, keeping client-side mods in sync can be a hassle. One way to streamline that process is by using the foxygame.net launcher, a convenient, flexible, and modern Minecraft launcher that lets you download and install mods directly from its built-in menu, ensuring your players always have the right setup without manual file wrangling.
Configuration Deep Dive
The default config.yml gives you full control over the economy’s appearance and behavior. Here’s a breakdown of the most important settings:
Currency Names and Formatting
By default, the plugin uses the whimsical terms “gnugus” (singular) and “gnugi” (plural) — a contraction of “gold nugget” with a Latin twist. You can change these to anything you like. The format-singular and format-plural lines define how the balance is displayed, with %n representing the number of nuggets. For example, 1 gold block would show as “81 gnugi”.
Currency Family and Custom Items
The currency-family option can be set to gold, emerald, diamond, iron, snow, clay, or custom. When set to custom, you define item IDs and their values in the custom-currency map. For instance, dirt (ID 3) could be worth 1, while an ender dragon spawn egg (ID 383 with data 63) could be worth 25. The plugin will automatically handle conversions between these items, so be mindful of what you include — a player could pay with a mix of dirt and spawn eggs, and the plugin will try to make change accordingly.
Creative and Permission Controls
Setting allow-creative-gold to false prevents players in creative mode from using their infinite items as currency, closing a major exploit. Additionally, the goldismoney.use permission can be revoked to completely opt certain players out of the item economy, which is useful for admins or special roles.
Version 2.0+ Additions
With the 2.0 branch, two new toggles appear: allow-fake-players and allow-banks. These enable virtual representations for plugins that expect a standard economy API, like Factions or Towny. When both are set to true, GoldIsMoney behaves like any other economy plugin behind the scenes while still syncing physical items on login. Setting both to false reverts to the classic 1.x behavior, which some server owners prefer for its simplicity.
Why Choose an Item-Based Economy?
GoldIsMoney appeals to survival-focused servers that want to tie wealth directly to resource gathering. It removes the abstraction of virtual money and makes every transaction feel tangible. Players see their gold physically decrease when they buy something, and they can store their wealth in vaults or ender chests just like any other valuable block. The plugin also adds a layer of risk: dying with a full inventory of gold means losing your balance, which can lead to exciting gameplay dynamics.
At the same time, the offline cache system ensures that automated systems like rent, taxes, or shop chests keep working without punishing players for logging out. The deep Vault integration means you can use popular plugins like ChestShop, SignShop, or Jobs Reborn without any extra configuration — they all see GoldIsMoney as a normal economy.
Final Thoughts
GoldIsMoney bridges the gap between physical items and a modern economy API with remarkable elegance. It’s lightweight, highly configurable, and respects the vanilla survival loop. Whether you stick with gold, switch to emeralds, or build a bizarre custom currency from dragon eggs and dirt, the plugin adapts without complaint. Just remember to double-check your Vault version, tweak the config to match your server’s theme, and let your players experience an economy that feels like a natural part of the Minecraft world.