Magic Coins 1.1.0 — New Economic Architecture with SG Economy

Version 1.1.0 of Magic Coins represents a major structural evolution of the mod.
The main goal of this update was to decouple the virtual economy from the physical item representation, making the system more modular, flexible, and compatible with different modpack and server designs.

Starting with this version, all economic logic — including balance storage, persistence, commands, and loss rules — is now handled exclusively by the SG Economy API.

🔄 Major Changes in Version 1.1.0

• Complete removal of Magic Coins’ internal economy system.
• Replacement of the internal coin bag, balance logic, and commands with the SG Economy API.
• Native support for decimal values in player balances.
• Updated and simplified configuration files.
• Refactored GUIs and event logic to directly consume the new API.
• Cleanup of obsolete files and updated build scripts to include the new dependency.

With this change, Magic Coins no longer manages economic data and now focuses solely on item-based gameplay features.

🧩 SG Economy — The New Economic Foundation

SG Economy is an independent Mod API designed to provide a modern, extensible, and reusable virtual economy system.
It can be used either standalone or integrated with other mods such as Magic Coins.

The economic system is based on a persistent numeric balance, directly associated with player data. This balance functions as a virtual wallet, without relying on physical in-game items.

✨ SG Economy Features

💰 Flexible Monetary System

Supports integer or decimal values, configurable via file.

🔧 Developer API

Provides documented classes and methods for:

• Querying and modifying player balances
• Native integration with other mods
• Creating custom economic systems

🛠️ Administrative Commands (Managed by SG Economy)

All economy-related commands are now fully managed by SG Economy, including:

• Balance query
• Add balance
• Set balance
• Remove balance (new command)
• Transfer balance between players (new command)

Note:
The remove balance and player-to-player transfer commands did not exist in Magic Coins 1.0.9 and were introduced with the adoption of the SG Economy API.

☠️ Death Penalty

Death penalty is now a native SG Economy feature:

• Default loss of 50% of the stored balance
• Fully configurable via configuration file

🖥️ Display Interface

Displays the player’s balance in the inventory and/or HUD in a configurable and visual way, always reflecting the persisted value.

⚙️ Configuration

Allows control over:

• Currency format
• Available commands
• Interface display options
• Balance retention rules

🚀 Advantages of the New Architecture

Splitting the system into two independent mods provides several benefits:

• Ability to use only the virtual wallet, without Magic Coins.
• Automatic compatibility with legacy data:
  • Players who had balances in modpacks using Magic Coins 1.0.9 will retain their balances when switching to SG Economy.
  • No migration scripts are required.
  • SG Economy was specifically adapted to recognize and preserve existing data.
• No need for extra scripts in modpacks that do not want item-based currencies.
• Easier maintenance, updates, and integration with other economy-related mods.

🎮 Current Role of Magic Coins

With the new architecture, Magic Coins is now focused exclusively on the RPG-style gameplay experience based on physical coins, while relying on SG Economy as its economic backbone.

Features Retained in Magic Coins

• Coin Generation
  Coins obtained from vanilla structure loot tables (configurable).

• Coin Values
  Each coin type has its own configurable value.

• Inventory Interface
  Dedicated buttons for depositing and withdrawing coins, with adjustable positions.
  Optional coin conversion buttons can be enabled via configuration.

• Prosperity Amulet
  An item that prevents coin loss on death.

Magic Coins no longer manages balances, commands, or economic rules. It only interacts with SG Economy to reflect values in gameplay.

❓ Frequently Asked Questions

Do I need to install two mods if I already use Magic Coins?

Yes. Starting with version 1.1.0, Magic Coins depends on SG Economy API to function.

What if I don’t want item-based currencies?

Use SG Economy API only.
This provides a fully virtual economy, similar to modpacks like FTB StoneBlock 4.

What if I want all features?

Use both mods together:

• SG Economy for balance management, commands, and persistence
• Magic Coins for physical coins, RPG-style interfaces, and special items

📌 Conclusion

Version 1.1.0 of Magic Coins establishes a cleaner, more modular, and scalable foundation by clearly separating economy logic from gameplay mechanics, preparing the mod for future growth within the Minecraft mod ecosystem.