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 <amount> ``` Converts virtual coins into physical items (for trading). ``` /pay <player> <amount> ``` Transfer coins to another player. #### Player Shop Management ``` /coinshop player create <chest|barrel> ``` 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 <ID> ``` Opens your shop's item storage. Here you can store items that will be sold automatically. ``` /coinshop player bank <ID> ``` 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 <chest|barrel> ``` Creates an admin shop with unlimited resources. ``` /coinshop admin storage <ID> ``` Opens an admin shop's storage (for information - admin shops don't need storage). ``` /coinshop admin bank <ID> ``` 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 <ID>` - Add items that will be sold automatically 5. **Collect coins**: `/coinshop player bank <ID>` - 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": , "offerUpgradeCost": , "multiUpgradeCost": } ``` - **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 i