Magic Coins 1.1.0 — New Economic Architecture with SG Economy

Provides documented classes and methods for:

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

:tools: 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.

:skull_crossbones: Death Penalty

Death penalty is now a native SG Economy feature:

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

:desktop: Display Interface

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

:gear: Configuration

Allows control over:

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

:rocket: 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.

:video_game: 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.

:question: 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

:pushpin: 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.