🚀 PrabhatSMPEssentials

⚡ The Ultimate Lightweight SMP Utility Plugin

Author: PrabhatPie
Minecraft Version: 1.21+
Platform: Paper / Spigot

---

🌟 Overview

PrabhatSMPEssentials is a high-performance, lightweight, and fully optimized SMP plugin that provides all essential SMP features in one powerful system.

Designed for modern Paper servers, it ensures:

• ⚡ Lag-free performance
• 🧩 Modular architecture
• 🔒 Secure systems
• 🎯 Smooth GUI experience

Perfect for both small SMPs and large community servers.

---

🔥 Features

🏠 Home System

• /sethome <name> – Set a home
• /home <name> – Teleport to home
• /delhome <name> – Delete a home

✔ Permission-based limits
✔ Player data storage (no database)
✔ Fast & efficient

---

🌍 Spawn System

• /setspawn – Set server spawn (Admin)
• /spawn – Teleport to spawn

✔ Saved in config.yml
✔ Instant teleport

---

🏙️ Hub System

• /sethub – Set hub (Admin)
• /hub – Teleport to hub

✔ Separate hub support

---

🛡️ Lobby Protection

• /setlobby – Set lobby world

🚫 Disabled in lobby:

• Block breaking / placing
• Item dropping / pickup
• Entity damage

✔ Admin bypass
✔ Safe lobby environment

---

🎲 Random Teleport (RTP)

• /rtp – Random safe teleport

✔ Avoids lava, water, caves
✔ Safe Y-level detection
✔ Async teleport (no lag)
✔ 60s cooldown

---

🔁 Teleport Request System

• /tpa <player>
• /tpahere <player>
• /tpaccept
• /tpdeny

✔ Auto-expire (60s)
✔ Cancel on logout
✔ Anti-spam protection

---

🔙 Back System

• /back – Return to last location

✔ Works after:

• RTP
• TPA
• Home
• Spawn / Hub
• Death

---

📦 GUI Menu System

• /menu – Open main menu

🧭 Menu (27 slots):

• Ender Pearl → RTP
• Player Head → TPA GUI
• Oak Door → Homes GUI
• Compass → Spawn
• Arrow → Back
• Nether Star → Hub
• Gold Ingot → Auction House
• Book → Server Info

✔ No item movement
✔ Anti-duplication protection

👥 TPA GUI

• Shows all online players
• Click to send TPA request

✔ Clean player-head interface

---

🏠 Homes GUI

• View all homes visually
• Set / delete homes

✔ Simple & user-friendly

---

💰 Auction House

• /ah – Open auction
• /ah sell <price> – List item
• /ah search <item> – Search

✔ GUI-based system
✔ Click to buy items
✔ Shows seller & price

📜 Example Lore:

• Seller: PlayerName
• Price: ₹500
• Click to purchase
  

---

📊 Auction Limits

Controlled via permissions:

• smpessentials.ah.limit.1
• smpessentials.ah.limit.3
• smpessentials.ah.limit.5
• smpessentials.ah.limit.10
• smpessentials.ah.limit.unlimited

---

⚙️ Configurable System

spawn:
  world: world
  x: 0
  y: 64
  z: 0

hub:
  world: world
  x: 100
  y: 70
  z: 50

lobby-world: lobby

rtp:
  cooldown: 60

auction-house:
  enabled: true
  listing-fee: 0
  default-limit: 1 

  ## 🔐 Permissions  

### 👑 Admin Permissions  
- `smpessentials.*` → Grants **all permissions**  
- `smpessentials.admin` → Full admin access  

### ⚙️ Admin Commands Permissions  
- `smpessentials.admin` → Access to:  
  - `/setspawn`  
  - `/sethub`  
  - `/setlobby`  

✔ Admins automatically bypass:  
- Teleport cooldowns  
- Lobby protection  
- Home limits  
- Auction limits  

---

### 🎮 Player Permissions  
- `smpessentials.spawn` → Use `/spawn`  
- `smpessentials.hub` → Use `/hub`  
- `smpessentials.rtp` → Use `/rtp`  
- `smpessentials.tpa` → Use `/tpa`, `/tpahere`, `/tpaccept`, `/tpdeny`  
- `smpessentials.home` → Use home commands  
- `smpessentials.back` → Use `/back`  
- `smpessentials.menu` → Open `/menu`  
- `smpessentials.ah` → Use auction house  

---

### 🏠 Home Limits Permissions  
- `smpessentials.home.1` → 1 home  
- `smpessentials.home.3` → 3 homes  
- `smpessentials.home.5` → 5 homes  
- `smpessentials.home.unlimited` → Unlimited homes  

---

### 💰 Auction Limits Permissions  
- `smpessentials.ah.limit.1` → 1 listing  
- `smpessentials.ah.limit.3` → 3 listings  
- `smpessentials.ah.limit.5` → 5 listings  
- `smpessentials.ah.limit.10` → 10 listings  
- `smpessentials.ah.limit.unlimited` → Unlimited listings  

---

## 🎯 Why Choose PrabhatSMPEssentials?  

### ⚡ 1. High Performance  
Built with **optimization in mind**, ensuring:  
- No lag spikes  
- Async processing (RTP)  
- Minimal resource usage  

---

### 🧩 2. All-in-One Plugin  
No need for multiple plugins — includes:  
- Homes  
- TPA  
- RTP  
- Spawn & Hub  
- GUI Menus  
- Auction House  

✔ Clean and unified system  

---

### 🎨 3. Modern GUI Experience  
- Fully interactive chest GUIs  
- Player-friendly navigation  
- No item movement or duplication  

---

### 🔒 4. Secure & Safe  
- Anti-duplication protection  
- Safe teleport checks  
- Lobby protection system  

---

### ⚙️ 5. Fully Configurable  
- Easy-to-edit `config.yml`  
- Enable/disable features  
- Custom limits and settings  

---

### 🚀 6. Lightweight & Modular  
- Designed for **maximum efficiency**  
- Works smoothly on **small and large servers**  
- Clean code structure  

---

### 👑 7. Admin Friendly  
- Simple permission system  
- One permission (`smpessentials.admin`) for full control  
- Automatic bypass system  

---

### ❤️ 8. Perfect for SMP Servers  
Whether you're running:  
- Private SMP  
- Public server  
- Survival community  

👉 This plugin gives you **everything essential without bloat**  

---

## 🏆 Final Words  
**PrabhatSMPEssentials** is the perfect balance of:  
✔ Power  
✔ Performance  
✔ Simplicity  

🔥 Upgrade your server with a **professional, lag-free SMP experience**!