Skip to content

Commands

All commands are under /raytraceantixray. Tab-completion suggests subcommands you have permission for.

/raytraceantixray reload
Permission:raytraceantixray.command.raytraceantixray.reload
Reloads config.yml and reapplies ray-trace scheduling, world controllers, and online player tasks.
  • Does not replace a restart after JAR, PacketEvents, or Paper Anti-Xray changes.
  • Chunk block lists rebuild only when chunks are resent — have players reconnect if obfuscation looks wrong.
/raytraceantixray reminder
Permission:raytraceantixray.reminder
Shows whether Paper Anti-Xray is compatible with every loaded world where RayTraceAntiXray is enabled. If setup is required, the response includes a clickable link to the setup guide.
/raytraceantixray reminder dismiss
Permission:raytraceantixray.reminder
Disables join and startup setup reminders for the whole server. The choice is stored in plugins/RayTraceAntiXray/reminder.yml and does not modify either plugin's main configuration.
/raytraceantixray reminder enable
Permission:raytraceantixray.reminder
Enables Paper Anti-Xray setup reminders again and immediately displays the current compatibility status.
/raytraceantixray timings on
Permission:raytraceantixray.command.raytraceantixray.timings.on
Enables per-tick ray batch duration logging to the console. Requires raytraceantixray.command.raytraceantixray.timings as well.
/raytraceantixray timings off
Permission:raytraceantixray.command.raytraceantixray.timings.off
Disables timings output. Also requires the .timings parent node.

Paper Anti-Xray reminder

When a loaded world has plugin ray tracing enabled but Paper Anti-Xray is disabled or does not use engine-mode: 1, RayTraceAntiXray:

  1. Logs the affected world names and setup URL during startup.
  2. Sends players with raytraceantixray.reminder a clickable reminder shortly after they join.

Paper configuration is never changed automatically. Follow the Paper Anti-Xray setup and restart the server to apply it.

Base permission

Bukkit checks raytraceantixray.command.raytraceantixray (declared on the command in plugin.yml) before any subcommand runs.

What reload does

reloadPluginConfiguration() runs on the main thread and:

  1. Reloads config.yml from disk.
  2. Shuts down and recreates the ray-trace thread pool and async tick.
  3. Reapplies ChunkPacketBlockControllerAntiXray on all loaded worlds.
  4. Clears and re-registers all online players.

See Troubleshooting for cases where a full restart is still required.