VeilMineX
VeilMineX 是一款面向服务器管理员的服务端 Minecraft 保护插件,旨在将 Anti-Xray(反透视)、挖矿智能分析 和 轻量级反作弊工具 整合到一个简洁的插件中。
它通过隐藏珍贵方块以抵御 X-ray 用户、追踪可疑挖矿行为、检测不可能的方块交互,并为工作人员提供简单的仪表盘来监控警报和玩家活动,从而帮助保护你的服务器经济。
VeilMineX 专为 Paper、Spigot、Purpur 和 Folia 类服务器 设计,支持包括 1.20.x、1.21.x 和 26.1.2 在内的现代 Minecraft 版本。它要求服务器运行在 Java 17+ 环境下。
功能特性
Anti-Xray 保护
VeilMineX 可以使用基于数据包的混淆技术,从 X-ray 资源包和破解客户端中隐藏珍贵方块。
支持的防护策略包括:
- 矿石隐藏
- 假方块替换
- 按世界配置 Anti-Xray 配置文件
- 下界与主世界的保护
- 隐藏的箱子/ barrel /刷怪笼支持
- 基于距离的显示机制
- 可配置的显示半径
- 使用球体距离计算的圆形显示模式
- 若数据包支持不可用时的安全回退方案
该插件不会永久改变你世界中的方块。它仅改变每个玩家所看到的内容。
挖矿智能分析
VeilMineX 不仅仅只是隐藏矿石。它还监视可疑的挖矿行为。
它可以追踪:
- 高价值矿石的开采速率
- 钻石和远古残骸的分布模式
- 直接挖隧道至矿石的行为
- 可疑的矿石比例
- 挖矿范围异常问题
- 穿墙挖矿尝试
- 快速破坏或类似“核弹”式(nuker)的行为
这有助于工作人员调查可能的 X-ray 用户,而不仅仅是依赖即时封禁。
轻量级反作弊检查
VeilMineX 包含专注于挖矿和方块交互的轻量级检查项。
包含的检查类型:
- 挖矿范围
- 挖矿角度
- 快速破坏
- 核弹式破坏 (Nuker)
- 快速放置
- 脚手架 (Scaffold)
- 幽灵手 (Ghost hand)
- 矿石路径分析
- 基础速度合理性检查
- 基础飞行合理性检查
- 无掉落伤害合理性检查
默认情况下,VeilMineX 的设计原则是保守的。它优先记录日志并发送警报,而不是立即封禁玩家。
Web 管理面板
VeilMineX 包含一个可选的 Web 面板,供服务器管理员使用。
Web 面板可以显示:
- 在线玩家
- 最近的警报
- 玩家嫌疑评分
- 违规历史记录
- Anti-Xray 状态
- 缓存统计信息
- 挖矿报告
- 兼容性状态
- 已启用的检查项
- 插件设置
默认 Web 面板设置:
host: 127.0.0.1
port: 8765
管理员令牌在首次启动时生成。请检查控制台输出或 plugins/VeilMineX/web.yml 文件。
出于安全考虑,Web 面板默认仅限本地访问。除非你知道自己在做什么,否则请勿手动更改主机地址。
兼容性
VeilMineX 专为以下环境设计:
- Paper
- Spigot
- Purpur
- Folia 类服务器
- Minecraft 1.20.x
- Minecraft 1.21.x
- Minecraft 26.1.2
- Java 17+
可选插件支持:
- ProtocolLib
- PlaceholderAPI
- LuckPerms
- DiscordSRV
- Floodgate / Geyser
- ViaVersion
- CoreProtect
注意: 基于数据包的 Anti-Xray 需要安装 ProtocolLib 或其他支持的数据包提供者。如果未安装任何数据包提供者,VeilMineX 仍会加载,但 Anti-Xray 的数据包隐藏功能将被禁用。
命令
主要命令
/veilmine
显示主帮助菜单。
/veilmine status
显示插件状态、Anti-Xray 状态、反作弊状态、Web 面板状态、缓存信息和已加载模块。
/veilmine reload
安全地重新加载配置文件。
/veilmine compat
显示服务器兼容性信息,包括 Minecraft 版本、Java 版本、服务器类型、数据包提供者和已启用的功能。
/veilmine panic
切换恐慌模式。恐慌模式会禁用惩罚措施,但保持日志记录和警报功能活跃。
警报命令
/veilmine alerts
切换你自己的工作人员警报开关。
/veilmine verbose
切换详细警报模式。
玩家调查命令
/veilmine inspect <player>
打开玩家检查 GUI,显示违规历史、挖矿数据、嫌疑评分和最近警报。
/veilmine report <player>
为玩家生成一份挖矿和违规报告。
/veilmine clearvl <player> [check]
清除玩家的违规等级。你可以清除所有检查项的记录,或者仅清除特定的一项。
/veilmine exempt <player> <seconds> <reason>
暂时豁免某玩家免受检查。适用于测试、工作人员操作或自定义事件。
Anti-Xray 命令
/veilmine antixray test
运行 Anti-Xray 诊断测试。它会检查数据包支持、隐藏方块、替换调色板、世界高度、无效材质、缓存状态和显示设置。
/veilmine cache clear
清除 Anti-Xray 缓存。
/veilmine cache stats
显示缓存命中率、缓存大小和混淆性能。
Web 面板命令
/veilmine web status
显示 Web 面板是否正在运行。
/veilmine web url
显示本地 Web 面板 URL。
/veilmine web token
重新生成管理员 Web 令牌。
/veilmine web restart
安全地重启 Web 面板。
调试命令
/veilmine debug chunk
显示你所处区块的 Anti-Xray 调试信息。
/veilmine debug compatibility
显示详细的兼容性调试信息。
权限
veilmine.admin
授予所有管理功能的访问权限。
veilmine.command
允许使用主命令。
veilmine.status
允许使用 /veilmine status。
veilmine.reload
允许使用 /veilmine reload。
veilmine.compat
允许使用 /veilmine compat。
veilmine.alerts
允许接收工作人员警报。
veilmine.verbose
允许使用详细警报模式。
veilmine.inspect
允许检查玩家。
veilmine.report
允许生成玩家报告。
veilmine.cache
允许使用缓存命令。
veilmine.web
允许使用 Web 面板命令。
veilmine.web.token
允许查看或重新生成 Web 面板令牌。
veilmine.exempt
允许临时豁免玩家。
veilmine.clearvl
允许清除违规等级。
veilmine.debug
允许使用调试命令。
绕过权限
veilmine.bypass
绕过所有 VeilMineX 检查。
veilmine.bypass.antixray
绕过 Anti-Xray(反透视)保护。
veilmine.bypass.anticheat
绕过反作弊检查。
veilmine.bypass.mining-reach
绕过挖掘距离检查。
veilmine.bypass.fast-break
绕过快速破坏检查。
veilmine.bypass.nuker
绕过连点/爆破检查。
veilmine.bypass.proximity
绕过近距离揭示限制。
veilmine.staff.see-real-blocks
如果配置中启用,允许受信任的管理员查看真实隐藏方块。
配置
VeilMineX 包含多个配置文件:
config.yml
主插件设置。
messages.yml
自定义消息和颜色。
checks.yml
反作弊检查设置。
web.yml
Web 面板设置。
logs/
违规记录和挖矿日志。
reports/
生成的玩家报告。
默认安全策略
VeilMineX 默认并非旨在立即封禁玩家。
默认行为如下:
- 低可疑度:仅记录日志
- 中等可疑度:通知管理员
- 高可疑度:取消可疑操作
- 极高可疑度:若已配置,则执行惩罚
这使得该插件更适合生存服务器、SMP 服务器、经济类服务器以及需要避免误报的公共社区。
安装步骤
- 下载 VeilMineX jar 文件。
- 将其放入服务器的
plugins 文件夹中。
- 如需基于数据包的 Anti-Xray 功能,请安装 ProtocolLib。
- 重启服务器。
- 运行以下命令:
/veilmine status
- 运行以下命令:
/veilmine antixray test
- 根据需要编辑配置文件。
- 使用 Web 面板或命令来监控警报。
重要提示
VeilMineX 的设计目的是大幅增加 X-ray(透视)和可疑挖矿行为的难度,但没有任何 Anti-Xray 或反作弊插件可以被称为“无法绕过”。
为了获得最佳防护效果,建议将 VeilMineX 与以下措施配合使用:
- 严格的管理员监管
- 定期备份
- CoreProtect 或其他回滚插件
- 合理的权限设置
- 保持服务器版本更新
- 保守的惩罚设置
适用场景
VeilMineX 适用于以下类型的服务器:
- 生存服务器
- SMP 服务器
- 经济类服务器
- Lifesteal(生命窃取)服务器
- 半无政府状态服务器
- 公共社区服务器
- 以挖矿为主的服务器
- 需要更强大透视调查工具的服务器
技术支持
如果某些功能无法正常工作,请运行以下命令:
/veilmine compat
/veilmine antixray test
/veilmine status
然后检查控制台日志以及以下目录中的文件:
plugins/VeilMineX/logs/
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:
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
/veilmine
Shows the main help menu.
/veilmine status
Shows plugin status, Anti-Xray status, anti-cheat status, web panel status, cache information, and loaded modules.
/veilmine reload
Reloads configuration files safely.
/veilmine compat
Shows server compatibility information, including Minecraft version, Java version, server type, packet provider, and enabled features.
/veilmine panic
Toggles panic mode. Panic mode disables punishments but keeps logging and alerts active.
Alert Commands
/veilmine alerts
Toggles staff alerts for yourself.
/veilmine verbose
Toggles verbose alert mode.
Player Investigation Commands
/veilmine inspect <player>
Opens a player inspection GUI with violation history, mining data, suspicion score, and recent alerts.
/veilmine report <player>
Generates a mining and violation report for a player.
/veilmine clearvl <player> [check]
Clears a player’s violation level. You can clear all checks or only one specific check.
/veilmine exempt <player> <seconds> <reason>
Temporarily exempts a player from checks. Useful for testing, staff actions, or custom events.
Anti-Xray Commands
/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.
/veilmine cache clear
Clears the Anti-Xray cache.
/veilmine cache stats
Shows cache hit rate, cache size, and obfuscation performance.
Web Panel Commands
/veilmine web status
Shows whether the web panel is running.
/veilmine web url
Shows the local web panel URL.
/veilmine web token
Regenerates the admin web token.
/veilmine web restart
Restarts the web panel safely.
Debug Commands
/veilmine debug chunk
Shows Anti-Xray debug information for the chunk you are standing in.
/veilmine debug compatibility
Shows detailed compatibility debug information.
Permissions
veilmine.admin
Gives access to all admin features.
veilmine.command
Allows use of the main command.
veilmine.status
Allows /veilmine status.
veilmine.reload
Allows /veilmine reload.
veilmine.compat
Allows /veilmine compat.
veilmine.alerts
Allows receiving staff alerts.
veilmine.verbose
Allows verbose alert mode.
veilmine.inspect
Allows inspecting players.
veilmine.report
Allows generating player reports.
veilmine.cache
Allows cache commands.
veilmine.web
Allows web panel commands.
veilmine.web.token
Allows viewing or regenerating the web panel token.
veilmine.exempt
Allows temporary player exemptions.
veilmine.clearvl
Allows clearing violation levels.
veilmine.debug
Allows debug commands.
Bypass Permissions
veilmine.bypass
Bypasses all VeilMineX checks.
veilmine.bypass.antixray
Bypasses Anti-Xray protection.
veilmine.bypass.anticheat
Bypasses anti-cheat checks.
veilmine.bypass.mining-reach
Bypasses mining reach checks.
veilmine.bypass.fast-break
Bypasses fast break checks.
veilmine.bypass.nuker
Bypasses nuker checks.
veilmine.bypass.proximity
Bypasses proximity reveal restrictions.
veilmine.staff.see-real-blocks
Allows trusted staff to see real hidden blocks if enabled in config.
Configuration
VeilMineX includes several configuration files:
config.yml
Main plugin settings.
messages.yml
Custom messages and colors.
checks.yml
Anti-cheat check settings.
web.yml
Web panel settings.
logs/
Violation and mining logs.
reports/
Generated player reports.
Default Safety
VeilMineX is not designed to instantly ban players by default.
Default behavior:
- Low suspicion: log only
- Medium suspicion: staff alert
- High suspicion: cancel suspicious action
- Very high suspicion: optional punishment if configured
This makes the plugin safer for survival servers, SMPs, economy servers, and public communities where false positives must be avoided.
Installation
- Download the VeilMineX jar.
- Place it inside your server’s
plugins folder.
- Install ProtocolLib if you want packet-based Anti-Xray.
- Restart the server.
- Run:
/veilmine status
- Run:
/veilmine antixray test
- Edit the config files if needed.
- Use the web panel or commands to monitor alerts.
Important Notes
VeilMineX is designed to make X-ray and suspicious mining much harder, but no Anti-Xray or anti-cheat plugin should be called “unbypassable.”
For best protection, use VeilMineX together with:
- Good staff moderation
- Backups
- CoreProtect or another rollback plugin
- Proper permissions
- Regular server updates
- Conservative punishment settings
Best For
VeilMineX is useful for:
- Survival servers
- SMP servers
- Economy servers
- Lifesteal servers
- Semi-anarchy servers
- Public community servers
- Mining-based servers
- Servers that need better X-ray investigation tools
Support
If something does not work correctly, run:
/veilmine compat
/veilmine antixray test
/veilmine status
Then check the console logs and the files inside:
plugins/VeilMineX/logs/
评论 0
登录后参与评分
还没有评论,来抢沙发吧