Currencies - Integer-Based Economy Mod for Minecraft

Mastering Complex Economies with the Currencies Mod for Minecraft Running a Minecraft server often means more than just building and surviving. Many server owners want to introduce a thriving economy, but vanilla Minecraft offers no built-in currency system. That is where the Currencies mod steps...

Download Currencies for Minecraft 1.8

Original name: Currencies

Minecraft: 1.8

FileVersionLoaderSize
Currencies-1.0.0.jar1.8—43 КБDownload

Mastering Complex Economies with the Currencies Mod for Minecraft

Running a Minecraft server often means more than just building and surviving. Many server owners want to introduce a thriving economy, but vanilla Minecraft offers no built-in currency system. That is where the Currencies mod steps in, transforming your server into a fully-fledged economic simulation. Whether you dream of a simple dollar-based shop or a historically accurate pre-decimal British Pound with shillings and farthings, this mod gives you the tools to craft exactly the monetary system you need.

What is the Currencies Mod?

Currencies is a powerful server-side mod that allows you to create not just one, but multiple currencies, each with its own intricate subdivisions. Unlike many economy plugins that rely on floating-point numbers and can suffer from rounding errors, Currencies stores every player's balance as exact integers. This means your money is always precise, down to the smallest unit. You can define parent and child units with custom multipliers, enabling complex non-decimal systems that mirror real-world historical currencies. The mod also provides a comprehensive set of commands for players and administrators, making it easy to manage every aspect of your server's financial life.

Key Features at a Glance

  • Support for multiple independent currencies, each identified by a unique three-letter acronym.
  • Integer-based storage eliminates floating-point inaccuracies, ensuring perfect accounting.
  • Flexible unit hierarchy: define prime units, parent units, and child units with custom multipliers or divisors.
  • Seventeen built-in commands covering creation, transactions, balance checks, and administrative actions.
  • Reserved system accounts for tracking total currency in circulation and future automated features.
  • A developer-friendly API (CurrenciesCore) for integrating with shop plugins, quest systems, and more.

Getting Started: Installation and Setup

Adding Currencies to your server is straightforward. If you prefer a streamlined experience, the foxygame.net launcher provides a modern, flexible way to manage your Minecraft installations. From its intuitive menu, you can browse and download mods like Currencies directly, skipping the usual manual file placement. Once the mod is installed, you will need to create your first currency using the in-game commands. The process begins with defining the currency itself, then building its unit structure from the prime unit down to the smallest coin.

Commands Overview

The mod ships with seventeen commands, neatly divided into logical groups. All commands are accessible with the appropriate permissions, allowing server staff to delegate economic powers carefully.

Currency Creation Commands

  • /currencies create <name> [prefix] – Creates a new currency with a unique acronym. The optional prefix parameter controls whether the symbol appears before or after the amount.
  • /currencies addprime <name> <plural> <symbol> – Defines the central unit of the currency, such as “dollar” with symbol “$”.
  • /currencies addparent <name> <plural> <symbol> <multiplier> <child> – Adds a larger unit that consists of a certain number of a smaller child unit.
  • /currencies addchild <name> <plural> <symbol> <divisor> <parent> – Adds a smaller unit that is a fraction of a parent unit. Each unit can have only one direct child.

Account and Balance Commands

  • /openaccount <name> <owner> – Opens a non-player account for shops or automated systems.
  • /setdefault – Sets a player's default currency when multiple currencies share the same prime symbol.
  • /balance [player] [acronym] – Displays your own or another player's balance, optionally filtered by currency.

Transaction Commands

  • /pay <player> <amount> – Sends money directly to another player.
  • /bill <player> <amount> – Requests money from a player, creating a pending transaction.
  • /paybill [transaction] – Pays a specific bill you have received.
  • /rejectbill [transaction] – Rejects a pending bill.
  • /transactions [page|player] [page] – Views your transaction history or that of another player.

Administrative Commands

  • /credit <player> <amount> – Puts money into circulation by giving it to a player.
  • /debit <player> <amount> – Removes money from circulation, taking it from a player.
  • /bankrupt <player> [acronym] [amount] – Resets a player's balance, optionally for a single currency, and can credit a fresh start amount.

Creating Your Own Currency System

Designing a currency is where the mod truly shines. For a simple decimalized system like the United States Dollar, you would run:

/currencies create USD "United States Dollar"
/currencies addprime USD dollar dollars $
/currencies addchild USD cent cents . 100 $

Now imagine recreating the old British monetary system before decimalization. The following sequence builds a currency with pounds, shillings, pence, farthings, and even guineas and crowns:

/currencies create GBP "Great British Pound" false
/currencies addprime GBP pound pounds L
/currencies addchild GBP shilling shillings s 20 L
/currencies addchild GBP penny pence d 12 s
/currencies addchild GBP farthing farthings f 4 d
/currencies addparent GBP 'guinea' 'guinea' gu 21 s
/currencies addparent GBP crown crowns c 5 s
... and so on for florins, halfcrowns, sixpence, and more.

This flexibility lets you model almost any historical or fictional currency with perfect integer precision.

Using Currencies in Gameplay

Before players can earn or spend money, you must put currency into circulation. Use the /credit command to inject funds into the economy. For example, /credit NobleUplift 200L20hc17g gives a player 200 pounds, 20 halfcrowns, and 17 groats. If you need to remove money, /debit NobleUplift 0L20hc17g takes away the minor units while leaving the pounds untouched. Note that when debiting or crediting only sub-units, you must include the prime unit with a zero amount (like 0L) to identify the currency.

Player-to-player payments are just as seamless. /pay Shopkeeper 10L transfers funds, while /bill Customer $20 sends a payment request. The recipient can then use /paybill or /rejectbill with the transaction number from /transactions. The /bankrupt command is a powerful administrative tool that can reset a player's entire balance or just one currency, optionally leaving them with a specified amount.

API and Reserved Accounts

For plugin developers, Currencies exposes its core functionality through the CurrenciesCore API. This allows shop plugins, quest rewards, and other systems to interact with the economy programmatically. The mod also includes four reserved accounts that track the total money supply and prepare for future features: the Minecraft Central Bank receives bankrupted funds to keep them in circulation, while the Minecraft Central Banker records the total amount of each currency in existence. The Enderman Marker and Enderman Marketeer are planned counterparts for upcoming functionality. If you are building a shop plugin, using the credit and debit methods on the Central Bank account ensures infinite buying and selling capacity without unbalancing the economy.

Conclusion

The Currencies mod elevates Minecraft server economies from simple token exchanges to rich, multi-layered financial systems. Its integer-based architecture guarantees accuracy, while the extensive command set and API offer unmatched control. Whether you want a straightforward dollar economy or a labyrinthine pre-decimal masterpiece, this mod delivers the tools to make it happen. Dive in, experiment with your own currency designs, and watch your server's economic stories unfold.