MuteEssentials

# MuteEssentials **One plugin instead of a dozen.** Moderation, teleportation, economy, teams and claims, block logging and more, all in a single cohesive plugin. I originally built MuteEssentials for my own SMP around two years ago. It has grown a lot since then, so I am now making it public and continuing to develop it in the open. [](https://wiki.mutebefehl.de/docs/muteessentials) [](https://wiki.mutebefehl.de/docs/muteessentials/changelog) [](https://bugs.mutebefehl.de/?project=muteessentials) [](https://discord.gg/7ZUdU7eXzb) ## What you get The short version. Full breakdown further down. - **Moderation** with reusable templates for bans, mutes, kicks and warns, plus a player report system - **Teleportation**: `/home`, `/warp`, `/spawn`, `/tpa`, `/rtp` and `/back`, with warmups that cancel on movement or damage - **Economy**: built-in money, `/pay`, `/baltop` and a player auction house, optionally shared through Vault - **Teams and claims**: create teams, claim land, manage trust and protection flags - **BlockLog**: inspect, roll back and restore block changes, a lightweight take on CoreProtect - **Kits**: named kits with per-kit permissions and cooldowns - **Container protection**: lock chests and containers and share access with trusted players - **Login protection**: VPN and proxy detection plus client-mod fingerprinting at join - **Admin GUI** to manage most settings in-game without editing config files - **Fully localized**: English and German included, every message customizable ## Screenshots Screenshots of the admin GUI, scoreboard, auction house and claim borders are on the **Gallery** tab above. ## Features The full breakdown of every module. ### Moderation - Ban, kick and mute players with fully customizable templates - Warn system with automatic ban after configurable threshold - Player report system with live staff notifications - Rank protection prevents staff from targeting equal or higher roles - Central admin GUI for punishments, ranks, invsee and settings - Custom kick messages for wrong version, server full and whitelist (requires ProtocolLib) ### Essentials - Homes with teleport delay, cooldown, limits and pagination - Warps for global server locations - Spawn system with first join teleport - TPA requests with clickable accept, `/tpaccept` and `/tpadeny`, both sides get feedback on accept - **`/rtp`**: random teleport with async chunk loading, safe-location checks, configurable radius, cooldown, excludes claimed land - Private messages with reply, social spy and offline delivery - Gamemode, time and weather commands (`/day`, `/night`, `/sun`, `/rain`, `/thunder`, `/weatherclear`) - `/heal`, `/feed`, `/repair`, `/fly`, `/speed`, `/back`, `/nick`, `/clearchat`, `/seen`, `/playtime` - Starter kit for new players (configurable items) - First join welcome message ### Economy - `/money` to check your balance - `/pay` to send money to other players (atomic transfer) - `/baltop` for the top 10 richest players (ties no longer lost) - `/eco set/give/take` for admin management - Configurable start balance and currency symbol - Integrated in scoreboard and PlaceholderAPI - Optional **Vault** provider so shops, jobs and other plugins share the same balances - Full **auction house** module: list items from your hand with `/ah sell `, browse with `/ah`, auto-mail for expired listings ### Teams and Land Claims A complete land protection system inspired by Lands. - Create teams, invite players, assign roles (Leader, Officer, Member) - Claim land with a selection wand and particle borders - Multi-claim support (configurable limit per team) - **Paid claim expansion**: configurable cost per block, optional free-block allowance, money is deducted from the player creating the claim - **Team colors**: leader sets the team's tab color with `/team color ` (color name or `0-9, a-f`) - 8 toggleable flags per claim: PvP, mob spawning, explosions, fire spread, leaf decay, animal protection, ender pearls, pistons - Full protection against block breaking, placing, interactions, liquids, buckets and pistons from outside - Trust system for non-members - Ban players from your claim - Enter and leave title messages - Team rename, promote, demote, kick - Confirmation dialogs for critical actions ### Container Protection Built-in ChestLock module, no external plugin needed. - **Auto-lock on place**: chests, barrels, furnaces, hoppers, brewing stands, shulkers and every other container are locked to the placer automatically - **Double-chest aware**: both halves are treated as one, a single `/lock`, `/trust` or break covers the whole thing - **Team access**: members of the same clan can access each other's containers automatically - **Trust by click**: `/trust ` sets a pending action (30s), then right-click the container to confirm. Same for `/untrust` - **`/lock public`**: mark a container as public so anyone can put items in and take them out. `/lock private` reverts - **`/lockinfo`**: shows owner, trusted players, location and visibility - **Hopper-steal protection**: foreign hoppers cannot pull from locked containers - **Explosion protection**: locked containers survive TNT and creepers - **Action bar** shows the owner when you open someone else's container (configurable) ### Staff Tools Everything your team needs to manage the server efficiently. - Vanish with staff visibility and fake join/leave messages - Staff chat with toggle mode - Maintenance mode with custom kick screen and bypass - Login protection: VPN and proxy detection with configurable thresholds and actions, denies or flags known bad actors before they reach spawn - Client and mod detection with configurable actions - InvSee and EnderChest editing in real time - `/check` command with full player overview - Stats GUI with kills, deaths, blocks, playtime and K/D ratio ### BlockLog A lightweight CoreProtect alternative using SQLite. Included as a built-in module. - Inspect block history by clicking - Lookup actions by player, time and radius with rich filters (`+action:`, `+block:`, `+time:`, `+radius:`, `+user:`) - Rollback and restore with full block data (orientation, inventory contents, sign text, beds, doors, crops) - Death drops recovery: `/bl death ` and `/bl deathrestore [index]` - Purge old data ### Chat and Prefix System - Unified prefix across chat, tablist and nametag above the head - Rank based formatting with configurable colors - Join and leave messages in the player's rank color - Optional color permissions for players - Team suffix support (color chosen by team leader via `/team color`) ### Scoreboard and TabList Fully configurable sidebar and tablist with live placeholders. - Scoreboard with Minecraft-native unicode symbols - TabList header and footer with player info - All text configurable in config.yml - Supports PlaceholderAPI placeholders ### Admin GUI Central management panel for server administration. - Player management with ban, kick, mute, vanish, invsee - Rank overview and assignment - System toggles for all features - Ban and mute lists with one-click unban/unmute ### Customization - Zero hardcoded messages. Every player-facing text is in YAML files - Multi-language with automatic detection (German and English included, per-player locale) - Every command can be enabled or disabled in config - Custom aliases for all commands - All systems toggleable in `Modules..Enabled` - Auto config-migrator: when new config keys are added in updates, they are merged into your existing file without overwriting your values - Optional MySQL backend for shared data across servers, with automatic migration and a local fallback - `/mues reload` for live config changes without restart ### Integrations - **PlaceholderAPI**: 10+ own placeholders (`%muteessentials_rank%`, `%muteessentials_balance%`, `%muteessentials_team%` and more) - **Vault**: registers as the economy provider so other plugins share balances - **ProtocolLib**: custom disconnect messages for incompatible versions and connection throttling ## Getting started Drop the jar into your `plugins` folder and restart. Everything works out of the box, and every part can be configured or turned off. New config keys from updates are merged into your files automatically. ## Compatibility Built for Paper 1.21+ (Java 21+). Tested with 26.2.