JakesEssentials - StaffHelper Module v1.0.2 Update Notes

This update introduces new RTP search behavior options, letting servers select between spawn-based search or world-border-based search, along with RTP cooldowns, bypass permissions, a join message delivery fix, and command parsing corrections.

1. RTP Range from Spawn

• Range from Spawn: RTP can now scan for a safe location within a defined range from the world's spawn point instead of defaulting to the entire world border.
• Config Options (General Section):
  • rtpUseSpawnRange (Boolean): If true, RTP will search for a safe location within a specified range from spawn instead of the world border. Default: true.
  • rtpSpawnRange (Integer): The maximum distance in blocks from the spawn point for RTP. Default: 50000 blocks.
• World Border Safety Clamping:
  • If the configured range or random coordinates fall outside the world border, coordinates are clamped dynamically to stay safely within the world border (leaving a 10-block buffer to prevent players from suffocating or getting stuck).

2. RTP Cooldown & Bypass

• RTP Cooldown: A cooldown has been introduced for players using /rtp to teleport themselves.
• Config Option (General Section):
  • rtpCooldownSeconds (Integer): RTP cooldown in seconds. Use 0 to disable. Default: 30 seconds.
• Bypass Permission:
  • Permission Node: command.jakesessentials.rtp.bypass (Granted to level 2 / admins by default). Players with this permission bypass the RTP cooldown entirely.

3. Join Message Visibility Fix

• Visibility Fix: Resolved an issue where a connecting player could not see their own custom join or first-join message.
• Delivery Mechanism: The custom join message is now broadcast to all online players except the joining player, printed to the server console log, and then sent directly to the joining player's chat after a 1-second delay. This guarantees the joining client has fully loaded the world and initialized its chat HUD, ensuring they see their own welcome message.

4. RTP Command Sibling Registration Fix

• Parser Conflict Resolved: Fixed a command syntax conflict where /rtp {player} failed because Brigadier attempted to parse the username/selector as a Dimension (causing "Unknown dimension" syntax errors).
• Solution: Reordered registration siblings in RtpCommand so the player argument branch is evaluated before the dimension branch. This allows player names/selectors to match properly, while namespace-qualified resource locations (like minecraft:overworld, containing :) naturally fall through to the dimension branch.

5. Permission Node Renames

• Standardized Formats: Renamed key permission nodes to follow consistent hyphenated conventions:
  • command.jakesessentials.staffhelper.playerinfo -> command.jakesessentials.staffhelper.player-info
  • command.jakesessentials.staffhelper.punishmenthistory -> command.jakesessentials.staffhelper.punishment-history

6. Conditional Command Registration (Mod Compatibility)

• No Standalone Registration for Disabled Commands: When commands are configured as disabled via JakesEssentials-common.toml, they are no longer registered at the root command dispatcher level (e.g., /ban, /mute, /near, /rules). This prevents command conflicts with other mods or vanilla overrides.
• Sub-Command Availability: Disabled commands remain fully available under their parent commands /staffhelper (e.g. /staffhelper ban, /staffhelper mute) or /jakesessentials for admins. Execution-time checks have been updated to ensure these sub-commands are not blocked by the disabled configuration flag when executed via /staffhelper or /jakesessentials.