Описание
# 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 `
- **Remove Items**: `/coins shop remove `
- **List Items**: `/coins shop list [category]`
- **Reload Config**: `/coins shop reload` (applies changes without restart!)
- **Debug Tool**: `/coins debug ` (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:
```json
{
"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 - Add coins to player
/coins set - Set player's balance
/coins get - Check player's balance
```
#### Shop Management:
```
/coins shop add
- Add item to shop
/coins shop remove
- 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
- 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
```
## 🐛 Troubleshooting
### Shop is empty:
1. Check `config/currency_pouch_mod-shop.json` exists
2. Verify item IDs are correct
3. Use `/coins debug ` 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.