Enable Anti-Xray in your Minecraft Paper server

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

Locate the paper.yml file

• 1 Click on the File Manager tab.
• 2 & 3 Locate the paper-world-defaults.yml which is located inside the config/ folder.
• This file contains the configuration settings for PaperMC.

Open the paper.yml file

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

Locate the anti-xray section

• Find the anti-xray section within the paper.yml file.
• This section contains the settings for Anti-Xray.

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

Enable Anti-Xray

• Change the value of enabled from false to true.
• This will enable the Anti-Xray feature on your server.

enabled: true

Choose the 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.
• Set the engine-mode value to your preferred mode (either 1 or 2).

• These two images are from the paper documentation.

Save and restart the server

• Save the changes you made to the paper.yml file and 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 regarding this article are welcome on our Discord server

• Enable Anti-Xray in your Minecraft Paper server
• Locate the paper.yml file
• Open the paper.yml file
• Locate the anti-xray section
• Enable Anti-Xray
• Choose the engine mode
• Save and restart the server