[INDL] Xray Detected: The Ultimate Resource Pack Guardian

Stop cheaters in their tracks! INDL Xray Detected is a powerful, lightweight anti-cheat solution designed to keep your server fair by detecting X-Ray resource packs in real-time.

🚀 Why choose INDL Xray Detected?

Unlike simple name-checkers, this mod performs a deep scan of the client's resource pack structure. Even if a player renames their X-Ray pack to "Faithful" or "Default", our engine will find the hidden transparent textures and suspicious models.

🔍 Advanced Detection Engine

• JSON Model Analysis: Identifies hidden /xray/ folders and transparent model definitions.
• Blockstate Surveillance: Scans for redirects to illegal transparent models.
• Smart Transparency Check: Analyzes PNG files for suspicious transparency on solid blocks like Stone, Deepslate, or Dirt.
• SHA-256 Hash Database:** Instantly detects known X-Ray textures by their unique hash signature.
• pack.mcmeta Analysis:** Scans pack descriptions for suspicious keywords like "xray", "cheat", or "wallhack".
• Deep Mod Support: Ready for the most popular mods including Aether, Biomes O' Plenty, and Create.

⚡ Key Features

• ✅ Automatic Scans: Runs instantly when a player joins and at configurable intervals.
• ✅ Real-Time Staff Alerts: Detailed notifications for OPs with the exact reason for detection.
• ✅ Bypass Proof: Detects X-Ray regardless of the filename.
• ✅ Zero Lag: Optimized code with async scanning and smart caching.
• ✅ Fully Configurable: Customize keywords, whitelist trusted packs, and set scan times.
• ✅ Progressive Strike System: Give players fair warnings before kick/ban.
• ✅ Smart Scan Cache: Avoid re-scanning unchanged packs for better performance.
• ✅ Global Statistics: Track total scans, detections, kicks, and bans.
• ✅ Admin Scan Command: Force a rescan on any player instantly.
• ✅ Rate Limiting: Prevents report spam and DoS attacks.

� SHA-256 Hash Detection (NEW in v1.1.0)

Each texture has a unique "fingerprint" called a SHA-256 hash. Even if a cheater renames their X-Ray pack, the hash remains the same!

stone.png (transparent xray texture) → Hash: "a3f8b2c1..."
piedra.png (same file renamed)       → Hash: "a3f8b2c1..." ✅ DETECTED!

Detection Flow

Texture Found
      ↓
Calculate SHA-256 Hash
      ↓
Exists in Database?
      ↓           ↓
     YES          NO
      ↓           ↓
🔴DETECTED🔴    Analyze Transparency
                  ↓
                 Is Transparent?
                  ↓
                  YES → Add hash + 🔴DETECTED🔴
                  NO  → ✅ OK

Self-Learning Database 🧠

When a suspicious transparent texture is detected, its hash is automatically added to the database. Next time, it's detected instantly without image analysis!

Custom Hashes

You can add your own hashes to: config/xraydetected/known_hashes.txt

# Format: hash,description
a3f8b2c1d4e5f6789...,Popular Xray Pack v2
b7c9d0e1f2a3b4c5...,Stone Transparent Texture

Performance Comparison

Without Hash DB: Analyzes every pixel (50-100 ms per texture, CPU intensive).

With Hash DB: Compares 64-character string (0.1 ms per texture, nearly no impact).

�🛡️ Progressive Strike System (NEW in v1.1.0)

Instead of immediate punishment, the mod can use a fair warning system:

Strikes reset automatically after a configurable time period (default: 1 week).

🛠️ Commands & Permissions

Note: All commands require OP Level 2 or higher.

⚙️ Configuration

File Path: config/xraydetected-common.toml

The mod is highly customizable. You can decide if you only want to receive alerts or if the mod should take automatic action against cheaters.

[detection]
keywords = ["xray", "x-ray", "ore-finder", "cheat", "fullbright", "wallhack"]
whitelist = ["raytracing", "rtx", "seus", "bsl"]
scanPackContent = true
checkIntervalMinutes = 5
useHashDatabase = true       # Detect known xray hashes instantly
analyzePackMcmeta = true     # Scan pack descriptions for suspicious keywords

[performance]
maxZipEntries = 5000         # Limit ZIP scan depth (prevents lag from malicious packs)
useScanCache = true          # Cache results to avoid redundant scans

[actions]
notifyAdmins = true          # Alert OPs in real-time
autoKick = false             # Automatically kick the player
autoBan = false              # Automatically ban the player (USE WITH CAUTION!)
actionDelaySeconds = 10

[strikes]
useStrikeSystem = true       # Enable progressive warnings
strikesBeforeKick = 2        # Strikes needed for auto-kick
strikesBeforeBan = 3         # Strikes needed for auto-ban
strikeResetHours = 168       # Reset strikes after 1 week

[logging]
logToFile = true
logToConsole = true

📊 Global Statistics (NEW in v1.1.0)

Track your server's security with /xraydetected stats:

• Total scans performed
• Total detections
• Total kicks & bans
• Most frequently detected packs
• Daily statistics

⚠️ Important Notes

• Players must have the mod installed client-side for scanning to work.
• The mod acts as a "Trust System" for your community.
• False positives are rare and can be easily handled via the whitelist in the config file.
• v1.1.0 requires deleting your old config file to generate the new options.