# BetterVanilla \u2728 SMP All-in-One<\/p>\n
A lightweight, drop-in plugin built for cozy SMP servers with friends. BetterVanilla adds modern quality-of-life upgrades to a vanilla Paper server\u2014no client mods or loaders required.<\/p>\n
\ud83d\udc51 Core Feature: Configure every player and server toggle through the in-game `\/settings` menu and [jump straight to the full settings guide](#settings) when you need the details.<\/p>\n
\n<\/p>\n
Tested on Paper 1.21.11 and newer.<\/p>\n
## Table of Contents<\/p>\n
– [Why BetterVanilla?](#why-bettervanilla)
\n– [Highlights](#highlights)
\n– [Installation](#installation)
\n– [Commands](#commands)
\n– [Settings](#settings)
\n– [Permissions](#permissions)
\n– [Contributing](#contributing)
\n– [License](#license)<\/p>\n
## Why BetterVanilla?<\/p>\n
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.<\/p>\n
## Highlights<\/p>\n
### Player-Focused Features<\/p>\n
– \ud83e\udded **Waypoints** – Add, share, and filter public or private waypoints with visibility cycling, GUI navigation, optional particle trails, plus auto-cancel and reach-radius controls.
\n– \ud83c\udf92 **Backpacks** – Carry expandable storage with configurable rows and pages.
\n– \u26cf\ufe0f **Vein Miner & Tree Chopper** – Sneak-break to harvest entire ore veins or tree trunks instantly.
\n– \ud83d\udc80 **Death Points & Chests** – Track every death, teleport back, and safely reclaim your belongings.
\n– \ud83e\udde0 **Heads Explorer** – Browse decorative heads by category, search instantly, and preview icons in the GUI.
\n– \u2728 **Chest Sorting** – Right-click outside inventories to auto-organize loot with selectable sort modes.
\n– \ud83d\udd01 **Item Restock Automation** – Automatically refill empty hotbar slots with matching items using global and per-player toggles.
\n– \ud83c\udff7\ufe0f **Player Tags** – Set a custom name tag from the settings menu, including color selection.
\n– \ud83e\uddf0 **Settings Menu** – Toggle personal QoL options in an in-game UI.
\n– \ud83c\udfa8 **Colored Chat & Mentions** – Use `&` color codes and ping friends with `@name`.
\n– \ud83d\udcec **Private Messages** – Chat directly with `\/msg` and reply quickly using `\/r`.
\n– \ud83e\udea7 **Sign Colors** – Decorate signs with vibrant color codes.
\n– \ud83d\udc40 **Inventory Viewer** – Peek inside another player\u2019s inventory when permitted.
\n– \u23f1\ufe0f **Timer** – Global stopwatch with resume, pause, reset, and set commands.
\n– \ud83d\udd52 **Playtime** – View detailed play history with AFK tracking for yourself or other players.
\n– \ud83d\udcf6 **Ping** – Check personal or remote player latency.
\n– \ud83d\udccd **Here\/Coords Broadcast** – Share your current location with `\/here` (alias `\/coords`).
\n– \ud83d\udcca **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.
\n– \ud83d\udccd **Action-Bar Location** – Display live XYZ coordinates in your HUD.
\n– \ud83e\udded **Bossbar Compass** – Minimal directional overlay in the boss bar.
\n– \ud83e\ude91 **Sittable Stairs** – Sit on stairs with an empty hand.
\n– \ud83e\ude91 **Sit Anywhere** – Use `\/sit` to plop down on any solid block and stand with Shift.
\n– \ud83c\udf27\ufe0f **Sleep to Clear Weather** – Skip rain and fast-forward the day by sleeping.
\n– \ud83e\uddda **Navigation Particles** – Follow a beam and optional trail during waypoint navigation.
\n– \ud83c\udf3e **Crop Protection** – Prevent farmland trampling.
\n– \ud83c\udf31 **Right-Click Harvest** – Harvest and replant crops with a single interaction.
\n– \ud83d\udeaa **Double Door Sync** – Sync state across connected double doors.
\n– \ud83d\udcd6 **Help** – Built-in `\/help` overview of every command.<\/p>\n
### Admin & Server Tools<\/p>\n
– \ud83d\udee0\ufe0f **Admin Settings Menu** – Configure every feature live from the GUI.
\n– \ud83d\udddd\ufe0f **Permissions System** – Manage groups and users with hot-reload via `\/permissions`.
\n– \ud83d\udca4 **AFK Protection** – Shield idle players from damage, movement, and collisions.
\n– \ud83e\udded **Waypoint Management** – Review and edit public\/private waypoints with dedicated staff tools.
\n– \ud83e\udee5 **Vanish Mode** – Hide from players, tab lists, join\/leave messages, the server list, and AFK timers with `\/vanish`.
\n– \u26b0\ufe0f **Deathchest Toggle** – Switch global deathchests on or off without leaving the GUI.
\n– \ud83d\udd28 **Moderation Toolkit** – Kick, ban, mute, unmute, and unban directly in-game.
\n– \ud83e\udde9 **Crafting Recipe Manager** – Manage predefined crafting recipes.
\n– \ud83e\udde0 **Heads Explorer Controls** – Enable\/disable the explorer, set the API key, and refresh cached data.
\n– \ud83d\udce3 **Server MOTD** – Edit the server list message from the admin menu.
\n– \ud83e\udded **Locator Bar Gamerule** – Flip the `\/gamerule locatorBar` setting across every world without leaving the GUI.
\n– \ud83d\udecc **Sleeping Percentage** – Set the `playersSleepingPercentage` gamerule from the admin menu.
\n– \ud83d\udea7 **Maintenance Mode** – Toggle server access with custom messaging and bypass support.
\n– \ud83e\uddfe **Recipe Sync Toggle** – Control whether custom recipes are synced to players.
\n– \ud83e\uddf0 **Remote Settings Access** – Admins can open player settings menus for other online players.<\/p>\n
### Custom Crafting Recipes<\/p>\n
#### \ud83d\udca1 **Invisible Light Source**<\/p>\n
Craft an invisible light block that emits light at level 15.<\/p>\n
##### \ud83e\uddfe Default Recipe<\/p>\n
| Slot 1 | Slot 2 | Slot 3 |
\n| —— | ——— | —— |
\n| empty | torch | empty |
\n| torch | glowstone | torch |
\n| empty | torch | empty |<\/p>\n
#### \ud83d\uddbc\ufe0f **Invisible Item Frame**<\/p>\n
Craft an invisible item frame that becomes invisible once an item is placed inside.<\/p>\n
##### \ud83e\uddfe Default Recipe<\/p>\n
| Slot 1 | Slot 2 | Slot 3 |
\n| —— | ———- | —— |
\n| glass | glass | glass |
\n| glass | item frame | glass |
\n| glass | glass | glass |<\/p>\n
## Installation<\/p>\n
“`
\n1. Download the latest BetterVanilla release jar.
\n2. Drop it into your server’s plugins\/ folder.
\n3. Restart the server and you are ready to go!
\n“`<\/p>\n
## Commands<\/p>\n
### Core Command<\/p>\n
– `\/settings` – Open your personal settings dashboard. Admins can enter the full server control panel from here, making it the fastest way to tweak any BetterVanilla feature. [See everything it unlocks](#settings).<\/p>\n
### Player Utilities<\/p>\n
– `\/settings` – Open the settings GUI for players. ### Admin & Moderation<\/p>\n – `\/adminhelp` – List key staff commands. ## Settings<\/p>\n ### Player Settings<\/p>\n – \ud83d\udccd Action-bar location HUD ### Admin Settings<\/p>\n – \ud83d\udea7 Maintenance mode and custom message ## Minecraft Heads Explorer<\/p>\n This plugin now features a built-in Minecraft Heads Explorer, powered by <\/p>\n ## Permissions<\/p>\n ### Built-in Groups<\/p>\n – `player` – default fallback that grants all player-facing QoL features such as `\/settings`, waypoints, backpacks, and automation toggles. | Permission | Included in | ## Contributing<\/p>\n Pull requests are welcome! If you find a bug or have an idea, open an issue with reproduction steps, logs, or screenshots so we can help quickly.<\/p>\n ## License<\/p>\n Distributed under the [MIT License](LICENSE).<\/p>\n","protected":false},"excerpt":{"rendered":" A lightweight, drop\u2011in plugin made for cozy survival multiplayer (smp) servers with friends. Upgrade vanilla with modern quality\u2011of\u2011life features – no mods, just pure fun.<\/p>\n","protected":false},"featured_media":30439,"template":"","meta":{"_minecraft_slug":"bettervanilla-smp","_minecraft_project_id":"8lHXeqdO","_minecraft_author":"daveestar","_minecraft_license":"MIT","_minecraft_downloads":1203,"_minecraft_follows":15,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bettervanilla-smp.zip","_minecraft_size_bytes":3900730,"_minecraft_version_count":16,"_minecraft_updated_at":"2026-05-16T08:02:16.673274Z","_minecraft_date_created":"2025-02-05T23:53:17.213396Z","_minecraft_date_modified":"2026-01-31T14:33:58.145398Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bettervanilla-smp","_minecraft_icon_attachment_id":30439,"_minecraft_imported_at":"2026-06-01T12:57:10+00:00","_minecraft_import_hash":"20e76c0a4e4112009034ef909dec482d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,126,90,127,128,91,123,92],"mod_loader":[132,133],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-30438","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/waypoints` – Open the waypoint GUI. Use `player
\n– `\/backpack` – Open your personal backpack storage.
\n– `\/deathpoints` – Manage recent death locations and teleport back via GUI.
\n– `\/heads` – Open the heads explorer GUI.
\n– `\/playtime [player]` – Show detailed playtime (AFK included) for you or another player.
\n– `\/ping [player]` – Check network latency for yourself or another player.
\n– `\/sit` – Sit on any solid block; sneak to stand up.
\n– `\/msg
\n– `\/r
\n– `\/here` – Broadcast your current location. Aliases: `\/coords`, `\/h`.
\n– `\/help` – View all available commands pulled directly from `plugin.yml`.<\/p>\n
\n– `\/settings` – Open the settings GUI for players and admins.
\n– `\/invsee
\n– `\/timer
\n– `\/vanish` – Toggle vanish mode with movement safeguards.
\n– `\/kick`, `\/ban`, `\/unban`, `\/mute`, `\/unmute` – Moderation toolset with duration parsing (e.g. `1d2h30m`).
\n– `\/permissions` – Manage groups and assignments:
\n – `group addperm
\n – `group removeperm
\n – `group delete
\n – `user addperm
\n – `user removeperm
\n – `user setgroup
\n – `default
\n – `assignments` – Show current group and user mapping
\n – `list` – Display built-in permission nodes
\n – `reload` – Reload configuration and refresh online players<\/p>\n
\n– \ud83e\udded Bossbar compass overlay
\n– \ud83c\udff7\ufe0f Player tag (name tag color + text)
\n– \u23f2\ufe0f Action-bar timer overlay toggle
\n– \u2728 Navigation particles
\n– \ud83e\udded Navigation auto-cancel
\n– \ud83d\udccf Navigation reach radius
\n– \ud83e\uddf9 Chest sorting toggle
\n– \ud83e\uddfa Inventory sort mode
\n– \ud83d\udc41\ufe0f Waypoint visibility filter
\n– \ud83d\udd01 Item restock automation toggle
\n– \ud83d\udeaa Double Door Sync
\n– \u26cf\ufe0f Vein miner toggle with per-player limits
\n– \ud83e\ude93 Vein chopper toggle with per-player limits<\/p>\n
\n– \ud83d\udca3 Creeper explosion protection toggle (blocks + entities)
\n– \ud83d\udd2d End travel toggle
\n– \ud83d\udd25 Nether travel toggle
\n– \ud83c\udf27\ufe0f Sleeping rain skip
\n– \ud83d\udecc Players sleeping percentage gamerule
\n– \ud83d\udce3 Server MOTD editor
\n– \ud83e\udded Locator bar gamerule toggle
\n– \ud83d\udca4 AFK protection toggle and AFK timeout
\n– \ud83c\udff7\ufe0f Player tags global toggle
\n– \u26b0\ufe0f Deathchest toggle
\n– \ud83d\udd01 Item restock automation defaults and global toggle
\n– \ud83c\udf3e Crop protection
\n– \ud83c\udf31 Right-click harvest
\n– \ud83c\udf92 Backpack availability, page count, and row count
\n– \u26cf\ufe0f Vein miner global options (limits, tools, blocks, sound)
\n– \ud83e\ude93 Vein chopper global options
\n– \ud83e\udde0 Heads explorer (enable, API key, refresh)
\n– \ud83e\uddfe Recipe sync toggle<\/p>\n
\nMinecraft-Heads.<\/p>\n
\n– `moderator` – inherits the player group and adds moderation, vanish, inventory viewing, and timer controls.
\n– `admin` – includes every BetterVanilla permission, covering server maintenance, admin settings, and permission management.
\n– Use `\/permissions default
\n| ———————————- | ———————— |
\n| `bettervanilla.settings` | player, moderator, admin |
\n| `bettervanilla.playtime` | player, moderator, admin |
\n| `bettervanilla.waypoints` | player, moderator, admin |
\n| `bettervanilla.here` | player, moderator, admin |
\n| `bettervanilla.deathpoints` | player, moderator, admin |
\n| `bettervanilla.ping` | player, moderator, admin |
\n| `bettervanilla.sit` | player, moderator, admin |
\n| `bettervanilla.backpack` | player, moderator, admin |
\n| `bettervanilla.heads` | player, moderator, admin |
\n| `bettervanilla.msg` | player, moderator, admin |
\n| `bettervanilla.togglelocation` | player, moderator, admin |
\n| `bettervanilla.togglecompass` | player, moderator, admin |
\n| `bettervanilla.actionbartimer` | player, moderator, admin |
\n| `bettervanilla.chestsort` | player, moderator, admin |
\n| `bettervanilla.doubledoor` | player, moderator, admin |
\n| `bettervanilla.veinminer` | player, moderator, admin |
\n| `bettervanilla.veinchopper` | player, moderator, admin |
\n| `bettervanilla.itemrestock` | player, moderator, admin |
\n| `bettervanilla.tag` | player, moderator, admin |
\n| `bettervanilla.adminhelp` | moderator, admin |
\n| `bettervanilla.vanish` | moderator, admin |
\n| `bettervanilla.invsee` | moderator, admin |
\n| `bettervanilla.moderation` | moderator, admin |
\n| `bettervanilla.timer` | moderator, admin |
\n| `bettervanilla.waypoints.admin` | moderator, admin |
\n| `bettervanilla.tag.admin` | moderator, admin |
\n| `bettervanilla.permissions` | admin |
\n| `bettervanilla.maintenance.bypass` | admin |
\n| `bettervanilla.adminsettings` | admin |<\/p>\n