Magic Coins

---

ABOUT

Magic Coins

Magic Coins introduces an RPG-style economy system to Minecraft while staying faithful to the vanilla experience.
The mod adds three types of physical coins, enabling player-to-player transactions and supporting trading, progression, and adventure-focused gameplay.

Starting with version 1.1.0, Magic Coins adopts a modular economic architecture by integrating with the SG Economy API, separating the virtual economy logic from item-based gameplay mechanics. This makes the mod more flexible, scalable, and compatible with modern modpacks.

Magic Coins can be used as:

• A standalone RPG coin system (with SG Economy as a dependency)
• A gameplay layer on top of a fully virtual economy

---

Prosperity Amulet

A magical artifact that prevents the loss of coins stored in the pouch upon death.
By default, players lose 50% of their stored balance when they die. With the amulet equipped, this penalty is completely negated.

Perfect for players who want to manage large amounts of currency without risking their wealth.

---

ECONOMY ARCHITECTURE (v1.1.0+)

Magic Coins now relies on SG Economy as its economic backbone.

SG Economy API

• Provides a persistent virtual wallet per player
• Supports integer and decimal balances
• Manages all economic commands and rules
• Fully configurable and reusable across mods and modpacks

This separation allows modpacks to:

• Use only a virtual economy (no item currencies)
• Or combine virtual balance + physical coins seamlessly

---

FEATURES

Coin Generation

Coins can be obtained from loot tables of vanilla structures.
(Can be disabled via configuration.)

Coin Values

Each coin type has its own configurable value.

Loss on Death

Loss on death is managed by SG Economy:

• Default loss of 50% of the player’s balance
• Fully configurable via config file

Inventory Interface

The inventory GUI includes:

• Buttons to deposit and withdraw coins
• Adjustable button positions
• Optional coin conversion buttons (disabled by default)

All interface options are configurable.

Administrative Commands

All economy-related commands are handled by SG Economy, including:

• Balance checks
• Add, set, and remove balance
• Player-to-player balance transfers

(Intended for server administrators.)

---

MODPACK USAGE

• ✅ Works with virtual-only economies (e.g. StoneBlock-style modpacks)
• ✅ Supports legacy balance compatibility from older Magic Coins versions
• ✅ No migration scripts required

---

MODPACKS USING MAGIC COINS

---

REQUIREMENTS

• SG Economy API (required since v1.1.0)

---

© 2025 Magic Coins Mod.