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.
How to install
- Download and install Paper 1.20.
- 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 default config below).
- See also: Recommended settings below.
- 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.
Demo
Default config
Recommended settings
All settings are documented and explained in the default config file above. Before configuring the plugin you should enable Paper Anti-Xray using engine-mode: 1. Optionally (especially for testing) you can increase the max-block-height. After configuring Paper Anti-Xray you can configure the plugin using the following settings for example.Optimized
(Faster, but worse gameplay experience and less protection.)
YAML:
settings:
anti-xray:
update-ticks: 1
ms-per-ray-trace-tick: 50
# Adjust to available (ideally unused) CPU threads.
ray-trace-threads: 2
world-settings:
default:
anti-xray:
ray-trace: true
ray-trace-third-person: false
ray-trace-distance: 64.0
rehide-blocks: false
rehide-distance: .inf
max-ray-trace-block-count-per-chunk: 30
ray-trace-blocks:
# You can add further blocks here,
# but the max-ray-trace-block-count-per-chunk setting may need to be adjusted.
- chest
- diamond_ore
- deepslate_diamond_ore
- emerald_ore
- deepslate_emerald_ore
- gold_ore
- deepslate_gold_ore
- lapis_ore
- deepslate_lapis_ore
- spawner
# Adjust world name.
world_nether:
anti-xray:
# Note that ancient_debris never generates naturally exposed to air.
# Normal engine-mode: 1 is sufficient, disable ray tracing in the nether.
ray-trace: false
# Adjust world name.
world_the_end:
anti-xray:
ray-trace: false
More expensive
(Slower, but better gameplay experience and more protection.)
YAML:
settings:
anti-xray:
update-ticks: 1
ms-per-ray-trace-tick: 50
# Adjust to available (ideally unused) CPU threads.
ray-trace-threads: 2
world-settings:
default:
anti-xray:
ray-trace: true
# Be aware that this is about three times as resource intensive.
ray-trace-third-person: true
ray-trace-distance: 80.0
rehide-blocks: true
rehide-distance: 76.0
max-ray-trace-block-count-per-chunk: 60
ray-trace-blocks:
# You can add further blocks here,
# but the max-ray-trace-block-count-per-chunk setting may need to be adjusted.
- chest
- diamond_ore
- deepslate_diamond_ore
- emerald_ore
- deepslate_emerald_ore
- gold_ore
- deepslate_gold_ore
- lapis_ore
- deepslate_lapis_ore
- mossy_cobblestone
- spawner
# Adjust world name.
world_nether:
anti-xray:
# Note that ancient_debris never generates naturally exposed to air.
# Normal engine-mode: 1 is sufficient, disable ray tracing in the nether.
ray-trace: false
# Adjust world name.
world_the_end:
anti-xray:
ray-trace: false
