Description
Gallery
Changelog
Versions
***
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
REQUIREMENTS
- SG Economy API (required since v1.1.0)
© 2025 Magic Coins Mod.
All Versions
+ Add Version
[1.1.1] Magic Coins 1.1.1
by SirGrantd on Feb 10, 2026
Download
# 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
### 🧩 GUI and Button Refactoring
### 🔄 Network Registration
### 📦 Dependencies
## Impact for Developers
## Compatibility
## Notes
This release is primarily technical and refactoring-focused. It is recommended for developers planning to extend the mod or maintain custom forks.
## 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:
ServerConfigSyncServerConfigSyncEvents- Server configuration is now synchronized:
- When the client loads
- When a player logs in
- Added **ClientSyncedConfig** to store synchronized values on the client side.
ServerConfignow automatically broadcasts configuration changes.MagicCoinsApinow 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
CustomButtonto 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.gradlefiles - 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
[1.1.0] Magic Coins 1.1.0
by SirGrantd on Jan 28, 2026
Download
# Magic Coins 1.1.0 — New Economic Architecture with SG Economy
Provides documented classes and methods for:
### :tools: Administrative Commands (Managed by SG Economy)
All economy-related commands are now fully managed by **SG Economy**, including:
### :skull_crossbones: Death Penalty
Death penalty is now a **native SG Economy feature**:
### :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:
## :rocket: Advantages of the New Architecture
Splitting the system into **two independent mods** provides several benefits:
## :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
Optional coin conversion buttons can be enabled via configuration.
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**:
## :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.
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:**
### :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**
- Coin Values**
- Inventory Interface**
Optional coin conversion buttons can be enabled via configuration.
- Prosperity Amulet**
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.
[1.0.9] Magic Coins 1.0.9
by SirGrantd on Aug 20, 2025
Download
# Magic Coins - Changelog v1.0.9
## ✨ New Features & Improvements
## 🛠 Bug Fixes
## 📌 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.
## ✨ New Features & Improvements
- Magnates Ranking**: added a leaderboard system showing the wealthiest players.
- Command Feedback**: all commands (
add,set,get) now return messages.
getis available to all players.addandsetrestricted 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](https://github.com/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.
[1.0.8] Magic Coins 1.0.8
by SirGrantd on Jul 24, 2025
Download
- Version 1.0.8**
- Fixed bugs.
- Corrected mistaken GitHub requests.
[1.0.7] Magic Coins 1.0.7
by SirGrantd on Jun 26, 2025
Download
## 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.
[1.0.6] Magic Coins 1.0.6
by SirGrantd on Apr 26, 2025
Download
## 📦 Update - Magic Coins
### 🛠️ Refactoring
### ✨ New Features
### 🎯 Loot Tables
Custom loot tables created for the following structures:
| Structure | Difficulty (1–5) |
| ------------------------- | ---------------- |
| abandoned_mineshaft | 3 |
| ancient_city | 5 |
| ancient_city_ice_box | 5 |
| bastion_bridge | 4 |
| bastion_hoglin_stable | 4 |
| bastion_other | 4 |
| bastion_treasure | 5 |
| buried_treasure | 1 |
| desert_pyramid | 2 |
| end_city_treasure | 4 |
| igloo_chest | 1 |
| jungle_temple | 2 |
| pillager_outpost | 3 |
| ruined_portal | 2 |
| shipwreck_supply | 1 |
| shipwreck_treasure | 2 |
| simple_dungeon | 2 |
| stronghold_corridor | 3 |
| stronghold_crossing | 3 |
| stronghold_library | 3 |
| underwater_ruin_big | 2 |
| underwater_ruin_small | 1 |
| woodland_mansion | 5 |
> ❌ *Note:* The
### 🐞 Bug Fixes
### ⚙️ Optimizations
### 🛠️ Refactoring
- Complete code refactor to improve maintainability and allow other developers to create add-ons more easily.
### ✨ New Features
- Added **percentage control of coins lost on death**.
- Added **toggle to enable/disable coin loot in vanilla chests**.
### 🎯 Loot Tables
Custom loot tables created for the following structures:
| Structure | Difficulty (1–5) |
| ------------------------- | ---------------- |
| abandoned_mineshaft | 3 |
| ancient_city | 5 |
| ancient_city_ice_box | 5 |
| bastion_bridge | 4 |
| bastion_hoglin_stable | 4 |
| bastion_other | 4 |
| bastion_treasure | 5 |
| buried_treasure | 1 |
| desert_pyramid | 2 |
| end_city_treasure | 4 |
| igloo_chest | 1 |
| jungle_temple | 2 |
| pillager_outpost | 3 |
| ruined_portal | 2 |
| shipwreck_supply | 1 |
| shipwreck_treasure | 2 |
| simple_dungeon | 2 |
| stronghold_corridor | 3 |
| stronghold_crossing | 3 |
| stronghold_library | 3 |
| underwater_ruin_big | 2 |
| underwater_ruin_small | 1 |
| woodland_mansion | 5 |
> ❌ *Note:* The
trial_chambers structure **will not generate coins**, as it is reserved for a different project.### 🐞 Bug Fixes
- Fixed **CuriosAPI version mismatch** issue.
### ⚙️ Optimizations
- General performance improvements and code organization.
[1.0.5] Magic Coins 1.0.5
by SirGrantd on Feb 22, 2025
Download
# **MagicCoins 1.0.5 - Performance Improvements & New Languages**
### 🆕 **What's New:**
💡 **Found an issue or have suggestions?** Join our Discord and share your feedback!
### 🆕 **What's New:**
- Code optimization** for better performance.
- Reduced unnecessary files** that were being downloaded without use.
- New languages added** for better accessibility.
💡 **Found an issue or have suggestions?** Join our Discord and share your feedback!
[1.0.4] Magic Coins 1.0.4
by SirGrantd on Feb 12, 2025
Download
# **MagicCoins 1.0.4 - Configurable GUI & New Buttons**
### 🆕 **What's New:**
### ⚠️ **Attention:**
💡 **Found an issue or have suggestions?** Join our Discord and share your feedback!
### 🆕 **What's New:**
- You can now adjust the position of interfaces (buttons and displays) using the **magic-coins-client.toml** file.
- Added 4 new buttons to the inventory for direct coin conversion. These buttons must be activated in the **magic-coins-client.toml** file.
### ⚠️ **Attention:**
- The direct conversion feature may cause **freezing** if the inventory gets full, as excess items will be dropped.
- Unidentified bugs** may occur, so use at your own risk.
💡 **Found an issue or have suggestions?** Join our Discord and share your feedback!
[1.0.3] Magic Coins 1.0.3
by SirGrantd on Feb 08, 2025
Download
# **MagicCoins 1.0.3 - Bug Fixes & Sound Effects**
### 🆕 **What's New:**
### 🛠️ **Improvements & Fixes:**
💡 **Found an issue or have suggestions?** Join our Discord and share your feedback!
### 🆕 **What's New:**
- Added sound effects when interacting with buttons.
- New sound effect when collecting coins through the inventory for better immersion.
### 🛠️ **Improvements & Fixes:**
- Bug fixes to improve stability and player experience.
💡 **Found an issue or have suggestions?** Join our Discord and share your feedback!
[1.0.2] Magic Coins 1.0.2
by SirGrantd on Feb 05, 2025
Download
### MagicCoins 1.0.2 - Customizable Values & API Improvements
#### What's New:
#### Improvements:
Feel free to report any issues or suggestions on our Discord!
#### What's New:
- You can now customize the coin value through the
magic_coins-common.tomlfile, allowing greater flexibility for modpacks and personal preferences.
#### Improvements:
- Adjusted the **API package** to make it easier for other mods to integrate and use **MagicCoins** methods more efficiently.
Feel free to report any issues or suggestions on our Discord!
[1.0.1] Magic Coins 1.0.1
by SirGrantd on Jan 26, 2025
Download
# Mod Updated to NeoForge
This mod has been updated to be compatible with the **NeoForge** version, ensuring better performance and compatibility with the new platform.
## What's New in This Update:
Feel free to report any issues or suggestions by contacting us on Discord!
This mod has been updated to be compatible with the **NeoForge** version, ensuring better performance and compatibility with the new platform.
## What's New in This Update:
- Added Commands**: New features via commands to enhance the user experience.
- Bug Fixes**: Minor issues have been resolved for improved stability and reliability.
Feel free to report any issues or suggestions by contacting us on Discord!
