JakesEssentials - StaffHelper Module v1.0.1 Update Notes

This update introduces players and staff to a brand new teleportation request system (TPA) and a random teleportation system (RTP) with safe coordinate validation and dimension controls.

1. New Commands & Permissions

TPA Commands

RTP Commands

2. Key Details & Features

TPA Teleport Request System

1. Permission Isolation: If a player only has the command.jakesessentials.tpa permission, they cannot execute /tpahere.
2. Accept/Reject Command Access: If a player has either command.jakesessentials.tpa or command.jakesessentials.tpahere, they automatically gain access to both /tpaccept and /tpreject.
3. Interactive Chat buttons: When a teleport request is received, the target player receives an interactive chat message containing clickable [Accept] and [Reject] buttons. Clicking these buttons will automatically execute the corresponding command for that specific player.
4. Timeout Expiration: Teleport requests automatically expire after 120 seconds.
5. Safety Checks: The mod ensures that players cannot teleport to themselves, and it validates that players are online when the teleportation is processed. Momentum is reset upon teleportation.

RTP Random Teleportation System

1. Dimension Configuration: Added rtpAllowedDimensions under the General section of the config. By default, it allows minecraft:overworld, minecraft:the_nether, and minecraft:the_end.
2. Dimension Permissions:
   • A player can only RTP into/in a dimension if that dimension is allowed by the config list, OR if they have command.jakesessentials.rtp.dimension.DIMENSION explicitly set to true.
   • If a dimension's permission node is explicitly set to false (e.g. command.jakesessentials.rtp.dimension.minecraft.the_end = false), they will be barred from using RTP in that dimension, even if it is allowed in the config list.
3. Location Safety Scanner:
   • Searches for a safe location within the target world's world border.
   • Floor must be solid/collidable (not air, water, lava, etc.) and not a hazardous block (e.g., magma blocks, cactus, sweet berry bushes, fire, wither roses).
   • Space for the feet and head must be passable/empty (air, tall grass, flowers, etc.) and free of fluids.
   • Features custom Nether Pocket Finder logic that scans for 2-high air pockets under the ceiling bedrock layer instead of landing the player on top of the Nether roof.

Config Command Disable Options

1. Command Disables: Added new options under General - DisabledCommands in the config to disable commands individually:
   • tpa (disables /tpa, which also suspends accepting/rejecting requests via /tpaccept and /tpreject).
   • tpahere (disables /tpahere, which also suspends accepting/rejecting requests via /tpaccept and /tpreject).
   • rtp (disables /rtp for all variants).