WorldEditDisplay 2.3.0 - Particle Fallback Renderer, Floodgate Support & Cross-Version Compatibility

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