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:

Give yourself coins: /coins add @p 1000
Place a Shop Block in spawn
Customize shop items via commands or config file
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:

Find the item ID: /coins debug modname
Add to shop: /coins shop add "Category" "modname:item" 100 "Name" "Description"
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:

Check config/currency_pouch_mod-shop.json exists
Verify item IDs are correct
Use /coins debug <modid> to find correct IDs
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.