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

• 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