RayTraceAntiXray (fork)

RayTraceAntiXray

RayTraceAntiXray is a Paper / Folia server-side plugin that extends Paper Anti-Xray when using engine-mode: 1.

Paper’s Anti-Xray hides ores based on whether nearby blocks are considered “exposed.” Ores that are open to air (e.g. in caves or on exposed faces) may not be treated as hidden the same way. This plugin adds server-side ray tracing so visibility can be evaluated more tightly for those cases, while still working with Paper’s obfuscation pipeline—not against it.

Requirements

Requirement	Notes
Paper (or Folia)	1.21.11 and 26.1.2, open an issue on github if you want a build for another minecraft version
Anti-Xray engine-mode: 1	Required for the integration model this plugin uses.
PacketEvents	Must be installed on the server; this fork hooks outgoing chunk-related traffic via PacketEvents (not Protocollib).

Installation (recommended order)

1. Install and run a compatible Paper (or Folia) version.
2. Configure Paper Anti-Xray with engine-mode: 1 and restart so settings apply.
3. Install PacketEvents.
4. Install RayTraceAntiXray and edit plugins/RayTraceAntiXray/config.yml as needed.
5. Restart the server after changes. Avoid /reload and avoid enabling/disabling this plugin through plugin managers on a live server — lifecycle and hooks expect a clean restart.

Configuration recommendations

• You can find the Recommended RayTraceAntiXray settings by stonar96 (the orginal plugin owner) here.

Performance notes

• Work scales with player count, view/radius settings, and how busy chunk sending is. Treat CPU usage as normal for this class of plugin.
• Start with conservative ray-trace distance / tick settings and increase only if your hardware and tick times allow it.

Limitations (honest expectations)

• The visibility / culling logic is not a perfect Minecraft client simulation; it trades some accuracy for server performance (same general idea as upstream documentation).
• Reloading this plugin on the fly is not supported — plan for full restarts when updating configuration or the jar.

License

Source is covered by the project LICENSE (typically MIT for upstream code). Third-party downloads must comply with that license and any notices required by its terms.

Statistics

Credits

Original plugin by stonar96 — upstream repository: stonar96/RayTraceAntiXray.