Installation

Requirements

Requirement	Specification
Minecraft / Paper	26.3 (also 26.2 and 26.1.2)
Server Java	21+ (25 recommended for 26.x)
Server software	Paper or Folia-capable Paper fork
Paper Anti-Xray	Enabled with engine-mode: 1 (documentation)
PacketEvents	Required — Modrinth or Spigot/Paper build

PacketEvents is required

RayTraceAntiXray declares depend: packetevents in plugin.yml. The server will not start the plugin without PacketEvents installed.

Do not use /reload

Do not use Bukkit /reload, PlugMan-style hot plug, or enable/disable the JAR on a running server. Chunk controllers and per-player state will desynchronize. Use a full server restart after installing or replacing the plugin JAR.

Installation steps

1. Download

Get the JAR from Modrinth.

2. Install dependencies

1. Stop your server completely.
2. Install PacketEvents into plugins/.
3. Enable Paper Anti-Xray with engine-mode: 1 — use the official Paper preset in config/paper-world-defaults.yml (see Paper Anti-Xray setup).

3. Install RayTraceAntiXray

1. Place RayTraceAntiXray-<version>.jar in plugins/.
2. Start the server (full restart, not /reload).

4. Configure

Edit plugins/RayTraceAntiXray/config.yml. Copy-paste presets from Recommended setup (Paper Anti-Xray + plugin). See Configuration for every key.

On first run the plugin also writes plugins/RayTraceAntiXray/README.txt with command and permission reference.

If a loaded world still needs Paper Anti-Xray setup, the console is warned during startup and operators receive a clickable guide link after joining. The plugin does not edit Paper configuration.

5. Verify

Run /plugins in console. RayTraceAntiXray should appear with a green status alongside PacketEvents.

Tuning reference

Production presets (Paper + plugin): Recommended setup.

Updating

1. Stop the server.
2. Replace the old .jar with the new one.
3. Start the server (full restart).

Use /raytraceantixray reload only for config.yml changes — not for JAR or dependency updates.

Generated files

File	Description
config.yml	Main plugin configuration
README.txt	In-server command and permission cheat sheet
reminder.yml	Created after dismissing or enabling the Paper Anti-Xray setup reminder