Skip to content

Paper plugin for server-side async multithreaded ray tracing to hide ores that are exposed to air using Paper Anti-Xray engine-mode 1.

License

Notifications You must be signed in to change notification settings

stonar96/RayTraceAntiXray

Repository files navigation

RayTraceAntiXray

Paper plugin for server-side async multithreaded ray tracing to hide ores that are exposed to air using Paper Anti-Xray engine-mode 1.

Paper Anti-Xray can't hide ores that are exposed to air in caves for example (see picture below). This plugin is an add-on for Paper Anti-Xray to hide those ores too, using ray tracing to calculate whether or not those ores are visible to players. This plugin can also fully hide block entities such as chests since Minecraft 1.20.6.

RayTraceAntiXray

How to install

  • Download and install Paper 1.21. Folia is supported since Minecraft 1.20.1.
  • Enable Paper Anti-Xray using engine-mode: 1.
  • Download and install ProtocolLib.
  • Download and install RayTraceAntiXray. (For older Minecraft versions, browse the update history.)
  • Configure RayTraceAntiXray by editing the file plugins/RayTraceAntiXray/config.yml.
  • See also: Recommended settings.
  • Note that you should restart your server after each of these steps. Don't enable, disable or reload this plugin on a running server under any circumstances (e.g. using /reload, plugin managers, etc.). It won't work properly and will cause issues.

Known issues

  • Depending on the number of players and config settings, this plugin can be resource intensive. I only recommend using it if you have "unused" CPU threads available on your server in order to minimize the impact on the main thread.
  • The culling algorithm is intentionally not 100% accurate for performance and functional reasons. When in doubt, it is assumed that a block is visible. Thus hidden blocks tend to be revealed rather earlier than late, provided that the server isn't overloaded and doesn't lag. Usually, however, this cannot be abused.
  • There is currently no way to reload this plugin.

Demo

RayTraceAntiXray

License

The LICENSE file applies to the source code of this project. Please don't (re)distribute compiled binary versions of this project or derivative works that are directly usable as intended by this project. Shading or using this project as a library for other purposes is permitted.

About

Paper plugin for server-side async multithreaded ray tracing to hide ores that are exposed to air using Paper Anti-Xray engine-mode 1.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages