zEssentials

- **zEssentials now loads as a Paper plugin** (`paper-plugin.yml`): - Dependencies are declared through Paper's `dependencies.server` system (zMenu and PlaceholderAPI required, every hook optional) with explicit classpath access - The MariaDB JDBC driver is now downloaded by a Paper plugin loader (`ZEssentialsPluginLoader`) instead of the `libraries` section; the `PAPER_DEFAULT_CENTRAL_REPOSITORY` mirror is honored - **Spigot fallback**: on Spigot the plugin stays inactive (no commands, modules or API) and logs a warning; players with `zessentials.paper.warning` (default op) are told on join that Paper is required - zEssentials now fails fast with an explicit error when a zMenu service (`InventoryManager`, `ButtonManager`, `PatternManager`) is unavailable, and handles a partial shutdown cleanly (buttons and services are unregistered) - Updated FastBoard to `2.2.2` — fixes the scoreboard on recent versions (final scoreboard packet field mutation) while preserving the scoreboard API - Removed duplicate teleport translation keys in `messages.yml` - Optimized command lowercasing in the command manager and the cooldown lookup - Updated the Gradle wrapper to `9.8.1` and the foojay resolver to `1.0.0` (builds with Java 25) - Updated the plugin website and contributors

- **New configuration option**: enable the "First join teleport" in the `config.yml` file; it is now disabled by default. - **Added** Faststats https://faststats.dev/project/zessentials/. - **Changed** method signature in the configuration interface. - **Fixed** MySQL error on create user home tables. - **Fixed** Teleport world command permission.

- Added **text mails** to the mailbox module, to send a message to a player who is not connected (`modules/mailbox/config.yml`): - `/mail send <player> <message>` works with an online or offline player, `/mail read` displays the received mails and marks them as read, `/mail clearmessages [player]` deletes them and `/mail sendall <message>` sends a mail to every online player - A player who connects with unread mails is notified with a clickable message (`message-notify-on-join`, `message-notify-delay`) - Configurable limits: `message-max-amount` per player, `message-max-length`, `message-cooldown` between two mails (bypassed with `essentials.bypass.cooldown`) and `message-date-format` - A muted player cannot send a mail, and a player who used `/ignore` no longer receives the mails of the ignored player - Persistence via a new `user_mail_messages` table (SQLite and MySQL) and inside the user file for the JSON storage, unlike the item mailbox which stays MySQL only - New permissions `essentials.mail.send`, `essentials.mail.read`, `essentials.mail.send.all` and `essentials.mail.clear.messages` - Fixed the build of the `NMS:V26_2` module: since Minecraft 26.1 the built in entity types are declared in `EntityTypes` and no longer in `EntityType`, so `EntityType.BLOCK_DISPLAY`, `ITEM_DISPLAY` and `TEXT_DISPLAY` could not be resolved anymore - Fixed `shadowJar` failing with `Unsupported class file major version 69` — the `NMS:V26_2` module still builds with a Java 25 toolchain (needed to read the 26.2 dev bundle) but now emits Java 21 bytecode, which the ASM version bundled with the shadow plugin can remap - Added a new **custom commands** module (`modules/customcommands/config.yml`) to create your own commands without any other plugin, for `/discord`, `/map`, `/vote`, `/store`, `/updates`... - Each command can define `aliases`, a `permission`, a `description`, a `cooldown` in seconds (bypassed with `essentials.bypass.cooldown`) and a list of `messages` - `type` selects how the content is displayed: `TCHAT`, `CENTER`, `ACTION`, `TITLE`, `BOSSBAR` or `NONE` - MiniMessage, legacy colors and PlaceholderAPI placeholders are supported, so `<click:open_url:'...'>` can be used to display clickable links - zMenu `actions` can be run after the messages (sound, command, inventory, ...) - Commands are registered at runtime and `/ezreload` updates them without duplicating anything; a custom command that would override an existing zEssentials command is refused with a message in the console - Added display options for `/seen` in `modules/sanction/config.yml` — `seen-show-uuid`, `seen-show-ip`, `seen-show-last-location`, `seen-show-created-at` and `seen-show-playtime`. The IP address can now be hidden globally, even from operators: until now it was only protected by the `essentials.seen.show.ip` permission, which an operator always has - Fixed several configuration options being silently ignored: they were declared as `private final` fields with a constant initializer, so javac inlined them at compile time and the value read from the configuration file was never used - Sanction module: `date-format`, `kick-default-reason`, `ban-default-reason`, `mute-default-reason`, `unmute-default-reason`, `unban-default-reason` - Spawn module: `respawn-listener-priority` and `spawn-join-listener-priority` — the respawn and join listeners were always registered with the `NORMAL` priority instead of the configured one (`HIGHEST` by default) - Worldedit module: `enable-color-visualisation` and `open-help-inventory` - Clarified the `/compact` and `/compactall` descriptions to mention their existing `/condense` and `/condenseall` aliases - Fixed the chat ping sound not playing on Paper 1.21.3+ — `org.bukkit.Sound` became an interface, so the ping sound is now resolved cross-version through the zMenu XSound API (like the teleportation sounds) - Fixed countdown/teleport placeholders (`%name%`, `%seconds%`, ...) showing as raw text when the message `type` is set to `TITLE` or `BOSSBAR` — internal placeholders are now resolved for every message type - Added `/pingsound` command (`/pingsounds` alias) to toggle the chat ping sound per player; the `enable-player-ping-sound` global toggle is now honored - Added `/tp <player1> <player2>` — teleport one player to another player - Added a player ignore system with persistence (`user_ignores` table): - `/ignore <player>` blocks a player's private messages and teleport requests (`/tpa`, `/tpahere`) - `/unignore <player>` and `/ignorelist` (`/ignores` alias) - Works for online and offline targets, persists across restarts (MySQL and JSON storage) - Added `/delhome-other <player> <home>` (`/delhomeother`, `/hdelother` aliases) — admin command to delete a specific home of another player (online or offline), with permission `essentials.del.home.other` - Added persistence for `/ptime` and `/pweather` — the per-player time and weather are now saved and re-applied automatically when the player reconnects - Fixed private messages to a vanished player revealing their presence when they had ignored the sender — the vanish check now takes precedence over the ignore check - Removed the non-functional `itemadders-font-regex` chat config options (the feature was never wired) and corrected the `/sc` reference in the chat config comment (it is `/chathistory`) - Added a Homes system enhancement (see `modules/home/config.yml`): - **Public homes** — `/homepublic <home>` makes a home visitable by everyone, `/publichomes [player]` lists them (in chat or a paginated GUI via `public-homes-display: CHAT|INVENTORY`); visit with `/home <player>:<home>` (permissions `essentials.home.public`, `essentials.home.visit`, configurable `max-public-homes`) - **Shared homes** — `/homeshare <home> <player>`, `/homeunshare`, `/homeshares` to share a home with specific players (online or offline); shares are purged when the home is deleted (permission `essentials.home.share`, `max-shared-per-home`) - **Categories** — `/homecategory <home> <category>` to organise homes (permission `essentials.home.category`), placeholder `%category%` - **Favorites** — `/homefavorite <home>` to mark a home as favorite; `favorite-first` shows favorites at the top (permission `essentials.home.favorite`), placeholder `%favorite%` - **Preview** — optional `enable-home-preview` shows a clickable confirmation before teleporting - **Import** — `/homeimport essentialsx` imports homes from EssentialsX (permission `essentials.home.import`) - Persistence via new `is_public`/`category`/`is_favorite` columns on `user_homes` and a new `user_home_shares` table (MySQL and JSON storage) - Updated zMenu to `1.1.1.6` and added support for Minecraft/Paper **26.2**: - Added a new `NMS:V26_2` module (built against the `26.2.build.+` dev bundle, compiled with Java 25 which Minecraft 26.x requires) - Migrated the whole plugin to **Mojang mappings** — Paper 26.1+ removed Spigot reobfuscation, so every NMS module now uses `MOJANG_PRODUCTION` and the shaded jar is marked `paperweight-mappings-namespace: mojang` - **zEssentials is now Paper-only and requires Paper 1.20.5+ — Minecraft 1.20.4 is no longer supported** (Mojang-mapped plugins only load on 1.20.5+) - Replaced the removed zMenu `NmsVersion` enum with the new `MinecraftVersion` API for version detection and NMS package resolution (`NmsVersionUtils`) - Bumped `paperweight-userdev` to `2.0.0-beta.21`

- Added player list placeholders for retrieving online player information by index (1-based, sorted alphabetically, excludes vanished players): - `%zessentials_playerlist_count%` Returns the number of visible online players (excludes vanished) - `%zessentials_playerlist_<index>_name%` Returns the player's name at the given index - `%zessentials_playerlist_<index>_uuid%` Returns the player's UUID at the given index - `%zessentials_playerlist_<index>_ping%` Returns the player's ping in milliseconds - `%zessentials_playerlist_<index>_colored_ping%` Returns the player's ping with color based on quality - `%zessentials_playerlist_<index>_level%` Returns the player's experience level - `%zessentials_playerlist_<index>_health%` Returns the player's current health - `%zessentials_playerlist_<index>_max_health%` Returns the player's max health - `%zessentials_playerlist_<index>_food_level%` Returns the player's food level - `%zessentials_playerlist_<index>_gamemode%` Returns the player's game mode - `%zessentials_playerlist_<index>_world%` Returns the player's world name - `%zessentials_playerlist_<index>_x%` Returns the player's X coordinate - `%zessentials_playerlist_<index>_y%` Returns the player's Y coordinate - `%zessentials_playerlist_<index>_z%` Returns the player's Z coordinate - `%zessentials_playerlist_<index>_displayname%` Returns the player's display name - `%zessentials_playerlist_<index>_is_flying%` Returns true if the player is flying - `%zessentials_playerlist_<index>_is_op%` Returns true if the player is operator - `%zessentials_playerlist_<index>_is_sneaking%` Returns true if the player is sneaking - `%zessentials_playerlist_<index>_is_afk%` Returns true if the player is AFK

- Updated zMenu to version 1.1.1.2 - Updated Sarah to version 1.23 - Added generic Bukkit event-based permission checker for WorldEdit module — blocks in protected claims (HuskClaims, GriefPrevention, Lands, Towny, etc.) are now automatically skipped without needing a specific hook [#237](https://github.com/Maxlego08/zEssentials/issues/237) - Added configurable sounds for teleportation countdown and completion (`countdown-sound` and `complete-sound` in `modules/teleportation/config.yml`), supports custom sounds via the zMenu XSound API - Added warp lookup cache with O(1) HashMap for improved performance [#239](https://github.com/Maxlego08/zEssentials/pull/239) - Fixed home deletion from donut GUI showing "The home ? does not exist." — `/delhome` now opens the confirmation GUI when `homeDeleteConfirm` is enabled - Fixed cancelled TPA requests still being accepted — `/tpacancel` now properly removes the request from the target player's incoming requests - Fixed vault admin command permission check bypassed for admin access - Fixed chat URL pattern not matching URLs with special characters (`~`, `+`, `#`) - Fixed chat link transform regex replacement error with special characters

- Added `/itemframe` command (`/iframe` alias), toggles visibility of the item frame you're looking at - Added Death Message module (`modules/death_message/config.yml`): - Three modes: DISABLE (no messages), DEFAULT (vanilla), CUSTOM (configurable) - Support for player kills, vanilla mobs, and MythicMobs creatures - Custom messages per death cause (FALL, DROWNING, FIRE, LAVA, etc.) - Random message selection when multiple messages are configured - Placeholders: `%player%`, `%displayName%`, `%killer%`, `%mob%`, `%cause%`, `%weapon%` - Permission `essentials.silent.death` for silent deaths - `/deathmessage` command to toggle death message visibility (`/dm`, `/deathmsg` aliases) - Added MythicMobs hook for custom mob death messages - Added `/tptoggle` command to toggle receiving teleport requests [#226](https://github.com/Maxlego08/zEssentials/pull/226) - Added TPA queue system - accept/deny all requests at once [#228](https://github.com/Maxlego08/zEssentials/pull/228) - Added weapon display in death messages with hover event [#229](https://github.com/Maxlego08/zEssentials/pull/229) - Fixed Discord pings from Minecraft chat - prevents @everyone and @here mentions [#227](https://github.com/Maxlego08/zEssentials/pull/227) - Fixed first spawn not working reliably - now uses `hasPlayedBefore()` for accurate detection - Added all missing messages in all language files (EN, FR, DE, ES, IT, NL)

- Changed `enable-cooldown-bypass` default value to `true` in `config.yml` - Added PayToggle placeholders: - `%zessentials_user_is_pay_disabled%` Returns true if the player has disabled payments (paytoggle) - `%zessentials_user_pay_status%` Returns the configured placeholder text for pay status - Added PayToggle placeholder configuration in `modules/economy/config.yml`: - `paytoggle-placeholder-enabled` - Text shown when pay is enabled - `paytoggle-placeholder-disabled` - Text shown when pay is disabled - Fixed permission registration conflict when reloading - now removes existing permission before re-registering - Fixed duplicate player name detection - Mojang API lookup now only runs in online mode to prevent issues on offline servers

- Updated zMenu to version 1.1.0.9 - Added `force-commands` option in `config.yml`, allows commands to work even if their module is disabled - Added automatic messages module (`modules/automessage/config.yml`), broadcasts configurable announcements at intervals with sequential or random order - Added RTP cooldown configuration with permission-based overrides in `command-cooldowns` - Fixed duplicated users in database when a player changes their name - Fixed `/endersee` error handling with proper error message (`COMMAND_ENDERSEE_ERROR`) - Fixed `/endersee` offline permission check returning wrong result type - Fixed `/home-list` admin command displaying wrong message when the player has no homes - Fixed user lookup query to sort by `updated_at` for correct results with duplicate names - Fixed build compatibility with Java 25 by applying `options.release = 21` to all subprojects - Added 66 new placeholders across 3 categories: ### Nearest Player Placeholders - `%zessentials_nearest_player_name%` Returns the name of the nearest visible player - `%zessentials_nearest_player_distance%` Returns the distance to the nearest player - `%zessentials_nearest_player_direction%` Returns the direction arrow (↑↗→↘↓↙←↖) to the nearest player ### Player Placeholders - `%zessentials_player_health%` Returns the player's current health - `%zessentials_player_max_health%` Returns the player's max health - `%zessentials_player_health_rounded%` Returns the player's health rounded to nearest integer - `%zessentials_player_absorption%` Returns the player's absorption hearts - `%zessentials_player_food_level%` Returns the player's food level - `%zessentials_player_saturation%` Returns the player's saturation level - `%zessentials_player_exhaustion%` Returns the player's exhaustion level - `%zessentials_player_level%` Returns the player's experience level - `%zessentials_player_exp%` Returns the player's experience progress (0.0 to 1.0) - `%zessentials_player_exp_percentage%` Returns the player's experience progress as percentage - `%zessentials_player_total_exp%` Returns the player's total experience points - `%zessentials_player_exp_to_level%` Returns the experience required for the next level - `%zessentials_player_displayname%` Returns the player's display name - `%zessentials_player_uuid%` Returns the player's UUID - `%zessentials_player_locale%` Returns the player's client locale - `%zessentials_player_client_brand%` Returns the player's client brand name - `%zessentials_player_gamemode%` Returns the player's game mode - `%zessentials_player_is_flying%` Returns true if the player is currently flying - `%zessentials_player_allow_flight%` Returns true if the player is allowed to fly - `%zessentials_player_is_sneaking%` Returns true if the player is sneaking - `%zessentials_player_is_sprinting%` Returns true if the player is sprinting - `%zessentials_player_is_sleeping%` Returns true if the player is sleeping - `%zessentials_player_is_op%` Returns true if the player is operator - `%zessentials_player_is_dead%` Returns true if the player is dead - `%zessentials_player_is_swimming%` Returns true if the player is in water - `%zessentials_player_is_blocking%` Returns true if the player is blocking with a shield - `%zessentials_player_is_gliding%` Returns true if the player is gliding with elytra - `%zessentials_player_ping%` Returns the player's ping in milliseconds - `%zessentials_player_colored_ping%` Returns the player's ping with color based on quality - `%zessentials_player_fly_speed%` Returns the player's fly speed - `%zessentials_player_walk_speed%` Returns the player's walk speed - `%zessentials_player_remaining_air%` Returns the player's remaining air in ticks - `%zessentials_player_max_air%` Returns the player's maximum air in ticks - `%zessentials_player_compass%` Returns the player's compass direction (N, NE, E, SE, S, SW, W, NW) - `%zessentials_player_yaw%` Returns the player's yaw rotation - `%zessentials_player_pitch%` Returns the player's pitch rotation - `%zessentials_player_first_played%` Returns the date when the player first joined - `%zessentials_player_last_played%` Returns the date when the player last joined - `%zessentials_player_ticks_lived%` Returns the number of ticks the player has lived - `%zessentials_player_empty_slots%` Returns the number of empty inventory slots - `%zessentials_player_item_in_hand%` Returns the material type of the item in main hand - `%zessentials_player_item_in_offhand%` Returns the material type of the item in off hand - `%zessentials_player_world_time%` Returns the time of the player's world in ticks - `%zessentials_player_world_time_12%` Returns the world time in 12-hour format - `%zessentials_player_world_time_24%` Returns the world time in 24-hour format - `%zessentials_player_world_weather%` Returns the weather of the player's world - `%zessentials_player_has_bed%` Returns true if the player has a respawn location set - `%zessentials_player_bed_world%` Returns the world name of the player's respawn location - `%zessentials_player_bed_x%` Returns the X coordinate of the player's respawn location - `%zessentials_player_bed_y%` Returns the Y coordinate of the player's respawn location - `%zessentials_player_bed_z%` Returns the Z coordinate of the player's respawn location ### Server Placeholders - `%zessentials_server_online%` Returns the number of online players - `%zessentials_server_max_players%` Returns the maximum number of players - `%zessentials_server_safe_online%` Returns the number of non-vanished online players - `%zessentials_server_unique_joins%` Returns the total number of unique players - `%zessentials_server_tps%` Returns the server TPS (1 minute average) - `%zessentials_server_tps_5%` Returns the server TPS (5 minute average) - `%zessentials_server_tps_15%` Returns the server TPS (15 minute average) - `%zessentials_server_tps_colored%` Returns the server TPS with color indicator - `%zessentials_server_free_memory%` Returns the free memory in MB - `%zessentials_server_max_memory%` Returns the max memory in MB - `%zessentials_server_used_memory%` Returns the used memory in MB - `%zessentials_server_total_memory%` Returns the total allocated memory in MB - `%zessentials_server_world_players_<world>%` Returns the number of players in a specific world - `%zessentials_server_world_time_<world>%` Returns the time of a specific world in ticks - `%zessentials_server_world_weather_<world>%` Returns the weather of a specific world ### User Placeholders - `%zessentials_user_is_vanished%` Returns true if the player is vanished - `%zessentials_user_is_frozen%` Returns true if the player is frozen - `%zessentials_user_is_ban%` Returns true if the player is banned - `%zessentials_user_ban_reason%` Returns the ban reason - `%zessentials_user_ban_duration%` Returns the remaining ban duration in seconds - `%zessentials_user_ban_duration_formatted%` Returns the remaining ban duration formatted - `%zessentials_user_mute_reason%` Returns the mute reason - `%zessentials_user_fly_formatted%` Returns the remaining fly time formatted - `%zessentials_user_afk_duration%` Returns the AFK duration in seconds - `%zessentials_user_afk_duration_formatted%` Returns the AFK duration formatted - `%zessentials_user_home_list%` Returns a comma-separated list of home names - `%zessentials_user_home_<index>%` Returns the home name by index (1-based) - `%zessentials_user_home_<index>_<w/x/y/z>%` Returns the home location info by index - `%zessentials_user_vote_offline%` Returns the number of offline votes - `%zessentials_user_pm_recipient%` Returns the name of the last private message recipient

- Updated zMenu to version 1.1.0.8 - Added /lightning command to strike players with lightning - Added * argument for /heal and /feed commands to target all players - Added player name tab completion for /heal and /feed commands - Added relative directions (north, south, etc.) to /near command - Added smooth time transition for /day and /night commands - /feed command now restores saturation - /ext command can now target other players - Fixed temporary fly when changing world through portals - Fixed personal time from progressing

Added NMS support for Minecraft 1.21.9, 1.21.10 and 1.21.11 Added configurable join MOTD Fixed somes messages Fixed webhook verification when discord module is disable