AntiXray

AntiXray is a compact Fabric mod that helps server owners effectively combat the use of X-ray clients by players.

Configuration Settings

# Default values
enabled = false

# World-specific parameters
[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"]

Configuration Parameters Description

enabled - activates X-ray protection in the specified world when set to true

engineMode - defines the system operation mode (1, 2, or 3), details in [Operation Modes](#Operation Modes)

maxBlockHeight - sets the maximum height at which blocks will be hidden

updateRadius - sets the distance from visible blocks where masking begins (recommended to increase if players see fake ores)

lavaObscures - enables hiding blocks located next to lava

hiddenBlocks - list of blocks to hide (Mode 1) or blocks used for masking (Modes 2/3)

replacementBlocks - blocks that will be hidden but not used as fake blocks (only for Modes 2/3)

Blocks and block tags can be marked with prefix ! to exclude from the list. Rules are applied from left to right, exclusions should be specified after additions. (since version 1.4.10)

Operation Modes

Information	Image
Protection disabled: For comparison
Mode 1: Replaces fully hidden blocks from hiddenBlocks with blocks from replacementBlocks
Mode 2: Replaces all blocks from hiddenBlocks and replacementBlocks with random blocks from hiddenBlocks
Mode 3 (recommended): Works similarly to mode 2, but better suited for slow connections

View for honest players: Regular players won't notice changes when this mod is installed (except in cases of high ping or massive block changes, such as during explosions)

Custom Dimensions

To configure protection in custom dimensions, specify the dimension identifier as follows: ["custom:cool_world"]

For Mod Developers

Ore blocks added to the #antixray:hidden_only_ores tag will be hidden in the world but not used as fake ores. This is useful if your ore has effects, such as particles or sounds, that could cause problems. (since version 1.4.10)

About the Project

This mod is a port of Paper's Async Anti Xray Patch from version 1.17 and its 1.14 patch for network code, adapted for Fabric and Forge