WorldEditDisplay

Summary

WorldEditDisplay 2.4.0 introduces retained line rendering for all supported selection shapes, reducing display-entity churn by reusing unchanged line entities between render passes. This release also strengthens shared-selection cleanup and visibility rules, improves CUI and renderer state handling, refines command permissions and settings validation, and adds a fully discovered JUnit 5 test suite.

New Features

Retained Line Rendering

• Reuses unchanged line shapes across render passes instead of removing and respawning every display entity
• Supports Cuboid, Cylinder, Ellipsoid, Polygon, and Polyhedron selections
• Keys retained lines by geometry and visual style so changed lines are replaced and stale lines are removed correctly
• Keeps fill faces and other transient shapes outside the retained pool so they continue to refresh cleanly
• Rebases display origins when viewers move far enough, with failures isolated per renderer

Expanded Renderer Diagnostics

• Debug output now reports retained, reused, spawned, and removed line statistics
• Added retained-line and total entity counts to make renderer behavior easier to inspect
• Added localized rebase diagnostics in English, Simplified Chinese, and Traditional Chinese

Improvements

Shared Selection Reliability

• Accepted share relationships now remain persisted across player reconnects
• Shared colors are deterministic and cached only while live renderers or labels still reference them
• TextDisplay and particle shared renderers now follow the same active-share, view-all, distance, world, visibility, and renderer-enabled rules
• Stale shared renders and labels are removed when a player is hidden, out of range, offline, in another world, or no longer has a valid selection
• Sharer-triggered push updates now obey the same visibility and distance checks as normal viewer updates
• Cleanup now releases text renderers, particle renderers, labels, colors, and component caches in the correct order

Renderer and CUI State

• Centralized the decision for when the server renderer should consume WorldEdit CUI packets
• Preserved client-side CUI forwarding when server rendering is disabled while continuing to support Bedrock players and particle fallback mode
• Added defensive CUI packet parsing and rate-limited error reporting
• Implemented CUI update events so changed selections are marked dirty and retained renderers refresh correctly
• Renderer state now refreshes consistently after player settings and render-mode changes

Commands, Permissions, and Persistence

• Refined permission routing for render, share, view, hide, list, and label operations
• Users with only the view-hide permission can now access the relevant view command route
• Renderer setting names and boolean values are validated before changes are applied
• Failed player-setting saves remain queued for retry instead of silently discarding unsaved changes
• Improved reload handling and logging for player settings, language files, and configuration state

Bug Fixes

• Fixed shared color and component cache leaks when the final reference was a label
• Fixed label-only references surviving viewer or sharer cleanup
• Fixed view-all selections remaining rendered after leaving the configured loading distance
• Prevented cross-world TextDisplay shares
• Prevented push updates from recreating shared renders for viewers who disabled server rendering
• Avoided removing per-viewer state maps while an update pass was still using them

Technical & Dependency Updates

• Updated EntityLib to 3.3.4+b54a52a-SNAPSHOT
• Added Maven Surefire 3.5.4 so the JUnit 5 suite runs during the standard Maven lifecycle
• Added 30 tests covering CUI parsing and forwarding, CUI updates, settings persistence, permission routing, share persistence, color parsing, and shared-cache cleanup
• Verified both Paper and Spigot build profiles successfully produce shaded 2.4.0 JARs

System Requirements

Component	Requirement
Minecraft	1.20 ~ 1.21.x
Java	21+
Platform	Paper / Folia / Spigot
PacketEvents	2.11.1+
WorldEdit	Latest stable / FAWE
ViaVersion	Optional (used for particle fallback auto-detection)
Floodgate	Optional (used for Bedrock player detection)

Configuration Notes

• No breaking configuration changes from 2.3.1.
• Existing player settings and accepted share relationships remain compatible.
• Run /wedisplayreload after upgrading to reload configuration and language state.

Download

Build artifacts are available from GitHub Actions. The plugin project is also available on Modrinth.

Support

For issues, feature requests, or questions, please open an issue on the GitHub repository.

Full Changelog: 2.3.1...2.4.0