VeilMineX

# VeilMineX **VeilMineX** is a server-side Minecraft protection plugin built for server owners who want **Anti-Xray**, **mining intelligence**, and **lightweight anti-cheat tools** in one clean plugin. It helps protect your server economy by hiding valuable blocks from X-ray users, tracking suspicious mining patterns, detecting impossible block interactions, and giving staff a simple dashboard to monitor alerts and player activity. VeilMineX is designed for **Paper, Spigot, Purpur, and Folia-style servers**, with support planned for modern Minecraft versions including **1.20.x**, **1.21.x**, and **26.1.2**. It is built for **Java 17+** servers. --- ## Features ### Anti-Xray Protection VeilMineX can hide valuable blocks from X-ray resource packs and hacked clients using packet-based obfuscation. Supported protection ideas include: * Ore hiding * Fake block replacement * Per-world Anti-Xray profiles * Nether and Overworld protection * Hidden chest/barrel/spawner support * Proximity-based reveal * Configurable reveal radius * Round reveal mode using sphere distance * Safe fallback if packet support is unavailable The plugin does **not permanently change your world blocks**. It only changes what each player sees. --- ## Mining Intelligence VeilMineX does more than just hide ores. It also watches for suspicious mining behavior. It can track: * High-value ore mining rate * Diamond and ancient debris patterns * Direct tunnel-to-ore behavior * Suspicious ore ratios * Mining reach problems * Through-wall mining attempts * Fast break or nuker-like behavior This helps staff investigate possible X-ray users instead of relying only on instant bans. --- ## Lightweight Anti-Cheat Checks VeilMineX includes lightweight checks focused mainly on mining and block interaction. Included check types: * Mining reach * Mining angle * Fast break * Nuker * Fast place * Scaffold * Ghost hand * Ore path analysis * Basic speed sanity * Basic fly sanity * NoFall sanity By default, VeilMineX is designed to be **conservative**. It logs and alerts first instead of instantly banning players. --- ## Web Admin Panel VeilMineX includes an optional web panel for server administrators. The web panel can show: * Online players * Recent alerts * Player suspicion scores * Violation history * Anti-Xray status * Cache statistics * Mining reports * Compatibility status * Enabled checks * Plugin settings Default web panel settings: ```yml host: 127.0.0.1 port: 8765 ``` The admin token is generated on first startup. Check your console or `plugins/VeilMineX/web.yml`. For security, the web panel is local-only by default. Change the host manually only if you know what you are doing. --- ## Compatibility VeilMineX is designed for: * Paper * Spigot * Purpur * Folia-style servers * Minecraft 1.20.x * Minecraft 1.21.x * Minecraft 26.1.2 * Java 17+ Optional plugin support: * ProtocolLib * PlaceholderAPI * LuckPerms * DiscordSRV * Floodgate / Geyser * ViaVersion * CoreProtect **Note:** Packet-based Anti-Xray requires ProtocolLib or another supported packet provider. If no packet provider is installed, VeilMineX will still load, but Anti-Xray packet hiding will be disabled. --- ## Commands ### Main Commands ```text /veilmine ``` Shows the main help menu. ```text /veilmine status ``` Shows plugin status, Anti-Xray status, anti-cheat status, web panel status, cache information, and loaded modules. ```text /veilmine reload ``` Reloads configuration files safely. ```text /veilmine compat ``` Shows server compatibility information, including Minecraft version, Java version, server type, packet provider, and enabled features. ```text /veilmine panic ``` Toggles panic mode. Panic mode disables punishments but keeps logging and alerts active. --- ### Alert Commands ```text /veilmine alerts ``` Toggles staff alerts for yourself. ```text /veilmine verbose ``` Toggles verbose alert mode. --- ### Player Investigation Commands ```text /veilmine inspect <player> ``` Opens a player inspection GUI with violation history, mining data, suspicion score, and recent alerts. ```text /veilmine report <player> ``` Generates a mining and violation report for a player. ```text /veilmine clearvl <player> ``` Clears a player’s violation level. You can clear all checks or only one specific check. ```text /veilmine exempt <player> <seconds> <reason> ``` Temporarily exempts a player from checks. Useful for testing, staff actions, or custom events. --- ### Anti-Xray Commands ```text /veilmine antixray test ``` Runs an Anti-Xray diagnostic test. It checks packet support, hidden blocks, replacement palettes, world height, invalid materials, cache status, and reveal settings. ```text /veilmine cache clear ``` Clears the Anti-Xray cache. ```text /veilmine cache stats ``` Shows cache hit rate, cache size, and obfuscation performance. --- ### Web Panel Commands ```text /veilmine web status ``` Shows whether the web