🚀 UltraServers Relaunch We're thrilled to announce the relaunch of our service with a brand-new, streamlined panel designed to enhance your gaming experience. Join our Discord for more information, lifetime discounts and to take part in our $175 raffle to win Steam gift cards.
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 theconfig/
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 thepaper.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
fromfalse
totrue
. - 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