JakesEssentials - StaffHelper Module v1.0.3 Update Notes

This update introduces command grouping under the /jakesessentials root command, separating them into staffhelper and general categories, while keeping direct root-level commands available based on config. It also integrates vanish visibility rules into the /near search.

1. Grouped and Root-Level Command Registration

• Grouped Command Hierarchy: All general utility and staff helper commands are now mounted as subcommands under the main /jakesessentials root namespace:
  • General Subcommands (/jakesessentials general <command>): Includes fly, feed, heal, spawn, setspawn, tpa, tpaccept, tpreject, tpahere, rtp, rules, msg, reply, r, warp, setwarp, delwarp, warps, listwarps.
  • Staff Helper Subcommands (/jakesessentials staffhelper <command>): Includes mute, unmute, player-info, punishment-history, warn, invsee, endersee, near, vanish, freeze, unfreeze, tempban, unban, ban, kick.
  • These subcommands are always registered and available to authorized users, even if the individual root-level command is disabled in the config.
• Root-Level Commands (Aliases): Direct root-level commands (e.g., /tpa, /feed, /rules, /mute, /msg, /reply, /r, /warp, /setwarp, /delwarp, /warps, /listwarps) remain active on the server only if enabled in jakesessentials.toml.

2. Help Command

• Help Command (/jakesessentials help): Fired dynamically based on the calling user's actual permission levels. It scans all subcommands and outputs a clean, color-coded list of all essentials commands they have permission to execute.
  • Hovering over a command shows a description of its parameters and features.
  • Clicking a command auto-suggests/fills the command in the chat box, stripping arguments to make it easy to start typing.

3. Private Messaging System

• Messaging Commands: Added /msg {player} {message} (with /w and /tell aliases) and /reply {message} (with /r alias) commands.
  • Vanish Privacy: Normal players cannot /msg vanished staff members unless they hold the command.jakesessentials.staffhelper.vanish.cansee permission (it fails with a "Player not found" error to preserve secrecy).
  • Mute Restrictions: If a player is muted, they are blocked from using /msg completely. By default, they can still use /reply or /r to respond, which can be toggled via the new allowReplyWhileMuted configuration option.
  • Permission Nodes: Standardized under command.jakesessentials.msg (granted to players by default).
  • Config Toggles: Can be disabled globally using the msg toggle in the config under the disabled commands category.

4. Interactive Confirm, Chat Prompts, & Rules Navigation Update

• Confirmation Commands: Click-to-confirm triggers sent to staff members (such as confirming warns, mutes, tempbans, bans, or freezes) have been updated to run their respective subcommands under /jakesessentials staffhelper.
• Teleport Requests: Accept/Reject prompts and button actions for /tpa and /tpahere requests now correctly invoke /jakesessentials general tpaccept and /jakesessentials general tpreject.
  • Simplified Message Format: Condensed the TPA request message to a single line: PLAYER has requested to teleport to you. [Accept] [Reject].
  • Button Hover Commands: Hovering over the [Accept] or [Reject] buttons now displays the exact command it will execute (e.g., /jakesessentials general tpaccept PLAYER).
  • Vanish Privacy: Players cannot /tpa or /tpahere to a vanished player unless they hold the command.jakesessentials.staffhelper.vanish.cansee permission (it fails with "Player not found"). However, normal players can still accept or reject TPA requests sent from a vanished player.
• Instructional Navigation: Help messages (like rules page footer tips and spawn setup errors) have been updated to direct players to /jakesessentials general rules <page> and /jakesessentials general setspawn.
• Rules Page Navigation Buttons: Added interactive Previous and Next page buttons in the chat footer of the /rules / /jakesessentials general rules output. Running the command without arguments opens page 1 by default.

5. Staff Helper Updates

• Player Info First Joined Fallback: In the /player-info command output, the first join date fallback is N/A when no timestamp is present in the player data file.
• First Join Initialization: When a player logs in and has no recorded first join timestamp (e.g. legacy players or new players), their current login time is saved as their firstJoined timestamp, ensuring it is tracked going forward.

6. Vanish System Enhancements

• Instant Invisibility: Toggling vanish will now instantly hide the player on nearby clients without requiring a relog, by broadcasting direct ClientboundRemoveEntitiesPacket packets.
• Complete Silence: All sounds originating from or near a vanished player (including footsteps, block placing/breaking, eating, chest opening/closing, and entity interaction sounds) are intercepted and canceled on the server, ensuring complete silence for other players.
• Vanish Join/Leave Alerts: Toggling /vanish now broadcasts a fake leave message, and toggling it off broadcasts a fake join message (respecting custom messages configured in JakesEssentials-common.toml or using vanilla game formats).
• Vanish Can See Permission: Added a new permission node command.jakesessentials.staffhelper.vanish.cansee (defaulting to level 2 / admin). Players with this permission can see vanished players in the /near command results, the tab list, and as visible character models in-game.

7. Persistent Warp System

• Warp Commands: Added /warp {name}, /setwarp {name}, /delwarp {name}, and /warps / /listwarps commands.
  • Dynamic Command Registration: Mounts warp commands via the FML RegisterCommandsEvent and registers them as subcommands under the /jakesessentials general tree.
  • Persistent JSON Storage: Cached warp locations are persisted automatically in serverconfig/JakesEssentials/warps.json.
  • Clickable Chat Interface: /warps and /listwarps output a list of available warps. Hovering over a warp shows its coordinates and dimension, while clicking triggers teleportation.
  • Config Toggles & Settings: Each command can be disabled individually. Added a configurable defaultWarpCooldownSeconds setting.
  • Dynamic Permission & Cooldown Gating:
    • Warp Access Permissions: Added permission nodes jakesessentials.warp.{name} and wildcard jakesessentials.warp.*. To support both vanilla servers and modded servers with LuckPerms, these nodes dynamically default to false when a custom manager (like LuckPerms) is active (preventing unauthorized player access) and fallback to true on vanilla servers.
    • Granular Cooldown Node Resolution: Integrates with LuckPerms (via reflection) to check for custom player cooldown nodes (jakesessentials.warp.{name}.cooldown.{seconds} or jakesessentials.warp.cooldown.{seconds}). Bypassing cooldowns is supported via jakesessentials.warp.bypasscooldown.
  • Reload Support: Triggering a config reload via /jakesessentials reload clears cached warp data, forcing a clean reload of config and warp positions from disk.

8. Punishment History Clear Command

• Clearing Commands: Added subcommands under /punishment-history to clear moderation histories:
  • Global Clear: /jakesessentials staffhelper punishment-history clear (all / <time> <before/after>)
  • Per-Player Clear: /jakesessentials staffhelper punishment-history <player> clear (all / <time> <before/after>)
• Time-Based Filtering:
  • before: Clears all history entries older than the specified duration (e.g. 30d before = clears entries older than 30 days).
  • after: Clears all history entries from the specified duration up to the current time (e.g. 7d after = clears entries recorded in the last 7 days).
• Format Validation: Automatically pre-validates time/duration inputs (e.g. 30d, 12h, 45m) prior to executing modifications.
• Permissions: Gated behind a dedicated administrative permission node command.jakesessentials.staffhelper.punishment-history.clear (defaults to Level 2 / OP).