BedrockHeightGuard

BedrockHeightGuard

A server-side height enforcement plugin for Paper and Spigot servers running Geyser with Floodgate. BedrockHeightGuard intercepts movement, block placement, and block breaking events for Bedrock-connected players, clamping their effective Y range to a configurable threshold while leaving Java Edition players completely unaffected. The plugin was designed with BuildTheEarth-style environments in mind, where extended build heights above the standard 320-block limit are common and Bedrock client rendering constraints become a practical problem.

How it works

Bedrock clients connected through Geyser are detected at runtime via the Floodgate API using a reflection-based hook, avoiding a hard compile-time dependency. When a Bedrock player exceeds the configured maximum Y or drops below the configured minimum Y, the plugin intercepts the corresponding event and either redirects the player to a safe position or cancels the action entirely, depending on the configured behavior. All enforcement logic is skipped for Java players, operators holding the bypass permission, or players in non-enforced game modes.

Feature set

• Per-world height limits with global fallback values for both maximum and minimum Y boundaries
• Movement clamping on PlayerMoveEvent and PlayerTeleportEvent with head-rotation optimization to avoid unnecessary processing
• Block placement and block break cancellation above or below the configured range
• Configurable proximity warning sent before the hard limit is reached
• Chat and action bar delivery modes for all player-facing messages
• Per-session first-violation title display
• Staff notification system with a dedicated permission node
• Per-player statistics tracked in memory and persisted to disk across restarts, including limit hits, blocked build actions, and highest Y coordinate reached
• Permission-based bypass for trusted players or staff
• Game mode filtering to exclude specific modes from enforcement
• Optional teleport-on-violation to a fixed safe location instead of position clamping
• Position correction on join if a player logs in outside the permitted Y range
• Full tab-completed administrative command set: reload, info, check, stats, togglewarnings
• Console logging for violation events

Requirements

• Paper 1.21.x or a compatible fork
• Floodgate 2.x alongside Geyser for Bedrock player detection

Compatibility

Tested on Paper and Purpur. Folia compatibility is not guaranteed; scheduled task handling has not been adapted for regionized threading.

Permissions

Node	Default	Description
bteheightfix.admin	op	Access to all administrative subcommands
bteheightfix.reload	op	Permission to reload the configuration
bteheightfix.bypass	op	Exempts the holder from all height enforcement
bteheightfix.notify	op	Receives staff notifications on player violations

---

Not affiliated with the BuildTheEarth project.