Enable Anti-Xray on your Minecraft Paper Server

Join our Discord and be part of our community!

Enable Anti-Xray on your Minecraft Paper Server

In this guide, we will show you how to enable Anti-Xray in the Minecraft PaperMC settings and explain the differences between engine mode 1 and engine mode 2. Following this guide requires you to have PaperMC as your server type.

Access Panel

Login to the panel. See Access the Panel for instructions.
Go to the 1 Servers tab.
2 Then, go into your server.

Navigate to Files

Click on the 1 Files tab on the left-hand side navigation bar.
2 & 3 Locate the /config/paper-world-defaults.yml file.

This file contains the configuration settings for PaperMC.

Open the paper-world-defaults.yml file using the built-in text editor by clicking on it.

Edit Config File

Find the anti-xray: section within the paper-world-defaults.yml file. This section contains the settings for Anti-Xray.
Change the value of enabled from false to true. This will enable the Anti-Xray feature on your server.

anticheat:
  anti-xray:
    enabled: false
    engine-mode: 1
    hidden-blocks:
    - copper_ore
    - deepslate_copper_ore
    - gold_ore

Select Engine Mode

‣

Example images of engine-mode

Decide whether to use engine-mode 1 or engine-mode 2 for your server. Here’s a quick explanation of both modes:

engine-mode: 1: Replaces specified blocks (hidden-blocks) with fake blocks based on the dimension (stone, deepslate, netherrack, or end_stone).
Only ores covered by solid blocks will be hidden.
This mode is less computationally intensive on the client side.
engine-mode: 2: Replaces both hidden-blocks and replacement-blocks with randomly generated hidden-blocks.
Fake ores obstruct the view of real blocks.
This mode may better prevent Xray, but can cause client performance issues (FPS drops) for some players.

1 Set the engine-mode value to your preferred mode (either 1 or 2).
Click the 2 Save Content button to save your changes to the paper-world-defaults.yml file.

Restart the Server

Restart your Minecraft server for the changes to take effect.

With Anti-Xray enabled and configured, your server will now be more secure against players using Xray hacks.
Keep in mind that Anti-Xray is not foolproof, and additional measures (such as anti-cheat plugins) can further help protect your server.

If you require further assistance, you can open a support ticket here.

Feedback and suggestions can be submitted here or further discussed on our Discord server.

Enable Anti-Xray on your Minecraft Paper Server
Access Panel
Navigate to Files
Edit Config File
Select Engine Mode
Restart the Server