🛡️ UltimateSMP Lite — The All-in-One Flagship Survival Suite

The premier, zero-bloat survival utility engineered for modern Minecraft communities. UltimateSMP Lite consolidates over eight essential survival systems into an ultra-fast, multi-threaded engine targeting Paper, Purpur, Spigot, Bukkit, and native Folia.

Say goodbye to running 8 heavy, unmaintained plugins that cause GC pauses and TPS drops. UltimateSMP Lite delivers everything your players expect with sub-0.02ms MSPT footprint!

---

⚡ What Makes UltimateSMP Lite Different?

• 🌐 100% Native Folia & Paper Thread-Safe: Built on a unified region scheduler abstraction (GlobalRegionScheduler, RegionScheduler, EntityScheduler) ensuring zero cross-thread concurrency exceptions.
• ⏱️ Action Bar Teleportation HUD: Smooth, animated progress bar (Teleporting in 3s [■■■■□□□]) with subtle audio feedback—zero chat spam.
• 🤝 Scam-Free Dual-Side Trading GUI (/trade <player>): Two-stage safety locks, countdown confirmation, and automatic inventory drop protection.
• 🌲 Universal Tree Gravity Physics: Dynamic wood & leaf recognition supporting Pale Oak (1.21.4 / 26.x), Cherry, Mangrove, Bamboo, and Nether stems.
• 📊 PlaceholderAPI (PAPI) Sidebar: Customizable live scoreboard displaying playtime, kills, deaths, KDR, ping, and full PAPI soft-hooking.
• ⚔️ Team System & Friendly Fire: Built-in team management with custom tags, private team chat, and PvP toggling.
• 💀 PvP Player Head Trophies: Drop decapitated player skulls on kill with custom lore tracking the weapon, killer name, and kill timestamp.
• 🎒 Portable EnderChest & Homes GUI: Interactive menus for seamless player navigation.

---

🎮 Core Features Matrix

1. 🤝 Scam-Free Dual-Side Trade GUI (/trade)

• Interactive 54-slot dual trading interface with 16 offer slots per player.
• Both players must click Ready, triggering a synchronized 3-second countdown.
• Any item change or cancellation resets the countdown immediately to prevent last-second swap scams.
• Items are safely restored or dropped naturally at the player's feet if inventories are full.

2. ⏱️ Teleportation Suite with Action Bar HUD

• Homes: Interactive /homes GUI and /home <name> with configurable per-player limits and VIP bonuses.
• Warps GUI: Modern 54-slot server warps catalog (/warps) with custom icons and lore.
• TPA & /back: Full request verification (/tpa, /tpaccept, /tpdeny) and instant death/teleport return (/back).
• Visual Warmup: Real-time action-bar countdown with animated tick bars and move-cancellation detection.

3. 🌲 Universal Realistic Tree Gravity

• Break the bottom log of any tree to trigger smooth gravity physics for the remaining trunk.
• Automatically identifies natural trees using leaf-connectivity algorithms.
• Supports all vanilla and modern wood families: Oak, Birch, Spruce, Jungle, Acacia, Dark Oak, Mangrove, Cherry, Pale Oak, and Bamboo blocks.
• Fully rate-limited and region-scheduled to protect server tick rates.

4. ⚔️ Team Clans & Friendly Fire Control

• Create, manage, and recruit for survival teams (/team create <name>, /team invite <player>).
• Toggle friendly-fire PvP on or off (/team pvp) with instant visual status indicators.
• Dedicated team chat channel (/team chat <message>).

5. 📊 Dynamic Scoreboard & Playtime Tracking

• Lightweight sidebar displaying live stats: Kills, Deaths, KDR, Playtime, Active Team, Server Online Count, and AFK status.
• Full PlaceholderAPI integration: embed economy balances, rank prefixes, and custom server statistics.
• Idle AFK detection with auto-broadcast and playtime hour tracking.

---

📜 Commands & Permissions

Command	Description	Default Permission
/trade <player>	Send secure trade request	ultimatesmplite.trade
/home [name]	Teleport to a home or open homes GUI	ultimatesmplite.homes
/sethome <name>	Set a new home location	ultimatesmplite.homes
/delhome <name>	Delete an existing home	ultimatesmplite.homes
/warps	Open the interactive server warps menu	ultimatesmplite.warps
/warp [name]	Teleport to a specified server warp	ultimatesmplite.warp
/spawn	Teleport to server spawn point	ultimatesmplite.spawn
/tpa <player>	Send teleport request to a player	ultimatesmplite.tpa
/tpaccept	Accept incoming teleport request	ultimatesmplite.tpa
/tpdeny	Deny incoming teleport request	ultimatesmplite.tpa
/back	Return to previous location or death spot	ultimatesmplite.back
/afk	Toggle AFK status manually	ultimatesmplite.afk
/playtime [player]	View survival playtime and PvP stats	ultimatesmplite.playtime
/enderchest	Open personal portable EnderChest	ultimatesmplite.enderchest
/team <subcommand>	Manage team roster, chat, and PvP	ultimatesmplite.team
/usmplite reload	Reload configuration files (Admin)	ultimatesmp.admin

---

⚙️ Installation & Requirements

1. Download UltimateSMPLite-1.4.0.jar.
2. Drop it into your server's plugins/ directory.
3. Restart your server (no configuration required for out-of-the-box operation).
4. (Optional) Install PlaceholderAPI to enable third-party placeholder resolution on the scoreboard.

Supported Server Loaders: Paper, Purpur, Spigot, Bukkit, and Folia.
Java Version: Java 17 or higher.
Minecraft Versions: 1.16.5 up to 26.3+ (all releases).