MuteBefehl's Essentials (MuteEssentials)
Modern Essentials. Fully customizable with powerful admin tools and a modular system. One plugin to replace them all.
Автор: Henning4814обновлён 27 сент. 2026 г.
УправлениеТехнологииУтилиты
Описание
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.
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,/rtpand/back, with warmups that cancel on movement or damage - Economy: built-in money,
/pay,/baltopand 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,
/tpacceptand/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
/moneyto check your balance/payto send money to other players (atomic transfer)/baltopfor the top 10 richest players (ties no longer lost)/eco set/give/takefor 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 <price>, 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>(color name or0-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,/trustor break covers the whole thing - Team access: members of the same clan can access each other's containers automatically
- Trust by click:
/trust <player>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 privatereverts/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
/checkcommand 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 <player>and/bl deathrestore <player> [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.<Name>.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 reloadfor 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.
Галерея
Последние версии
Все версии →release
MuteEssentials 1.0.18
1.0.1827 сент. 2026 г.65Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3paper, purpur
Что нового
### TL;DR for admins
+ Recommended for everyone, and especially for servers on 1.0.17
+ No manual changes required, your settings are carried over
+ Commands you had switched off stay switched off
+ A duplication path in `/bl deathrestore` is closed
+ The auto updater goes straight from 1.0.16 to 1.0.18
### Critical fixes
+ **Switched-off commands came back on after 1.0.17:** `/enderchest`, `/staffchat` and `/blocklog` were renamed to `ec`, `sc` and `bl` in the configuration, and the old entries were no longer read: Whoever had turned one of them off had it back on. The update moves the setting and any custom aliases to the new names, and also repairs servers that are already on 1.0.17
+ **The first start after an auto update skipped the new settings:** The new configuration keys and messages only arrived after a second restart, and some defaults were missing until then. They are applied on the first start now
+ **An update through the updater of 1.0.16 could be undone later:** On Paper 1.21 the old updater wrote the new version into Paper's working copy instead of the plugins folder, so the server could fall back to the old version once Paper rebuilt that copy. The new version is put into the plugins folder on the next shutdown
+ **`/bl deathrestore` could hand out the same inventory twice:** Two quick calls both got the items before the entry was removed. The entry is claimed first now
+ **Muted players could still write to offline players with `/msg`:** The mute check covered online recipients only
### Fixes
+ **AntiVPN no longer slows down every join when its check service is down.** A failure is remembered for a minute, three failures in a row pause the checks for five minutes, and every request has a hard deadline. Local, CGNAT and IPv6 link-local addresses are recognised properly, a `RiskScoreThreshold` of 0 no longer blocks everyone, and the cache is capped
+ **Shared data in MySQL is written in the right order.** Two saves in quick succession could land the other way round
+ **The updater only uses https** for the update source and the download, and the file has to match the published checksum
+ **Safer MySQL defaults:** an encrypted connection where available and a dedicated user instead of `root`. Existing setups are only changed while MySQL is switched off. With MySQL on, the start warns about unencrypted connections, `root` and an empty password instead
+ Auction prices have to be real numbers, `/report` has a cooldown, and the claim index is rebuilt on `/mues reload`
Full changelog: https://wiki.mutebefehl.de/docs/muteessentials/changelog
release
MuteEssentials 1.0.17
1.0.1720 сент. 2026 г.17Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3paper, purpur
Что нового
### TL;DR for admins
- No manual changes required
- No permission that worked before loses its effect
- Extensive fixes around rollback and containers
- Several duplication and exploit paths closed
- New teleport and toggle commands
- Data and configuration are written atomically now
### Compatibility
- **Paper 26.3 is cleared for use**
- Full in-game testing on 26.3 is still running, and Paper itself has no stable 26.3 build yet. If something behaves oddly there, please report it on Discord: https://discord.gg/7ZUdU7eXzb
- Everything from 1.21 upwards stays supported, 26.1 and 26.2 are unchanged
### Critical fixes
- **Fixed:** Containers came back empty from a rollback. The block was restored, the items were written into a snapshot that was thrown away right afterwards. Every chest, barrel, furnace and shulker box was affected
- **Fixed:** Container protection failed open. A lock database that could not answer read as "this block is not locked", so every locked chest on the server was free to open and break. Turning the ChestLock module off in the admin menu was enough to cause it
- **Fixed:** `/invsee` could duplicate and delete items. The view was written back in full on close, so anything the player picked up in the meantime was erased and anything they dropped came back
- **Fixed:** Any team member could wreck the team. Deleting all claims, removing trusted players and flipping claim flags were possible straight from the menu, while the same actions on the command line required leader or officer
- **Fixed:** A menu whose title an operator had restyled stopped cancelling clicks, which turned every decorative item in it into a free item. Menus are identified by their inventory holder now
- **Fixed:** TNT and fire could not be rolled back by player. Both were filed under `#tnt` and `#fire`, so a rollback of the griefer undid none of it. They are attributed to whoever lit them now
- **Fixed:** A theft out of a container can be rolled back. The before and after contents were recorded all along and never used
- **Fixed:** Paintings, item frames, bone meal, trees and sponges are logged and restored. None of them could be undone before
- **Fixed:** Rolling back a broken container no longer duplicates its contents, and the drops next to it are cleared with it
- **Fixed:** An action another plugin cancelled is no longer written to the log, so a rollback stopped deleting blocks that were never placed
- **Fixed:** `/mues update download` no longer overwrites the jar the server is running from. The download is staged in the update folder and applied on the next restart, the backup of the replaced version is kept, and the source is read again for every download instead of reusing what an earlier check happened to see
- **Fixed:** Messages arrive in the language of whoever reads them. Around a hundred of them always came in the server default
- **Fixed:** `Home.Permission`, `TPA.Permission`, `Msg.Permission`, `ClanSystem.Permission` and `Update.Permission` are asked now. They were documented and configurable but never checked. All four player nodes ship with `default: true`, so nothing changes until you revoke them
### New
- **New:** `/tpahere <player>` asks a player to teleport to you, the counterpart to `/tpa`
- **New:** `/tptoggle [on|off]` blocks incoming teleport requests, `/msgtoggle [on|off]` blocks incoming private messages, replies included. Staff still get through with `muteessentials.tptoggle.bypass` and `muteessentials.msgtoggle.bypass`
- **New:** The first operator who joins after an update is told about it and gets a link to the changelog and to the support Discord
### More fixes
- **Fixed:** Block log: double chests, pistons, beds and doors, crops on farmland, rollback order, rollbacks that found nothing after a rename, a rollback that could wedge itself, `/bl purge 0`, and `BlockLog.RetentionDays` instead of a fixed thirty days
- **Fixed:** AntiVPN checked nothing. The default API address had moved and answered with a permanent redirect, which the HTTP client does not follow, so every lookup failed silently and no connection was ever blocked. Existing configurations are corrected on the first start
- **Fixed:** Chest locks: a lock left behind by a container that disappeared without a break event, the trusted list of a double chest, and a lock that silently failed to be written
- **Fixed:** Auction house: duplicating an item when cancelling a listing, losing one when a listing failed, and prompts that swallowed the next chat message a player sent
- **Fixed:** Moderation: a ban kick replaced by the version warning, `/mute` on a nickname missing the real account, an automatic ban that wiped the warnings it was based on, `/customban` reading a duration as a reason, and `/maintenance on` kicking the admin who ran it
- **Fixed:** Vanish: advancements, `/vanish` messages, tab completion and client detection all revealed vanished or nicked players
- **Fixed:** Economy: cents rounding and a stale connection in MySQL, and a balance cache that takes the sidebar off the database
- **Fixed:** Data: configuration and data files are written atomically, offline messages survive a quick relog, a kit is only handed out once its cooldown is stored, and a config upgrade that cannot be written says so
- **Fixed:** Config: every command can be switched off now, twenty-three had no entry at all, and `General.BlockUnknownCommands` can be turned off on a proxy network
- **Fixed:** Smaller things in `/stats`, `/speed`, `/team unclaim`, `/mues update`, `/unban` tab completion, the scoreboard after a reload, and a few leaks that grew with the server's uptime
### Changed behaviour
- **Note:** Container actions are refused while the lock database is unreachable; the protection stays closed rather than open
- **Note:** A kit is refused instead of handed out when its cooldown cannot be stored
- **Note:** With MySQL across several servers a balance can be up to three seconds old in the sidebar
- **Note:** Turn `General.BlockUnknownCommands` off on a proxy network
- **Note:** The four player permissions ship with `default: true`, so revoke them explicitly if you want to restrict them
release
1.0.16
1.0.1631 авг. 2026 г.37Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2paper, purpur
Что нового
A small follow-up to 1.0.15. It closes the last gap where a failed write could still be reported as a completed payment.
## Economy
- **Fixed:** Transfers, deposits, withdrawals and balance changes now check whether the write actually reached the disk. A failed write is reported as a failure instead of quietly pretending the money moved, and a failed transfer puts both balances back
- **Fixed:** MySQL transfers verify the credit. If the receiving row cannot be updated, the whole transfer rolls back instead of committing a debit without a matching credit
release
1.0.15
1.0.1518 июл. 2026 г.64Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2paper, purpur
Что нового
There is no public 1.0.14. It was an internal build handed to a small, selected group of testers, and everything from it ships here in 1.0.15.
## Nicknames
- **New:** `/nick <name>` changes your name everywhere: chat, tab list, scoreboard, join and leave messages, private messages, `/pay`, `/tpa`, team invites and advancements. The nickname survives reloads and restarts
- **New:** `/unnick` removes a nickname (`/nick off` still works)
- **New:** `PrefixSystem.NickOverheadName` (default off, needs ProtocolLib): also rewrites the name above the head. The first time a player nicks, they are told that their own client may still show their real name to them, while everyone else sees the nickname
- **New:** `/nick <name> <rank>` lets staff pick a rank to appear as, capped at their own rank. Turn it off with `Nick.AllowRankNick`
- **New:** Nickname protection: a nickname cannot be the name of a real account, a name on the new `Nick.Blacklist`, a rank name (`Nick.BlockRankNames`) or a nickname another player is already wearing. `muteessentials.nick.bypass` lifts these limits
- **New:** Staff see through nicknames. Operators and holders of `muteessentials.nick.see` are shown `RealName (Nick)` in join and leave messages, `/pay`, `/tpa`, `/msg`, team invites, client detection and `/check`
- **New:** The admin GUI shows a player's current nickname and a nickname history with timestamps
- **Fixed:** Moderation always targets the real account. Warns, kicks, bans, ranks, gamemode, `/eco`, `/check`, `/invsee` and the block log resolve real names only, and their tab completion shows real names
- **Fixed:** A nickname can no longer smuggle colour codes past `muteessentials.nick.colors`, expand PlaceholderAPI placeholders, or break the chat format with a `%`
## Economy
- **Fixed:** `/pay` is atomic. Two payments arriving at once can no longer overwrite each other, and MySQL transfers run in a transaction
- **Fixed:** The auction house no longer uses read-modify-write, so a payment that arrives while someone is buying is not lost
- **Fixed:** A failed database write no longer reports success. Vault answers with a failure instead of letting a shop hand out goods for free, and `/eco` says so instead of claiming the money moved
- **Fixed:** A database read error can no longer wipe a balance to zero
- **Fixed:** `/eco take` reports the amount it actually removed rather than the amount requested
- **Fixed:** A mistyped name in `/eco` no longer creates an account for a player that does not exist
- **Fixed:** An auction listing whose item can no longer be read is refused instead of charging the buyer and delivering nothing. It shows as a placeholder rather than breaking the auction house for everyone
- **Fixed:** Auction mail can only be claimed by its recipient, and clicks in your own inventory are no longer treated as clicks in the auction view
- **Fixed:** An expired listing can no longer be bought in the window before cleanup, and expired listings no longer count against the listing limit
## Prefixes, scoreboard and tab list
- **New:** The scoreboard, tab list and prefix system can now be toggled fully independently (`Scoreboard.Enabled`, `TabList.Enabled`, `PrefixSystem.Enabled`)
- **New:** `Config.MergeDefaults` (default on): set it to `false` to stop removed ranks, templates and config keys from being added back on the next start
- **Fixed:** Nametags no longer require the scoreboard to be enabled
- **Fixed:** The clan tag is back in the tab list, and it now uses the colour the clan picked instead of always being gold
- **Fixed:** The custom tab list no longer requires the scoreboard to be enabled
- **Fixed:** Turning off the prefix system no longer affects the scoreboard or tab list, and rank prefixes are now removed everywhere (chat, tab name and over-head nametag)
- **Fixed:** `/mues reload` now re-reads ranks, prefixes and the chat format live, and refreshes scoreboard teams and tab names without a restart
- **Fixed:** A separate `tabPrefix` per rank now works independently of the chat prefix
- **Fixed:** Scoreboard lines that render identically no longer overwrite each other
- **Fixed:** A player's chat prefix and nametag no longer disagree when two ranks share the same priority
- **Fixed:** Two ranks whose names share a long start no longer share one prefix, and a rank with a negative priority no longer sorts to the top of the tab list
- **Fixed:** PlaceholderAPI placeholders in a rank prefix or suffix (for example `%simpletags_tag%`) are now expanded in chat instead of throwing a formatting error on every message
- **Fixed:** The tablist entry now shows the rank suffix as well, not just the prefix and name
- **Fixed:** A `»` in a scoreboard line is no longer replaced on every start, so you can keep it
- **Updated:** The sidebar is updated instead of being rebuilt every two seconds, and its placeholders are resolved once per player instead of once per line
## Teams
- **New:** The team wand is taken back once you finish a claim. You can get a new one from the team menu
- **Fixed:** Claiming clears the stored selection, so a second `/team claim` can no longer create a duplicate claim
- **Fixed:** Team members can be invited, kicked, promoted and demoted by the name you see, including nicknames
- **Fixed:** Item frames, armor stands, paintings and vehicles are protected inside a claim
## Other
- **Fixed:** Server data (balances, homes, warps, clans, nicknames) can no longer be corrupted when another plugin moves money from its own thread
- **Fixed:** `/spawn` used the warp countdown instead of its own
- **Fixed:** A home teleport now starts its cooldown after the teleport succeeded, not before
- **Fixed:** A new teleport request no longer expires because an older one timed out
- **Fixed:** Breaking one half of a double chest is detected reliably
- **Fixed:** A muted player can no longer bypass the mute with `/msg`
- **Fixed:** Warnings are cleared after an automatic ban, so the next warning does not ban again immediately
## Notes
Existing config and message files are updated in place on first start, with a backup created beforehand. No manual steps are required.
beta
MuteEssentials 1.0.14
1.0.1418 июл. 2026 г.12Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2paper, purpur
release
MuteEssentials 1.0.13
1.0.135 июл. 2026 г.35Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2paper, purpur
Что нового
This release adds several long requested features and focuses on making the plugin friendlier for international servers. Everything is optional and existing setups keep working after the update.
### New features
**Vault economy support**
MuteEssentials can now act as the economy provider for your server. When Vault is installed, shops, jobs and other plugins share the same balances as `/money`, `/pay` and `/baltop`. You can name your currency and turn the hook off if another plugin should stay in charge.
**Kit system**
A new `/kit` command lets players claim predefined item kits. Every kit has its own permission, an optional cooldown (none, timed, or one time only) and a full item list with custom names, lore and enchantments. If a player's inventory is full, the extra items drop at their feet instead of being lost.
**Offline private messages**
Sending a `/msg` to a player who is offline no longer fails silently. The message is stored and delivered the moment that player logs back in, together with the time it was sent.
**Safer teleports**
Teleport warmups for `/home`, `/spawn`, `/warp`, `/tpa` and `/rtp` now share the same behaviour. A warmup cancels if the player moves or takes damage, which helps prevent combat logging. `/rtp` gained a warmup as well, and its cooldown only starts after a successful teleport.
**Optional MySQL storage**
Servers that want a shared database can now move their global data into MySQL or MariaDB. Balances, offline messages, kit cooldowns and the rest of the central data are stored in one place. The first start migrates your existing data automatically, and if the database cannot be reached the plugin falls back to local files so your server keeps running. This is off by default, so nothing changes unless you enable it.
### Improvements
**English by default**
All remaining German text has been translated. Command descriptions, the help menu, the scoreboard defaults and a few internal messages are now in English. Existing configs are upgraded automatically, and any scoreboard you customized yourself is left untouched.
**Command conflict warnings**
On startup the plugin now tells you in the console if one of its commands is also provided by another plugin, and how to hand that command back if you prefer the other one.
### Notes
Existing config and message files are updated in place on first start, with a backup created beforehand. No manual steps are required.
release
MuteEssentials 1.0.12
1.0.1217 мая 2026 г.82Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2paper, purpur
Что нового
## Bugfixes
### `/rtp`
- Failed searches no longer hammer the server. Retries now run via `runTaskLater` with a configurable delay instead of immediate recursion.
- `findSafeLocation` operates on the chunk that was already loaded async. No more sync chunk loads during search.
- `RTP.MaxTries` default lowered from 20 to 8 (matches the new, more honest retry logic).
- New config key `RTP.RetryDelayTicks` (default 5).
### Teleports & Homes
- `/home` and `/tpa` countdowns are now properly cancelled when a player quits. Previously the scheduler task kept running and produced "player not online" spam in the log.
- Cooldown maps are cleaned up on quit (no more memory leak after many reconnects).
- Home-load errors now go through the plugin logger instead of `printStackTrace()`. Cleaner log files.
### MOTD / Join message
- If neither `ServerListMOTD.Enabled` nor the legacy `ServerMOTD.Enabled` is set, the MOTD code path is fully skipped. Previously the server could push an empty MOTD line.
- Empty `JoinMessage.Lines` are no longer sent to players.
### Localization
- HackDetection kicks and staff alerts now come from `messages.yml`. Previously the strings were hardcoded and ignored the player's language.
- `getClientName()` returns a localized "Unknown" instead of a hardcoded "Unbekannt".
- Maintenance kick, ban kick, outdated-client kick, server-full kick and whitelist kick all use the affected player's locale instead of the server default.
- Setup banner for the first OP join, StarterKit welcome and every home message now route through the per-player locale path.
- BAN console logs are normalized to English (previously a mix of German and English).
### AutoUpdater
- Logger strings normalized to English.
- New reminder: while an update is pending, the plugin writes a warning to the log every `Update.PendingReminderMinutes` (default 60). Stops a found update from being forgotten.
## New
### Versioned config upgrader
- `config.yml`, `messages-*.yml`, and `data.yml` now carry a `ConfigVersion`. On startup the `ConfigUpgrader` migrates older files automatically.
- First migration: the old hardcoded default names for StarterKit items (German "Starter-Schwert" etc.) are removed so the new localized `nameKey` names take effect.
- A backup of each config is written before any migration runs.
### StarterKit
- Items now support `nameKey` for localized display names. Static `name` is still accepted as a fallback.
- The default kit no longer carries hardcoded German names.
### Anonymous telemetry
- Optional heartbeat (default on, `Telemetry.Enabled`): once per hour the plugin sends anonymous usage data (version, player count, uptime). No player data, no IPs, no content. Can be opted out at any time via config.
- Optional error reporting (default off, `ErrorReporting.Enabled`): when enabled, MuteEssentials stack traces are anonymized (UUIDs, IPs, hostnames stripped) and sent to the maintainer. Rate-limited to one report per error class per hour.
## Config diff
```yaml
ConfigVersion: 1
ErrorReporting:
Enabled: false
Telemetry:
Enabled: true
RTP:
MaxTries: 8 # was 20
RetryDelayTicks: 5 # new
Update:
PendingReminderMinutes: 60 # new
```
## Upgrade notes
Drop in the new jar and restart the server. The `ConfigUpgrader` pulls existing configs forward automatically and writes backups as `config.yml.bak-<timestamp>` before touching anything. No manual edits required.
release
MuteEssentials 1.0.11
1.0.1116 мая 2026 г.12Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2paper, purpur
Что нового
## Bug Fixes
- Team claims now cover the entire vertical column from bedrock to sky, not just a single layer
- Claim overlap detection now properly catches a small claim hidden inside a larger one
- Claim IDs no longer collide after an unclaim
- AuctionGUI clicks no longer fall through for players whose language differs from the server (same fix in AdminGUI, StatsGUI, TeamGUI)
- AuctionDatabase is synchronized, no more SQLite race conditions
- `/pay` now requires the `muteessentials.pay` permission
- NPE risks fixed in `/team claim info`, `/team info`, `/team kick`, `/team promote/demote`, `CheckCommand`
- Memory leaks closed in TeleportCommand, TeamClaimListener, HomeCommand, MsgCommand (cleanup on quit)
- Money inputs are validated and capped before applying
- BlockLog teleport respects world border and Y bounds
- Home teleport cleanly aborts if the player logs out mid-countdown
- Around 30 places where the player's language was ignored now correctly use their locale
- Hardcoded German `[Akzeptieren]` button in TPA replaced with a proper Accept and Decline pair pulled from `messages.yml`
- `/team info` strike-through bar shows on both top and bottom
- `/bl help` no longer prepends the prefix on every line
- StarterKit no longer ships with hardcoded German item names, every player sees the item in their own client language
- MOTD defaults are stricter, no more accidental activation after an update
## New Features
- `/team list [page]` lists every team on the server
- `/team delete confirm` and `/team unclaim [id] confirm` require explicit confirmation
- `/team trust` and `/team untrust` work for offline players
- `/team rename` rejects name collisions and same-name renames
- `/team info` shows claim count, creation date, last-modified date
- `/team wand` refuses to hand out a duplicate Wand
- AdminGUI resizes to fit the actual number of ranks (27/36/45/54)
- AdminGUI color picker now offers all 16 real Minecraft chat colors with matching wool blocks
- AdminGUI rank tiles are dyed in the rank's actual prefix color instead of by priority
- Pending update reminder logs once per hour in the console (configurable)
- Anonymous telemetry similar to bStats. No player data, no chat, no IPs. Disable via `Telemetry.Enabled: false`
- Optional error reporting (off by default). Enable via `ErrorReporting.Enabled: true`
- ConfigUpgrader with version tracking for `config.yml`, `messages-*.yml`, and `data.yml`
- Automatic backups in `plugins/MuteEssentials/backups/` (last 10 per file) before any migration runs
- Every config or messages change during an upgrade is logged line by line in the console
## Other
- ReportCommand (dead code) removed
- BasicCommands migrated off the deprecated Attribute API
- TabCompleter extended for TeleportCommand, HomeCommand, BlockLogCommand, TeamCommand
- Console output is now in hardcoded English regardless of player language settings
- Data migration upgrades old narrow-Y claims to full-Y and stamps timestamps on existing teams
Thanks to TurboToad12 for reporting bugs and testing this release.
release
MuteEssentials 1.0.10
1.0.102 мая 2026 г.29Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2paper, purpur
Что нового
## New features
- HackDetection in ClientDetection: known hack-client brands and plugin channels (Wurst, Meteor, LiquidBounce, Sigma,
Impact, Aristois, Future, Vape, RusherHack, Inertia, KAMI, SeedcrackerX, Xray and others) are flagged on join. Default
Action is kick; staff with `muteessentials.clientdetection.hack` get an in-game alert.
- AntiVPN module: `AsyncPlayerPreLoginEvent` check against the [NetSight](https://netsight.mutebefehl.de/) (my othere project) `/api/fraud-check` endpoint. Configurable risk
score threshold, optional hosting/datacenter blocking, per-IP cache, and a kick message in `messages-de.yml` /
`messages-en.yml`. Authenticated via `X-MC-Token` shared secret so no per-user API key is required.
- AdminGUI Settings menu rebuilt as a 21-toggle dashboard: every system, module, scoreboard, tablist, kit, MOTD,
maintenance and update can be flipped live, with a description and an apply tag (`✓ no restart needed` / `✗ restart
required`) on each entry.
- Rank color picker in AdminGUI: creating a rank now prompts for the rank id in chat and then opens a 16-block wool
picker (one wool per Minecraft dye color). Existing ranks have an Edit Color button on their detail page.
- Templates GUI is paginated: ban, kick, mute and warn template lists now use 28 entries per page with prev/next
arrows, so an unlimited number of templates is supported.
- `Custom...` button on each templates GUI: opens a chat prompt for a free reason (kick, warn) or reason plus duration
(ban, mute) in the form `Hacking | 7d`. The duration parser accepts `1d`, `12h`, `30m`, `15s`, combinations like
`1d12h`, plain seconds, and `permanent` / `perm` / `-1`.
- `/mute <player> <reason words> [seconds]` now accepts a numeric last argument as the duration in seconds, mirroring
`/customban`.
- `WarnSystem.Templates`: the warn system now supports the same template structure as bans and kicks. `/admingui`
exposes a Warn button (magenta wool) in the player view.
- `muteessentials.bypass.clientdetection.hack`: a player with this permission is never flagged or kicked by
HackDetection.
## Localization and consistency
- Rank color defaults aligned to the Minecraft dye palette (red, orange, yellow, lime/green, cyan, blue, purple,
magenta, pink, light gray). Owner is red, admin is orange, premium is purple, default is light gray. Existing config
values are preserved by the merger.
- `ServerMOTD` renamed to `ServerListMOTD` (server-list ping) and `MOTD` renamed to `JoinMessage` (post-join chat
welcome). Both keys are auto-migrated to the new names by `ConfigMigrator` on first start; the legacy keys stay in the
file as a record and the runtime falls back to them when migration is skipped.
- All AdminGUI items are now wool blocks instead of dyes, matching the rank color picker. Player rank rows in the
manage GUI are colored by the rank's own prefix color rather than the previous lime/gray indicator.
- Toggle apply tags use `✓` and `✗` instead of `↻`; English reads `No restart needed` and `Restart required`.
- Default `ServerName` in the bundled config changed to `play.example.com` so fresh installs no longer ship with the
author's domain.
## Fixes
- BlockLog rollback now restores attached blocks (torches, ladders, wall signs, doors, beds, plants, lanterns, chains,
vines, dripstone, banners, candles, pressure plates, redstone, …). Previously only the support block came back; the
dependent block was lost as a dropped item.
- BlockLog rollback now restores both halves of a bed and a door. Previously `isBedHead` always returned true for the
head entry, skipping it; the head was missing after rollback because `applyPhysics=false` does not auto-create the
paired half.
- Scoreboard rank prefix no longer shows the `»` separator for the default Player rank. The cut point is now the `»`
character itself instead of the first `§8` color code, so a rank that uses gray as its name color (the default Player)
is rendered correctly.
- GamemodeCommand checks the base permission `Gamemode.Permission` before the subcommand-specific check;
`Gamemode.PermissionOther` is read at the call site as before.
- Config.java logs accurate severity for each I/O path: `Could not load` and `Invalid config file` at startup, `Could
not save` on save failure, `Could not reload` on reload failure (was previously a copy-paste of the create-failed
message).
## Under the hood
- `ConfigMigrator` runs at plugin enable, before `ConfigMerger`. It moves customisations from old key names
(`Modules.AntiHack.*`, `ServerMOTD.*`, `MOTD.*`) to their new locations and never deletes the originals, so user
content is preserved.
- ClientDetector default brand/channel pattern lists are extensible via `ClientDetection.HackDetection.BrandPatterns`
and `ChannelPatterns`; an empty list falls back to the built-in defaults.
- `AntiHackModule` and `AntiHackListener` removed; the logic is now inside `ClientDetector` and triggered after the
existing client resolution callback.
- `MuteCommand` free-form path accepts an optional numeric last argument for duration in seconds, parallel to
`CustomBanCommand`.
release
MuteEssentials 1.0.9
1.0.918 апр. 2026 г.36Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2paper, purpur
Что нового
### Auction tools
- New `/auction <player>` for admins (`muteessentials.auction.admin`): opens the target's listings.
Right-click a listing to remove it; the item returns to the seller via auction mail
- `/ah my`: cancel is now a right-click, lore reads "Right-click to remove"
- `Auction.ListFee: 0` fully disables the listing fee
### Update system
- Update check now runs every `Update.CheckIntervalHours` (default 24h) on top of the existing startup
check from 1.0.3
- Update commands moved from `/update` to `/mues update` (check) and `/mues update download` (install)
- Staff with `muteessentials.update` get a 2-line notification on login when a new version is available
- First-join setup banner for OPs with plugin version, config path and Discord contact
### Localization
- Every kick/mute/maintenance/MOTD screen was moved from `config.yml` into `messages-*.yml`.
`config.yml` is now focused on toggles
- Ban and mute durations (`2 days`, `5 hours`, ...) now render in the viewer's language via a shared
duration helper
- Auto-language falls back to English when no player context is available, so admin output no longer
leaks into the wrong language
### Teams
- `/team color <color>` lets the leader set the team tab color (name like `red`, `aqua`, or hex digit).
Tab-complete suggests all colors
- Default rank colors refreshed: supporter aqua, vip light purple
- `/team color` confirmation shows the actual team name in the chosen color
### BlockLog
- `/bl inspect` now returns the exact clicked block instead of world-wide events
- Natural block spread / form / fade / leaf decay no longer logged (no more vine noise)
- `/bl near [radius]` subcommand for events around the player
- Clickable coordinates in entries teleport the inspector
- AdminGUI toggle for BlockLog logging
### Fixes
- `/tpaccept` gives feedback to both sides
- `/lock public` for shared chests, trust-by-click flow, double-chest aware
- Locking one half of a double chest protects the whole container