Simple Coin Shops

# 🪙 Simple Coin Shops (Moto Coin) **A comprehensive shop and economy mod for Minecraft 1.21+ (Fabric)** Transform your server into a thriving economy with tradeable coins and player-owned shops! This mod provides a complete economic system with physical coins, upgradeable shops, and flexible admin tools. --- ## ✨ Key Features ### 💰 Coin System - **Moto Coins**: Official server currency as a physical item - Secure transactions between players - Withdraw coins from virtual balance - Leaderboard of the richest players ### 🏪 Player Shops - Create your own shops with Chest or Barrel - Up to **7 trade offers** per shop (upgradeable) - **Item storage** for automatic restocking - **Coin bank** for profit collection - Individual shop names - Upgrade system for more capacity ### 🛠️ Admin Shops - Unlimited resources (no storage needed) - Perfect for server currency and spawn traders - No upgrade system required ### 📊 Upgrade System - **Storage**: Expand storage and bank (3 levels: 3/4/6 rows) - **Offers**: Unlock more trade offers (up to 7) - **Multi-Buy**: More items per shift-click (3 levels) --- ## 🎨 Resource Pack The Mod has a Resource Pack installt so u can use the Moto Coin as a currency --- ## 📋 Commands ### For All Players #### Coin Management ``` /bal ``` Shows your current coin balance. ``` /baltop ``` Displays the top 10 richest players on the server. ``` /withdraw ``` Converts virtual coins into physical items (for trading). ``` /pay ``` Transfer coins to another player. #### Player Shop Management ``` /coinshop player create ``` Creates a new player shop at your position. - **chest**: Creates a chest shop - **barrel**: Creates a barrel shop - Default limit: 3 shops per player (configurable) ``` /coinshop player storage ``` Opens your shop's item storage. Here you can store items that will be sold automatically. ``` /coinshop player bank ``` Opens your shop's coin bank. This is where earned coins from sales are collected. ``` /coinshop list ``` Shows all your own shops with ID, position, and type. --- ### For Admins (OP Level 2+) #### Admin Shop Management ``` /coinshop admin create ``` Creates an admin shop with unlimited resources. ``` /coinshop admin storage ``` Opens an admin shop's storage (for information - admin shops don't need storage). ``` /coinshop admin bank ``` Opens an admin shop's bank (for information - admin shops don't collect coins). #### Coin Management ``` /setcoin ``` Defines the item in your hand as the Moto Coin template. All coins on the server will then have this appearance (CustomModelData, name, lore). #### Trader Conversion ``` /cointrader ``` Converts an existing villager into a coin trader. They will then accept Moto Coins instead of emeralds. #### Shop Overview ``` /coinshop list ``` As an admin, you see ALL shops on the server (players only see their own). --- ## 🎮 Shop Usage ### Creating and Setting Up a Shop 1. **Create shop**: Use `/coinshop player create chest` or `barrel` 2. **Open shop editor**: Right-click on the shop block with an **empty hand** 3. **Configure offers**: - **Top row**: Items you're selling - **Bottom row**: Price (Moto Coins or other items) - Place items directly into the slots 4. **Fill storage**: `/coinshop player storage ` - Add items that will be sold automatically 5. **Collect coins**: `/coinshop player bank ` - Retrieve your earned coins ### Shopping as a Customer 1. **Open shop**: **Shift + Right-click** on the shop block 2. **Buy items**: Click on an offer - Normal click: Buy 1x the offer - Shift + click: Buy multiple (depends on shop's Multi level) 3. Items and payment are automatically taken from your inventory ### Shop Upgrades In the shop editor, you'll find the "Shop Upgrades" button: - **Storage Upgrade**: - Level 1→2: 16 coins → 4 rows of storage/bank - Level 2→3: 32 coins → 6 rows of storage/bank - **Offer Upgrade**: - Unlocks additional trade slots - Costs: 16/32/64/96/128/160 coins (per slot) - Maximum: 7 offers - **Multi-Buy Upgrade**: - Level 1→2: 8 coins → more items per shift-click - Level 2→3: 16 coins → even more items per shift-click --- ## ⚙️ Configuration The mod automatically creates a configuration file: ``` config/moto-coin/config.json ``` ### Configurable Values ```json { "maxPlayerShopsPerPlayer": 3, "storageUpgradeCost": [16, 32], "offerUpgradeCost": [16, 32, 64, 96, 128, 160], "multiUpgradeCost": [8, 16] } ``` - **maxPlayerShopsPerPlayer**: Maximum number of shops per player - **storageUpgradeCost**: Costs for storage upgrades (Level 1→2, 2→3) - **offerUpgradeCost**: Costs for each additional offer slot - **multiUpgradeCost**: Costs for multi-buy upgrades (Level 1→2, 2→3) **Important**: Restart the server after making changes! --- ## 💾 Data Storage All data is automatically saved to: ``` config/moto-coin/data.json ``` Stored data includes: - Player balances - Shop positions and configurations - Item storage and coin banks - Upgrade status Data is automatically loaded on server start and saved on server stop. --- ## 🔧 Technical Details ### Requirements - **Minecraft**: 1.21.1 (tested and working) - **Loader**: Fabric - **Fabric API**: Required - **Fabric Language Kotlin**: Required - **Java**: 21+ ### Shop Limits - Maximum offers per shop: 7 - Maximum storage levels: 3 (27/36/54 slots) - Maximum multi-buy levels: 3 ### Permissions - Standard commands: All players - Admin commands: OP level 2 or higher - Shop owners can manage their own shops --- ## 🎯 Use Cases ### For Server Admins - Create central admin shops at spawn - Define a custom coin design with `/setcoin` - Set shop limits for balanced gameplay - Convert villagers to coin traders ### For Players - Build a shop empire (up to the configured limit) - Earn coins through trading - Upgrade your shops for more offers - Trade with other players via `/pay` ### For Roleplay Servers - Complete economic system - Physical currency for immersive gameplay - Individual shop names for themed stores - Admin shops as NPC traders --- ## 📝 Tips & Tricks 1. **Shop Placement**: Place shops in highly visible locations for more customers 2. **Storage Management**: Regularly refill storage for continuous availability 3. **Coin Pricing**: Research market prices with `/baltop` and `/coinshop list` 4. **Upgrades**: Prioritize storage upgrades for more storage capacity 5. **Multi-Buy**: Upgrade multi-buy for regular customers with large orders 6. **Shop Names**: Use creative names for better identification 7. **Admin Shops**: Use admin shops for important server resources --- ## 🐛 Support & Feedback For questions, bugs, or feature requests: - Contact me on Discord: **motofo20** - Share your experiences in the comments --- ## 📜 License This mod is released under the **CC0-1.0 License**. --- **Happy trading! 🪙**