AntiXray
A lightweight mod that allows server owners to combat xrayers.
Screenshots




About this Mod
Anti Xray
Anti Xray is a lightweight fabric mod that allows server owners to combat xrayers.
Config
# Default values
enabled = false
# World specific values
[overworld]
enabled = true
engineMode = 3
maxBlockHeight = 256
updateRadius = 2
lavaObscures = false
hiddenBlocks = ["#c:ores", "raw_copper_block", "raw_iron_block", "raw_gold_block", "!#antixray:hidden_only_ores"]
replacementBlocks = ["#antixray:hidden_only_ores", "stone", "deepslate", "andesite", "calcite", "diorite", "dirt", "granite", "gravel", "sand", "tuff", "mossy_cobblestone", "obsidian", "clay", "infested_stone", "amethyst_block", "budding_amethyst", "chest"]
[the_nether]
enabled = true
engineMode = 1
maxBlockHeight = 128
updateRadius = 2
lavaObscures = true
hiddenBlocks = ["ancient_debris", "nether_quartz_ore", "nether_gold_ore", "gold_block", "gilded_blackstone"]
Config option overview
enabled if set to true anti xray will be active in the specified world
engineMode can either be 1, 2 or 3 see [Engine Modes](#Engine Modes)
maxBlockHeight controls the max height at which blocks should get obfuscated
updateRadius controls how many blocks away from shown blocks obfuscation should start (if your players see fake ores
it is recommended to increase this value)
lavaObscures if set to true blocks next to lava will get obscured
hiddenBlocks a list of blocks to hide (Engine mode 1) or a list of blocks to use for obfuscation (Engine mode 2/3)
replacementBlocks is a list of blocks that will be obfuscated, but not used as fake blocks (Engine mode 2/3 only)
Blocks / block tags can be prefixed ! to remove them from the block list.
The rules are applied from left to right, removals should be specified after additions. (since 1.4.10)
Engine Modes
| Info | Image |
|---|---|
| Anti xray disabled: This is just for reference | ![]() |
EngineMode 1: This mode will replace all fully obscured (no air around) blocks from hiddenBlocks with blocks from replacementBlocks |
![]() |
EngineMode 2: This mode will replace all blocks from hiddenBlocks and replacementBlocks with random blocks from hiddenBlocks |
![]() |
| EngineMode 3 (recommended): Works very similar to engine mode 2, but works better with slow connections | ![]() |
Legit player view: Legit players wont notice any changes when this mod is installed (unless they have high ping or modify a lot of blocks at once, eg: explosions)
Custom Dimensions
To configure antixray in custom dimensions, specify the dimension id like this: ["custom:cool_world"]
Mod Developers
Ore blocks added to the #antixray:hidden_only_ores block tag will be hidden from the world, but not used as fake ore.
This can be useful if your ore has effects, such as particles or sounds, that could cause problems. (since 1.4.10)
About
This mod is a port of Papers Async Anti Xray Patch from 1.17 and it's 1.14 patch for networking code, to fabric and forge
Available Versions
How to Install AntiXray on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.2).
Install Mod
Open the mod browser in the dashboard and search for "AntiXray". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.2, 26.2-rc-2, 26.1.2 (+53 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
AntiXray server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.2). You can switch loaders with one click in the panel.
Is AntiXray compatible with fabric and forge and neoforge and quilt?
AntiXray officially supports fabric, forge, neoforge, quilt for Minecraft 26.2, 26.2-rc-2, 26.1.2. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with AntiXray – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if AntiXray consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install AntiXray with just one click on your server.



