Download File

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