MineCoin: Economy & Trade

# MineCoin: Economy, Commerce & Server Utilities

MineCoin is a comprehensive financial, commerce, and trading mod designed for singleplayer survival and multiplayer servers (SMP). It introduces a tiered physical currency system, automated player-owned vending machines with anti-theft security, global auction houses, eco-recycling mechanics, and animated interactive savings systems.

---

## Key Features

### 1. Physical Currency System
* **Copper Coin:** Base trading unit (Value: 1 credit).
* **Silver Coin:** Equivalent to 10 copper coins (Value: 10 credits).
* **Gold Coin:** High-denomination currency, worth 10 silver or 100 copper coins (Value: 100 credits).

### 2. Coin Purses & Wallets
* **Rustic Leather Pouch:** Entry-level 3-slot starter coin purse.
* **Themed Collectible Purses:** Over 10 custom designs (Frog, Miner, Polka Dot, Sunflower, and more) providing 9 dedicated slots exclusively for storing coins without cluttering your main inventory.

### 3. Player Vending Machines
* **Standard (1x2) & Large (3x2) Sizes:** Available in 5 distinct colors (Red, Blue, Green, Black, and Yellow).
* **Automated Offline Trading:** Players can sell goods for coins or specific items 24/7 without needing to be online.
* **Full Management GUI:** Intuitive interface to adjust prices, restock inventory, and withdraw accumulated earnings.
* **Anti-Theft Protection:** Only the machine's owner or authorized server operators can access the owner screen or dismantle the machine.
* **Admin Vending Mode:** Unbreakable variant with infinite stock designed for official server shops.
* **Survival Retrieval:** Can be harvested using a Stone Pickaxe or higher to safely relocate the machine without losing items.

### 4. Animated Piggy Bank (Daily Savings & Interest)
* **GeckoLib 3D Model & Animations:** Porcelain pig companion featuring idle breathing, ear twitches, and tail wagging.
* **4 Dynamic Fat Stages:** Visually grows and fattens as your savings increase (Baby, Chubby, Fat, and Chonky Tycoon).
* **Daily Passive Interest:** Generates 2% compound yield per in-game Minecraft day based on stored funds.
* **Upgrades:**
  * **Golden Fortune:** Doubles daily interest to 4%, equips the pig with a royal gold crown and trotters, and transmutes currency on cashout.
  * **Obsidian Plating:** Complete blast immunity and anti-theft security (only the owner can harvest the piggy bank).
* **Cashout Smashing:** Breaking the piggy bank triggers a ceramic shattering sound and showers the player with all saved coins, interest, intact upgrades, and clay shards.

### 5. Eco Recycling Machine
* **2-Block Tall Shredder:** Turn unwanted mob drops, worn tools, armor, and spare blocks into Eco-Points.
* **Coin Compaction:** Every 100 accumulated points compact into physical copper coins, with bonus chances for raw resources or scratch tickets.
* **Anti-Exploit System:** Features diminishing returns on bulk identical items to prevent infinite wealth loops.
* **Hopper Automation:** Fully compatible with hoppers (top/side input, bottom output).

### 6. Japanese Garapon Lottery Wheel
* Traditional rotating fair wheel with animated hand-crank physics and colored rolling balls.
* Fully configurable prize tables per color tier using the Master Key.
* Operates via craftable Garapon Tickets.

### 7. Global Auction Catalog & Scratch-Off Tickets
* **Auction Catalog:** Browse, bid, list, and buy items on a server-wide global marketplace from anywhere.
* **Scratch-Off Tickets:** Three tiers (Lucky 3, Gold Rush 6, and Diamond Royal 9) offering instant scratch minigames with coin rewards.

---

## Technical Details & Compatibility
* **Mod Loader:** NeoForge 1.21.1.
* **Required Dependency:** GeckoLib 4.
* **Multiplayer Ready:** Safe for dedicated servers. Seamlessly integrates with companion entertainment mods like MineBet.