Magic Coins

!(https://raw.githubusercontent.com/G-Arantd/MagicCoins/refs/heads/main/.images/Banner-Site.png)

!(https://img.shields.io/badge/Latest_Version-v1. 1. 0-1BD96A?style=for-the-badge) [!(https://img.shields.io/badge/Discord-7389D8?style=for-the-badge&logo=discord&logoColor=ffffff)](https://discord.com/invite/nFAChmvTQz)

## 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

[!(https://raw.githubusercontent.com/G-Arantd/MagicCoins/refs/heads/main/.images/modpack/CreateChronicles.png)](https://www.curseforge.com/minecraft/modpacks/create-chronicles-the-endventure) [!(https://raw.githubusercontent.com/G-Arantd/MagicCoins/refs/heads/main/.images/modpack/FTBSkiesII.png)](https://www.curseforge.com/minecraft/modpacks/ftb-skies-2)

### REQUIREMENTS

SG Economy API (required since v1. 1. 0)

© 2025 Magic Coins Mod.