Currency Pouch Mod

A comprehensive economy system for Minecraft with coins, shops, and in-game management!

📋 Overview

Currency Pouch Mod adds a complete virtual currency system to Minecraft, allowing players to earn, store, and spend coins. The mod features a beautiful shop GUI, powerful admin commands, and full configuration support - all without requiring any external dependencies!

✨ Key Features

💰 Virtual Currency System

• Persistent Coin Storage: Each player has their own coin balance that persists across sessions
• Large Number Support: Uses long data type to support balances up to 9,223,372,036,854,775,807 coins
• Automatic Synchronization: Coins sync automatically when:
  • Joining the server
  • Respawning after death
  • Changing dimensions
  • Making purchases

🏪 Shop System

• Beautiful GUI: Modern, texture-free interface with gradient backgrounds and golden accents
• Category Organization: Items organized into customizable categories (Resources, Equipment, Food, Magic, etc.)
• Visual Feedback: Hover effects, animated buttons, and clear pricing display
• Balance Display: Real-time coin balance shown in both shop and inventory screens
• Smart Validation: Checks for sufficient coins and inventory space before purchase

🎮 In-Game Shop Management

Powerful commands to manage your shop without restarting the server:

• Add Items: /coins shop add <category> <itemId> <price> <name> <description>
• Remove Items: /coins shop remove <category> <itemId>
• List Items: /coins shop list [category]
• Reload Config: /coins shop reload (applies changes without restart!)
• Debug Tool: /coins debug <modid> (find item IDs from any mod)

⚙️ Configuration System

• JSON-based: Easy to edit configuration file
• Hot-reload: Changes apply without server restart
• Default Items: Comes with pre-configured shop items
• Mod Support: Works with items from any mod!

🎨 User Interface

• Inventory Display: Coin balance shown in player inventory with formatted numbers (1K, 1M, etc.)
• Shop Categories: Visual category icons with item counts
• Item Cards: Beautiful item display with icons, names, prices, and descriptions
• Responsive Design: Hover effects and click feedback

🛠️ Crafting Recipe

Shop Block

[Gold] [Emerald] [Gold]
[Diamond] [Chest] [Diamond]
[Iron Block] [Iron Block] [Iron Block]

For Server Admins:

1. Give yourself coins: /coins add @p 1000
2. Place a Shop Block in spawn
3. Customize shop items via commands or config file
4. Use /coins shop reload after making changes

📝 Configuration

The shop configuration is stored in config/currency_pouch_mod-shop.json

Example Configuration:

{
  "categories": [
    {
      "name": "Resources",
      "icon": "⛏",
      "items": [
        {
          "itemId": "minecraft:diamond",
          "price": 100,
          "name": "Diamond",
          "description": "Precious gem"
        }
      ]
    }
  ]
}

Adding Items from Other Mods:

1. Find the item ID: /coins debug modname
2. Add to shop: /coins shop add "Category" "modname:item" 100 "Name" "Description"
3. Reload: /coins shop reload

Important: Use quotes around item IDs with colons!

🎯 Use Cases

Survival Servers

• Create player-driven economies
• Reward players for completing tasks
• Set up spawn shops with essential items
• Balance progression with coin-based purchases

Mini-game Servers

• Award coins for winning games
• Create cosmetic shops
• Implement betting systems
• Track player wealth

RPG Servers

• Quest rewards in coins
• Town shops with regional items
• Player trading via coins
• Economic progression system

Creative Servers

• Reward building competitions
• Plot purchase systems
• Resource distribution control

🔧 Technical Details

Features:

• Capabilities System: Efficient player data storage
• Network Synchronization: Client-server coin sync
• NBT Persistence: Data survives server restarts
• Command System: Brigadier-based commands with permissions
• Event Handling: Automatic data copying on death/dimension change

Performance:

• Minimal server overhead
• Efficient NBT serialization
• Client-side rendering optimizations
• No external dependencies

📚 Command Reference

Player Commands:

None - all commands require OP level 2

Admin Commands:

Coin Management:

/coins add <player> <amount>     - Add coins to player
/coins set <player> <amount>     - Set player's balance
/coins get <player>              - Check player's balance

Shop Management:

/coins shop add <category> <itemId> <price> <name> <description>
  - Add item to shop
  
/coins shop remove <category> <itemId>
  - Remove item from shop
  
/coins shop list [category]
  - List all categories or items in category
  
/coins shop reload
  - Reload configuration without restart

Debug:

/coins debug <modid>
  - List all items from specified mod

🎨 Customization

Shop Categories:

• Create unlimited categories
• Custom icons (Unicode symbols)
• Organize items logically
• Visual category selection

Item Configuration:

• Set custom prices
• Add descriptions
• Use items from any mod
• Dynamic loading from config

Visual Customization:

• Color-coded UI elements
• Gradient backgrounds
• Golden accents for premium feel
• Responsive hover effects

🔒 Permissions

All commands require OP level 2 by default.

To grant permissions:

/op <player>

🐛 Troubleshooting

Shop is empty:

1. Check config/currency_pouch_mod-shop.json exists
2. Verify item IDs are correct
3. Use /coins debug <modid> to find correct IDs
4. Run /coins shop reload

Items not found:

• Ensure the mod is loaded
• Check item ID format: modname:itemname
• Use lowercase for mod IDs
• Use quotes around IDs with colons

Coins not saving:

• Verify server has write permissions to world folder
• Check logs for errors
• Ensure Forge version is compatible

Changes not applying:

• Run /coins shop reload after config changes
• Players must reopen shop to see updates
• Check logs for configuration errors

📖 Examples

Setting up a starter shop:

/coins shop add "Starter" "minecraft:wooden_sword" 10 "Wooden Sword" "Basic weapon"
/coins shop add "Starter" "minecraft:bread" 5 "Bread" "Restores hunger"
/coins shop add "Starter" "minecraft:torch" 1 "Torch" "Provides light"
/coins shop reload

Adding mod items (Mekanism example):

/coins debug mekanism
/coins shop add "Tech" "mekanism:ingot_osmium" 50 "Osmium Ingot" "Advanced material"
/coins shop add "Tech" "mekanism:energy_tablet" 100 "Energy Tablet" "Stores power"
/coins shop reload

Giving rewards:

/coins add @a[tag=winner] 1000
/coins add @p 500

🤝 Compatibility

Works with:

• ✅ All Forge mods (items can be added to shop)
• ✅ Multiplayer servers
• ✅ Single-player worlds
• ✅ Modpacks

Tested with:

• Mekanism
• Applied Energistics 2
• Tinkers' Construct
• Thermal Expansion
• And many more!

📜 License

This mod is provided as-is for Minecraft 1.19.2 with Forge.