🪙 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

{
  "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! 🪙