WorldGuard 2.0 - v1.2.3 Update Notes

This update introduces commands to manually adjust the vertical limits of a selection. These commands work for both cuboid and polygon selection modes, allowing for precise control of a zone's vertical boundaries.

1. Selection Height Subcommands

Added new options to the /wg selection set command hierarchy to modify selection heights:

• Set Maximum Height: /wg selection set maxheight <height>
  • Sets the maximum Y-boundary of the current selection.
• Set Minimum Height: /wg selection set minheight <height>
  • Sets the minimum Y-boundary of the current selection.

2. Selection Mode Support

• Cuboid Mode:
  • Dynamically updates the Y coordinate of whichever corner position (pos1 or pos2) represents the maximum or minimum Y.
  • Automatically updates the yellow selection particle visualization coordinates in real-time.
• Polygon Mode:
  • Saves the set minimum and/or maximum height values as explicit overrides in the player's active wand selection session.
  • When creating a polygon zone (/wg zones create), the final bounding box's Y limits are adjusted based on these overrides instead of being strictly bound to the terrain coordinates of the clicked polygon vertices.
  • Automatically clamps the yellow selection particle outline height to the set min/max height range, preventing the outline from acting like it is full height (following the player indefinitely) once boundaries are defined.

3. Permissions System Integration

Added standard Forge permission nodes and aliases (supporting both worldguard and worldgaurd spellings) for all commands:

• Wildcard Permission (worldguard.* / worldgaurd.*):
  • Grants access to all /wg and /worldguard commands (defaulting to level 2 / OP).
• Wand Permission (worldguard.wand / worldgaurd.wand):
  • Grants access to the /wg wand command (defaulting to level 2 / OP).
• Plots Command Permission (worldguard.plots / worldgaurd.plots):
  • Allows usage of the player-facing /plots command root and all of its subcommands.
  • Note: Given to all players by default (level 0 / Player), but can be blocked by setting this permission node to false in a permission manager.
• Other Command Nodes:
  • worldguard.reload / worldgaurd.reload
  • worldguard.help / worldgaurd.help
  • worldguard.selection / worldgaurd.selection
  • worldguard.zones / worldgaurd.zones
  • worldguard.teleport / worldgaurd.teleport
  • worldguard.debug / worldgaurd.debug
• Root Restrictions:
  • All /wg and /worldguard commands now require the caller to either be OP, have the wildcard permission, or have at least one valid sub-permission (e.g. worldguard.wand to use /wg wand). Otherwise, the commands are invisible and inaccessible to normal players.

4. Automatic Selection Visualization

• Automatic View Trigger:
  • The selection boundary particle visualization is now automatically enabled as soon as any point or position is set (either by clicking with the WorldGuard Wand or running selection commands like /wg selection set 1|2). Players no longer need to manually toggle /wg selection view to see their active selection boundaries.

5. Polygon Plot Support

Extended the Plot system to fully support non-rectangular (polygon) boundaries:

• Data Model:
  • Added support for 3D polygon plots with customizable height limits (minY and maxY).
  • Added Ray-Casting algorithm for point-in-polygon containment checks.
  • Implemented Separating Axis Theorem (SAT) and segment intersection checks for polygon-polygon overlap validation.
• Plot Creation & Modification:
  • Updated /wg plots create and /wg plots modify commands to handle both cuboid and polygon selections.
  • The creation and modification verification flow now validates that all vertices of the polygon plot lie inside the parent zone's boundaries and do not overlap with any existing plots.
• 3D Selection Visualization:
  • Upgraded the ZoneBoundaryHandler selection renderer to draw a 3D prism wireframe (bottom ring, top ring, and vertical corner lines) instead of a single floating ring when custom minimum and maximum heights are set.

6. Polygon Boundary Protection and Height Alignment

• Stable Point-in-Polygon Check:
  • Replaced integer-based ray-casting containment checks with double-precision checks positioned at block centers (x + 0.5, z + 0.5). This prevents degenerate vertex-intersection cases and guarantees mathematically stable inside/outside determination.
• Edge/Border Protection:
  • Implemented a 2D line segment-to-box intersection algorithm to ensure any block whose 1x1 boundaries intersect a polygon's borders is classified as part of the protected region. This resolves reports of perimeter blocks being left unprotected.
• Consistent Height Overrides:
  • Updated selection height overrides (minHeight and maxHeight) to apply uniformly across both cuboid and polygon modes for zone creation, plot creation, and plot modifications.
  • Adjusted the selection visualization to render boundary limits accurately according to these overrides in all selection modes.
• Selection Get Polygon Support:
  • Upgraded both /wg selection get zone <zoneId> and /wg selection get plot <plotId> commands to support polygon regions.
  • When getting selection from a polygon zone or plot, the system automatically transitions the player's active selection mode to POLYGON, retrieves all defined vertices, sets the dimension, and maps the vertical boundaries as height overrides (minHeight / maxHeight).