Summary
This release introduces a Particle Fallback Renderer that allows clients below Minecraft 1.19.4 (which lack TextDisplay entity support) to visualize WorldEdit selections via particle effects, Floodgate integration to detect Bedrock players and suppress incompatible CUI messages, bStats metrics collection with display method distribution tracking, automatic re-rendering on world change, and several compatibility fixes.

New Features
Particle Fallback Renderer

• Added a full particle-based rendering system for clients without TextDisplay support (Minecraft < 1.19.4)
• ViaVersion API integration to automatically detect client protocol version and select the appropriate renderer
• Dedicated particle renderers for all region types: ParticleCuboidRenderer, ParticleCylinderRenderer, ParticleEllipsoidRenderer, ParticlePolygonRenderer, ParticlePolyhedronRenderer
• Point cache optimization: region geometry is only re-computed when the selection changes; repeated ticks only send pre-computed particle packets
• Players can manually switch between render modes via /wedisplay render [auto|text|particle|toggle]
• Permission node: worldeditdisplay.use.render to allow switching render modes

Floodgate Support

• Added Floodgate integration to detect Bedrock players on Geyser servers
• CUI messages are automatically suppressed for Bedrock clients to prevent client-side issues
• Soft-dependency on Floodgate (optional; no impact if Floodgate is not installed)

bStats Integration

• Added bStats metrics for anonymous usage statistics
• Display method distribution chart to track TextDisplay vs Particle fallback usage across online players
• Helps guide future development priorities

World Change Handling

• Added PlayerChangedWorldListener to automatically clear stale renders and re-render selections when a player changes worlds
• Eliminates ghost renders left behind in the previous world

Improvements

• Auto-merge new config keys on startup/reload: When upgrading from a previous version, any new configuration options added to config.yml in the plugin JAR are now automatically merged into the existing config file on disk. Existing user values are never overwritten — only genuinely missing keys are added. This eliminates the need to manually edit config.yml after updates. (/wedisplayreload also performs this merge.)
• Updated plugin documentation with new image links
• Improved .gitignore to exclude IDE configuration files
• Enhanced share label position calculation accuracy (see bug fixes)
• Optimized Spigot adventure shading configuration with clearer documentation

Bug Fixes

• fix(render): Corrected shared label position calculation logic for proper visual alignment
• fix(spigot): Downgraded adventure dependencies to 4.17.0 for PacketEvents compatibility on Spigot

Technical & Dependency Updates

• Updated adventure-api from 4.17.0 to 5.1.1
• Updated adventure-key from 4.17.0 to 5.1.1
• Updated adventure-text-minimessage to latest
• Updated adventure-text-serializer-legacy to latest
• Updated adventure-text-serializer-bungeecord to latest
• Added viaversion-api dependency for protocol version detection
• Added floodgate-api dependency for Bedrock player detection
• Added bstats-base dependency for metrics collection
• Added OpenCollab and ViaVersion repository sources

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

• No breaking configuration changes from 2.2.x.
• New config keys (such as particle_fallback.*) are automatically merged into your existing config.yml on first startup after upgrading — no manual edits required.
• New permission worldeditdisplay.use.render is available to control access to /wedisplay render.
• Run /wedisplayreload after upgrading to ensure all new settings are applied.

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

Full Changelog: 2.2.0...2.3.0

Summary
Major release introducing a Selection Sharing System that lets players share their WorldEdit selections with others in real-time, expanded multi-platform support (Paper, Folia, Spigot), a new RegionRenderer abstract base class for a more extensible rendering architecture, and numerous performance improvements with render caching and async operations.

New Features
Selection Sharing System

• Added /wedisplay share command to invite other players to view your selection
• Selections shared in real-time with persistent storage across sessions
• Each shared selection is assigned a unique color generated automatically
• Unused shared colors are released when sharing ends to optimize resources
• Permission-based access control: worldeditdisplay.share required to use share commands
• Share manager configuration is reloadable via /wedisplayreload

RegionRenderer Abstract Base Class

• Introduced RegionRenderer abstract base class for a unified and extensible rendering architecture
• Simplifies adding new region types and customizing render behavior

Multi-Platform Support

• Added official support for Folia (region-threaded scheduling)
• Added official support for Spigot (in addition to Paper)
• Task scheduling is now platform-aware and routes to the correct scheduler automatically

Region Bounding Box & Distance Utilities

• Added bounding box calculation methods to region objects
• Added distance calculation methods between regions and players for range-based optimizations

Improvements
Rendering Performance

• Introduced renderer-level caching to reduce redundant computation
• Name cache logic for shared renders is now correctly invalidated to avoid stale reads
• Clearing a sharer's render now properly releases associated resources
• Render brightness and label position adjustments for improved visual quality

Async Settings I/O

• Player settings are now saved asynchronously to prevent main-thread blocking
• Config saves are deferred to a scheduled task to avoid repeated disk writes during rapid state changes

Thread Safety

• Share request timeout is now stored in a thread-safe mutable field
• Player multi-region map is now returned as an unmodifiable view to protect data integrity

Bug Fixes

• fix(render): Corrected shared render name-cache invalidation logic to prevent unnecessary re-reads
• fix(player): Returned unmodifiable multi-region map to protect internal data from external mutation
• fix(share): Made share request timeout mutable for proper thread-safe handling
• fix(render): Adjusted brightness calculation and label position for better display results

Technical & CI Updates

• Updated GitHub Actions workflow file versions for improved stability
• Added adventure-api exclusion filter to the Spigot Maven profile to prevent class conflicts
• Removed SHARE-DESIGN.md design document (merged into implementation)

System Requirements
Component Requirement
Minecraft 1.20 ~ 1.21.x
Java 21+
Platform Paper / Folia / Spigot
PacketEvents 2.11.1+
WorldEdit Latest stable / FAWE
Configuration Notes

• No breaking configuration changes from 2.1.x.
• A new share section will be generated in config.yml on first launch.
• Run /wedisplayreload after upgrading to apply any new defaults.

Download
Available on GitHub Actions and Modrinth.

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

Full Changelog: 2.1.2...2.2.0