Overview#
The Dot Coin Mod is a robust economy and currency framework designed for Minecraft. It replaces or supplements the vanilla emerald-based trading system with a tiered coin system (Bronze, Silver, Gold, and Platinum). The mod is highly customizable, allowing server owners to define drop rates, conversion values, and even add custom coin types.
Key features include:
- Tiered Currency: Four base coin types with a decimal conversion system.
- Mob Loot: Coins drop from mobs based on their maximum health.
- Wallet GUI: A dedicated interface for managing your balance without taking up inventory space.
- Occupations: A job system where players earn coins by performing specific tasks like mining, hunting, or farming.
- Auto-Pickup: Coins are automatically deposited into the player's wallet upon pickup.
Currency System#
The mod uses a hierarchical currency system. By default, coins are uncraftable and must be earned through combat, exploration, or occupations.
Coin Tiers and Values
| Coin Type | Value (in Bronze) | Conversion Rate |
|---|---|---|
| Bronze Coin | 1 | Base Unit |
| Silver Coin | 100 | 100 Bronze = 1 Silver |
| Gold Coin | 10,000 | 100 Silver = 1 Gold |
| Platinum Coin | 1,000,000 | 100 Gold = 1 Platinum |
Conversion Mechanics
Players can manually convert coins in their inventory:
- Upgrade: Right-click a full stack (100) of coins to convert them into one coin of the next tier.
- Downgrade: Shift + Right-click a coin to break it down into 100 coins of the previous tier.
Occupations#
Occupations are a core mechanic that allows players to specialize in a 'job' to earn a steady income. To start an occupation, a player typically needs a specific License or Job Paper.
Available Jobs
- Hunter: Earns coins by defeating hostile and passive mobs. Higher-tier mobs (like Bosses) yield significantly more currency.
- Miner: Earns coins by breaking ore blocks. Rare ores like Diamond and Netherite provide Silver or Gold coins, while common ores like Coal provide Bronze.
- Farmer: Earns coins by harvesting fully grown crops (Wheat, Carrots, Potatoes, Beetroot).
- Fisherman: Earns coins every time a fish is successfully caught using a fishing rod.
- Lumberjack: Earns coins by chopping down logs. Different wood types can be configured to yield different amounts.
Earning Rates
Earning is scaled by the difficulty of the task. For example, a Miner might earn 1 Bronze for Coal but 5 Silver for a Diamond Ore. These rates are fully adjustable in the configuration files.
Items & Equipment#
Beyond the coins themselves, the mod adds several utility items for storage and management.
Money Bags
Money Bags are used to store large quantities of physical coins before they are deposited into a wallet or for players who prefer physical currency.
- Small Money Bag: Stores up to 9 stacks of Bronze coins.
- Medium Money Bag: Stores up to 18 stacks of Silver coins.
- Large Money Bag: Stores up to 27 stacks of Gold coins.
- Huge Money Bag: Stores up to 54 stacks of Platinum coins.
The Wallet
The Wallet is a virtual storage system. It can be accessed via a hotkey (default is often 'V' or 'B').
- Auto-Deposit: When enabled, any coin picked up goes directly into the wallet balance.
- GUI Features: The wallet screen shows your total balance in each coin tier and allows for quick withdrawal of physical coins.
Recipes#
While coins are generally found as loot, the storage items and licenses require crafting.
Crafting Money Bags
| Item | Recipe Components |
|---|---|
| Small Money Bag | 4 Leather + 1 String |
| Medium Money Bag | 1 Small Money Bag + 4 Leather + 1 Iron Ingot |
| Large Money Bag | 1 Medium Money Bag + 4 Leather + 1 Gold Ingot |
| Huge Money Bag | 1 Large Money Bag + 4 Leather + 1 Diamond |
Occupation Licenses
Licenses are crafted using a piece of Paper and a tool related to the profession:
- Hunter's License: Paper + Iron Sword
- Miner's License: Paper + Iron Pickaxe
- Farmer's License: Paper + Iron Hoe
- Fisherman's License: Paper + Fishing Rod
- Lumberjack's License: Paper + Iron Axe
Mechanics & Loot#
Mob Drops
Coins drop automatically when a mob is killed by a player. The amount is calculated based on the mob's health:
- Formula:
Amount = (Entity Max Health / 20) + Looting Level. - Modded Support: The mod automatically supports mobs from other mods as long as they extend the standard
LivingEntityclass.
Chest Loot
Coins can be found in vanilla structures such as:
- Dungeons
- Desert Temples
- End Cities
- Bastion Remnants
- Village Houses
Configuration
The mod generates a dotcoin-common.toml file. Admins can modify:
coinConversionOrder: Define the sequence of coin tiers.dropboostHealth: Adjust how much health correlates to higher coin tiers.walletEnabled: Toggle the virtual wallet system on or off.autoPickupDefault: Set whether coins go to the wallet by default.
Commands#
The mod includes several administrative and player commands for economy management:
/dotcoin balance: Displays the player's current wallet balance./dotcoin add <player> <amount>: Adds a specific amount of Bronze coins to a player's wallet (Admin only)./dotcoin set <player> <amount>: Sets a player's balance to a specific value (Admin only)./pay <player> <amount>: Transfers money from your wallet to another player's wallet./dotcoin reload: Reloads the configuration file to apply changes without restarting the server.
