GlobalShop

# GlobalShop - All-in-One Economy & Shop System

**GlobalShop** is a fully self-contained, zero-dependency economy, trading, and social system designed specifically for Minecraft Forge servers. Say goodbye to complex Vault setups and conflicting economy plugins. Throw this single .jar into your `mods` folder, and you instantly get a complete server ecosystem!

## ✨ Key Features

### 🛒 Global Player Market
- Right-click the Shop Block to open the GUI.
- Filter and search items by **Price, Time, or Seller**.
- Browse the global market to see what everyone is selling.
- Manage your own listings under the "My Items" tab.
- Easily list new items via the "List Item" interface.
- Real-time item info display (durability, enchantments, modded items fully supported).

### 🏪 Official Server Shop (OP Managed)
- **Infinite Stock**: OP-configured items can be bought unlimited times by players. No need to restock.
- **Daily Recycling Limit**: Selling items back to the server is limited to 128 items per player per day (resets based on real-world date). This prevents inflation.
- **Fully Configurable Pricing**: OPs can set separate buy and sell prices for each item.
- **Stack Size Control**: OPs can configure how many items players buy/sell in one transaction (e.g., 1, 16, 64).
- **Mode Switching**: OPs can set items to "Buy Only", "Sell Only", or "Buy & Sell".

### 🛡️ OP Management & Anti-Exploit
- **Blacklist GUI (OP only)**: Prevent specific items or entire mods (e.g., Create Big Cannons) from being listed or crafted.
- **Leaderboard**: View the richest players on the server in real-time.
- **Transaction Logs**: Players can view their own detailed trading history.

### 📬 Mailbox & Private Chat
- **Mailbox**: If a buyer's inventory is full, purchased items are automatically sent to their mailbox to prevent item loss. A dedicated button is integrated into the main GUI.
- **Private Chat & Trade**: Safe player-to-player trading and messaging interface. Supports offline messaging; players receive notifications upon login.

### 👑 VIP Subscription System
- Buy VIP with in-game currency using a 14-day real-time cycle.
- Supports **Auto-Renewal** (automatically deducts balance if sufficient).
- Top-left GUI indicator changes from "Normal" to "VIP" upon activation.

## 🛠️ Development Note (AI Disclosure)
This project is designed, validated, and rigorously tested by a solo human developer (a 17-year-old student). The code was written with the assistance of advanced AI models. All features, logic, balancing, and testing were guided, validated, and approved by the human author. AI was used to accelerate the coding process, not to replace human creativity and logic.

## 📦 Compatibility & Installation
- **Minecraft**: 1.20.1
- **Loader**: Forge (47.4.10 or equivalent)
- **Dependencies**: None (Zero dependencies, no Vault required).
- **Mod Compatibility**: Works flawlessly with all mods (Create, Mekanism, etc.) as it utilizes native ItemStack logic.

**Installation**:
1. Install Minecraft Forge 1.20.1 for your server and client.
2. Drop the `GlobalShop.jar` into the `mods` folder.
3. Restart the server. Enjoy!