MuteEssentials

All-in-one Paper plugin for Minecraft servers

Replaces an entire stack of tools with a single cohesive codebase. Packs a full ban/mute system with templates, a clan engine with GUI-driven land claims, ranks & prefixes, homes, warps, TPA, vanish, client detection, a full block log with rollback, container protection, auction house and more.

Get on ModrinthChangelogPaper 1.21+

Installation

1

Download from Modrinth

Grab the latest MuteEssentials JAR from the Modrinth page. You'll always get the newest release there, including previous versions if you need them.

2

Connect via SFTP

Open your SFTP client (FileZilla, Cyberduck, or similar) and connect to your Minecraft server using the credentials from your host.

3

Upload to /plugins

Drag the MuteEssentials.jar into the /plugins folder on the remote server. If your server was running, the file will still land cleanly.

4

Restart the server

Send /stop from the console or use your host's restart button. On boot, MuteEssentials loads and generates its config in /plugins/MuteEssentials.

5

Tune the config

Open config.yml and messages-de.yml / messages-en.yml to adjust ranks, ban templates, homes, warps and feature toggles to your liking.

Heads up

MuteEssentials requires Paper 1.21+ and Java 21. Hot-swapping the JAR on a running server works, but a full restart is required for new listeners and commands to register. First launch creates /plugins/MuteEssentials/ with a default config, message files for DE/EN, and a SQLite database for bans, mutes and block history.

Changelog

Full history since 1.0.0, for transparency.

v1.0.92026-04-18

New features

  • -Auction admin view: /auction <player> with muteessentials.auction.admin opens the target's active listings. Right-click removes a listing and returns the item to the seller via mail.
  • -/ah my: cancelling a listing is now a right-click, the lore tells you so.
  • -Auction.ListFee: 0 now fully disables the listing fee (no balance check, no deduction).
  • -Periodic update check: on top of the existing startup check (since 1.0.3) the plugin now re-checks every Update.CheckIntervalHours (default 24h).
  • -/update moved to /mues update (check) and /mues update download (install, restart required). Staff with muteessentials.update get a two-line notification on login when a new version is waiting.
  • -First-join setup banner for OPs: plugin version, config path and Discord contact, shown once and persisted in data.yml.
  • -/team color <color>: team leader sets the team's tab-list and scoreboard color. Supports color names (red, aqua, gold, ...) and hex digits. Tab-complete suggests all colors.
  • -/bl near [radius]: show block events in a radius around you, with configurable default and cap.
  • -AdminGUI settings menu: toggle BlockLog event logging on and off without editing files.

Localization and consistency

  • -Kick, mute, maintenance and first-join MOTD screens moved from config.yml into messages-de.yml / messages-en.yml. config.yml now focuses on toggles.
  • -Four duplicated formatDuration() functions replaced by a shared MessageManager.formatDuration(). Ban and mute durations now render in the viewer's language with proper pluralisation.
  • -Removed hardcoded German strings like 'Unbekannter Grund' and 'Unbekannt' from the chat path; these now resolve via messages.
  • -Auto-language defaults to English when no player context is known, so admin and console output stops accidentally showing German.
  • -Scoreboard title and tablist header renamed from 'SEASON 1' to 'MuteEssentials'; default ServerName changed from the author's domain to play.example.com for fresh installs.
  • -Rank color defaults: supporter is aqua, vip is light purple, default is now 'PLAYER' instead of 'SPIELER'.

Fixes

  • -/bl inspect returns only events for the exact clicked block; previously it returned events world-wide.
  • -Natural block spread, form, fade and leaf decay are no longer logged, so inspect output is readable again.
  • -Clickable coordinates in BlockLog entries teleport the inspector to the event location.
  • -/tpaccept now sends feedback to both sides.
  • -/team color confirmation preview shows the actual team name in the chosen color.
  • -Tab-complete added/fixed for /team color, /auction and /bl subcommands.
v1.0.82026-04-17

New features

  • -Container Protection module: /lock public and /lock private to toggle shared or owner-only access.
  • -Trust by click: /trust and /untrust set a 30 second pending action, then right-click the container to confirm.
  • -Action bar shows the owner when you open someone else's container (configurable).
  • -Double chests are treated as one unit: a single /lock, /trust or break covers both halves.
  • -Random teleport: /rtp with async chunk loading, safe-location checks, configurable radius and cooldown, excludes claimed land.
  • -Team tab color: /team color lets the leader pick the team's display color.
  • -Paid claim expansion: /team claim can cost money per block with a configurable free-block allowance.

Fixes

  • -/tpaccept now sends feedback to both sides.
  • -Scoreboard and tab list separators switched from arrow characters to a colon for better font compatibility. Existing configs are auto-migrated.
  • -Locking one half of a double chest now protects the whole container.

Under the hood

  • -chest_locks table gets an is_public column automatically on first start.
  • -Config and message migrator keeps customizations intact while adding new keys.
v1.0.72026-04-17

Refactor

  • -Auction House is now a first-class module managed by the ModuleManager, matching BlockLog and ChestLock.
  • -Modules.Auction.Enabled added to the config, defaults to true.
v1.0.62026-04-16

New features

  • -ChestLock module: automatic container locks on place, with team access, trust list and hopper-steal protection.

Fixes

  • -Default language for auto-detect is now German, so players without a locale no longer see English fragments when the plugin sends a message without a player context.
v1.0.52026-04-16

Fixes

  • -TPA requests from a second player no longer overwrite pending ones.
  • -Homes and warps are now case-insensitive so MyHome and myhome don't create two entries.
  • -/pay writes both balances in a single atomic save.
  • -/baltop no longer drops players with identical balances.
  • -ChatListener /<TAB> crash on empty input fixed.
  • -Starter kit no longer NPEs on items without meta.
  • -AuctionHouse itemName() NPE-safe.

Usability

  • -BlockLog: tab complete, help and filter prefixes switched to full words (inspect, lookup, rollback, +action:, +block:, +time:, +radius:, +user:).
  • -Chat format uses a colon as separator instead of the arrow character.
  • -/weatherclear is the primary command, /wc stays as alias.
  • -Gamemode tab complete cleaned up (startsWith filter, player name on second argument).
v1.0.42026-04-13

New features

  • -Auction House: player-run marketplace with a GUI, listing fees, mailbox for expired listings, configurable duration.

Fixes

  • -BlockLog: rollback rewind order fix, container transaction snapshots, fire-spread attribution.
  • -Death double-restore bug fixed.
  • -Per-subcommand permissions for /bl.
  • -Better help and usage output across moderation commands.
v1.0.32026-03-28

New features

  • -Auto-updater: checks repo.mutebefehl.de/update.json on startup, notifies staff on login, /update download pulls and verifies the JAR.

Improvements

  • -ConfigMerger injects new config and message keys into existing files without overwriting customizations.
  • -org.json relocated into the shaded JAR so AutoUpdater runs on any server.
v1.0.22026-03-15

New features

  • -Scoreboard redesigned with placeholder system (rank, balance, ping, team, coordinates and more).
  • -Spawn claim protection to prevent claiming the spawn region.

Fixes

  • -GUI click handlers use Material type instead of hardcoded German strings so language switching works properly.
  • -ClaimFlags localization.
  • -GUI pagination and InvSee sync.
  • -Chat invite feedback.
  • -Duplicate CheckCommand section in message files cleaned up.
v1.0.12026-03-01

Improvements

  • -Support for Paper 1.21.0+ (was 1.21 only).
  • -ProtocolLib kick messages for version mismatch and server full.
  • -Economy improvements (display, rounding, PlaceholderAPI integration).
v1.0.02026-02-18

Initial public release

  • -Moderation: ban, mute, kick, warn, report, staff chat, maintenance, vanish, client detection.
  • -Teleportation: home, warp, TPA, spawn, back.
  • -Economy: money, pay, baltop, eco admin.
  • -Teams and Claims: claim wand, flags, trust, clan GUI.
  • -Rank and Prefix system with tab list and nametag integration.
  • -BlockLog module: inspect, lookup, rollback, restore.
  • -Scoreboard, tab list, admin GUI, stats GUI.
  • -Custom kick messages for wrong version, server full and whitelist.
  • -Auto-language detection (German and English).
  • -Time and weather commands.
  • -Full command enable/disable and aliases in config.