BetterVanilla SMP Plugin

# BetterVanilla ✨ SMP All-in-One A lightweight, drop-in plugin built for cozy SMP servers with friends. BetterVanilla adds modern quality-of-life upgrades to a vanilla Paper server - no client mods or loaders required. 👑 Core Feature: Configure every player and server toggle through the in-game `/settings` menu and (#settings) when you need the details. (https://img.shields.io/github/v/release/davidstoegmueller/bettervanilla?style=flat-round)](https://github.com/davidstoegmueller/bettervanilla/releases) Tested on Paper 26.2 and newer. ## Table of Contents - (#why-bettervanilla) - (#highlights) - (#installation) - (#commands) - (#settings) - (#permissions) - (#contributing) ## Why BetterVanilla? Your SMP deserves more than plain vanilla. BetterVanilla keeps the familiar Minecraft feel while adding carefully scoped tools that reduce admin busywork and smooth out day-to-day play. Everything ships in one polished plugin you can drop in and go. ## Highlights ### Player-Focused Features - 🧭 **Waypoints** - Add, share, and filter public or private waypoints with visibility cycling, GUI navigation, optional particle trails, direct cancellation, coordinate updates, plus auto-cancel and reach-radius controls. - 🎒 **Backpacks** - Carry expandable storage with configurable rows and pages. Right-click outside an open backpack to sort its current page with your preferred sort mode; open backpacks are saved safely when you die. - ⛏️ **Vein Miner & Tree Chopper** - Sneak-break to harvest entire ore veins or tree trunks instantly, including support for copper tools and stripped logs. - 💀 **Death Points & Chests** - Track every death, teleport back, and safely reclaim your belongings from a chest placed in the nearest safe air or fluid block without overwriting terrain. - 🧠 **Heads Explorer** - Browse decorative heads by category, search a category or the entire catalog instantly, and preview icons in the GUI. - ✨ **Chest Sorting** - Right-click outside inventories to auto-organize loot with selectable sort modes. - 🔁 **Item Restock Automation** - Automatically refill empty hotbar slots with matching items using global and per-player toggles. - 🏷️ **Player Tags** - Set a custom name tag from the settings menu, including color selection. - 🧰 **Settings Menu** - Toggle personal QoL options and select English or German in an in-game UI. - 🎨 **Colored Chat & Mentions** - Use `&` color codes and ping friends with `@name`. - 📬 **Private Messages** - Chat directly with `/msg` and reply quickly using `/r`. - 🪧 **Sign Colors** - Decorate signs with vibrant color codes. - 👀 **Inventory Viewer** - Peek inside another player’s inventory when permitted. - ⏱️ **Timer** - Global stopwatch with resume, pause, reset, and set commands. - 🕒 **Playtime** - View detailed play history, current AFK duration, and last-seen information for yourself or other players. - 📶 **Ping** - Check personal or remote player latency. - 📍 **Here/Coords Broadcast** - Share your current location with `/here` (alias `/coords`); recipients can click the message to start waypoint navigation. - 📊 **Dynamic Tab List** - Live header/footer shows day/time, moon phase, weather, online counts, personal playtime, ping, TPS, and MSPT, while nameplates add AFK tags, death totals, and respect vanish. - 📍 **Action-Bar Location** - Display live XYZ coordinates in your HUD. - 🧭 **Bossbar Compass** - Minimal directional overlay in the boss bar. - 🪑 **Sittable Stairs** - Sit on stairs with an empty hand. - 🪑 **Sit Anywhere** - Use `/sit` to plop down on any solid block and stand with Shift. - 🌧️ **Sleep to Clear Weather** - Skip rain and fast-forward the day by sleeping. - 🧚 **Navigation Particles** - Follow a beam and optional trail during waypoint navigation. - 🌾 **Crop Protection** - Prevent farmland trampling. - 🌱 **Right-Click Harvest** - Harvest and replant crops with a single interaction, controlled by global and per-player toggles. - 🚪 **Double Door Sync** - Sync state across connected double doors. - 📖 **Help** - Built-in `/help` overview of every command. ### Admin & Server Tools - 🛠️ **Admin Settings Menu** - Configure every feature live from the GUI, including the default English or German server language. - 🗝️ **Permissions System** - Manage groups and users with hot-reload via `/permissions`. - 💤 **AFK Protection** - Shield idle players from damage, movement, and collisions. - 🧭 **Waypoint Management** - Review and edit public/private waypoints with dedicated staff tools. - 🫥 **Vanish Mode** - Hide from players, tab lists, join/leave messages, the server list, and AFK timers with `/vanish`. - ⚰️ **Deathchest Toggle** - Switch global deathchests on or off without leaving the GUI. - 🔨 **Moderation Toolkit** - Kick, ban, mute, unmute, and unban directly in-game. - 🧩 **Crafting