MagicCoins – Version 1.1.1

Overview

Version 1.1.1 of MagicCoins focuses on structural refactoring, improved server–client configuration synchronization, and simplification of networking and GUI button handling. There are no user-facing gameplay changes, but the codebase is now more organized, extensible, and reliable.

---

Main Changes

🌐 Networking and Synchronization

• Introduced MagicNetwork, a dedicated helper to centralize and standardize network registration.

• Migrated all message/packet registrations to use MagicNetwork.

• Added the SyncServerConfigS2C payload for synchronizing server configuration to clients.

• Introduced:

  • ServerConfigSync
  • ServerConfigSyncEvents

• Server configuration is now synchronized:

  • When the client loads
  • When a player logs in

• Added ClientSyncedConfig to store synchronized values on the client side.

• ServerConfig now automatically broadcasts configuration changes.

• MagicCoinsApi now reads client-synced values on the client, avoiding invalid server-side config access.

---

🧩 GUI and Button Refactoring

• Added the MagicCoinsButtonAction enum:

  • Centralizes packet creation and sending logic
  • Explicitly defines reusable button actions

• Updated CustomButton to support:

  • Left-click actions
  • Right-click actions

• Simplified HandlerButton:

  • Now only delegates execution to MagicCoinsButtonAction

• Removed redundant handlers and duplicated logic.

---

🔄 Network Registration

• Replaced individual packet registration calls with unified registration via MagicNetwork.
• Improves readability, maintainability, and reduces the risk of inconsistencies.

---

📦 Dependencies

• Updated sg_economy dependency:

  • Version bump in build.gradle files
  • Related import and formatting updates

---

Impact for Developers

• More modular and maintainable codebase.
• Single, consistent pattern for network communication.
• Foundation prepared for future client/server synchronization features.
• More flexible button system for extending GUI actions.

---

Compatibility

• Compatible with existing saves.
• No manual migration steps required.

---

Notes

This release is primarily technical and refactoring-focused. It is recommended for developers planning to extend the mod or maintain custom forks.

---

Version: 1.1.1

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.

Magic Coins - Changelog v1.0.9

✨ New Features & Improvements

• Magnates Ranking: added a leaderboard system showing the wealthiest players.

• Command Feedback: all commands (add, set, get) now return messages.

  • get is available to all players.
  • add and set restricted to admins.

• Coin Tooltip Values: each coin now displays its value directly in the tooltip.

• Prosperity Amulet:

  • When death-coin-loss is enabled, it prevents coin loss.
  • When death-coin-loss is disabled, it grants Regeneration I for 3s if the player is below 50% HP when hit.
  • Tooltip updated to show the current effect.

• Improved Mod Integration: fixes and adjustments to make the mod easier to integrate into modpacks and with other mods.

---

🛠 Bug Fixes

• Fixed ghost coins issue when joining servers.
• Fixed issue where shutting down the server caused the config file to fail loading, resulting again in ghost coins.
• Corrected texture sprite error with FTB Quests (fix contributed by MichaelHillcox).

---

📌 Notes

This update combines quality-of-life improvements, new features for gameplay depth, and critical bug fixes for multiplayer stability and mod compatibility.

---

© 2025 Magic Coins Mod.

Version 1.0.8

• Fixed bugs.
• Corrected mistaken GitHub requests.

Changelog 1.0.7

• Fixed bugs related to the display of money count.
• Balanced loot distribution in chests.
• Optimized the loot definition system for better performance and consistency.