TunnelVision
一款基于 CoreProtect 的专用服务器透视检测工具。
TunnelVision 分析由 CoreProtect 记录的挖掘行为,并标记那些看起来像是玩家利用不应获得的信息(即透视)所引导的会话。它不会尝试实时检测透视;相反,它会事后重建每个挖掘会话,并根据轨迹、产出率以及玩家向矿石移动的直接程度对其进行评分。
? tunnelvision.fr — 实时交互式演示、完整文档及 Beta 版访问申请。
⚠️ 状态:Beta。 命令、权限和配置尚不稳定,版本之间可能会发生变化。目前不建议用于关键/大规模的生产环境——欢迎提供反馈和测试。
要求
- CoreProtect — TunnelVision 读取其方块破坏日志;它本身不记录任何内容。
- 访问 TunnelVision 的分析服务。 该插件本身不进行任何计算——每条命令都通过 HTTP 查询中央 API。当前访问为免费且名额有限的 Beta 版:在网站上申请访问 以获取你的 API 密钥。
- 适用于任何 Paper/Spigot 1.21 服务器。你无需在本机运行 Docker 或进行繁重设置——只需放入 jar 文件并配置 API 密钥即可。
工作原理
- Java 插件从 CoreProtect 读取挖掘数据,并使用创建访问时颁发的密钥通过 API 将其发送到 TunnelVision 的分析服务。
- 分析管道从原始方块破坏事件重建每个玩家的挖掘会话。
- 对于每个会话,它计算轨迹和产出指标——方向变化、直线“冲刺”、每挖掘方块的矿石产出率、矿脉间的迂回因子,以及转弯是否一致指向下一个(未发现的)矿脉。
- 这些指标输入到一个 0–100 的可疑度分数中,并给出判定(清白 / 值得关注 / 高度可疑),同时还有一个独立的 异常分数(孤立森林算法,无监督学习),用于标记在统计上与服务器其余数据截然不同的会话。
- 结果以交互式 3D 报告的形式呈现:包括挖掘路径、矿石位置以及所选会话的所有指标详细分解,并按可疑度分数排序的每服务器会话排行榜。报告还可以 托管在可分享的链接上 并附带协作注释,以便在没有服务器访问权限的情况下也能查看——查看实时示例。

分数的含义(与非含义)
0–100 的分数是一种 启发式算法,已根据已知的游戏机制(如特定深度的预期产出、合法网格挖掘模式的几何形状等)进行了校准——而非经过训练的分类器。它的目的是作为一种分流工具,帮助管理员决定哪些会话值得人工审查,而不是作为作弊的自动证据。异常分数增加了第二个独立信号(与服务器自身数据相比的统计离群值),正是因为单一的启发式算法可能会出错——一个被其中一个算法标记而另一个未标记的会话,正是需要在采取任何行动之前进行人工审查的案例类型。
推荐用法: 将每个被标记的会话视为需要调查的线索(例如通过可视化报告,或使用 /tp 快捷方式传送到挖掘区域),而不是将其视为最终的定罪判决。
已知局限性
- 路径直线性指标可能会被常见的挖掘模式扭曲(例如,一个 2 格高的隧道交替使用水平和垂直步骤,这会拉平所有人的“直线段”测量值)。
- 阈值是根据开发者的自有测试数据和已知的游戏知识进行校准的;尚未针对大型标注的真实世界数据集进行验证。
- 在同一会话中混合合法挖掘和透视行为的玩家,其分数会被稀释。
- 利用洞穴网络并仅向矿脉挖掘最后几格方的玩家,可以部分规避“挖掘产出”信号。
路线图
- 稳定游戏内命令和权限。
- 改进路径简化算法,以更好地区分真正的条带化采矿网格与混乱的透视路径。
- 针对真实(非合成)标注数据重新校准分数阈值。
- 会话内的滑动窗口评分,以捕捉仅在部分时间作弊的玩家。
? 完整文档,包括所有配置键:tunnelvision.fr/documentation.html
在此阶段,反馈、错误报告和在实际服务器上的测试尤其有价值——这是 Beta 版软件。
TunnelVision
A CoreProtect-based x-ray detection tool for dedicated servers.
TunnelVision analyzes mining behavior recorded by CoreProtect and flags sessions that look like they were guided by information the player shouldn't have — i.e. x-ray. It doesn't try to detect x-ray in real time; instead it reconstructs each mining session after the fact and scores it based on trajectory, yield, and how directly the player moved toward ore.
? tunnelvision.fr — live interactive demo, full documentation, and beta access requests.
⚠️ Status: Beta. Commands, permissions, and configuration are not yet stable and may change between versions. Not recommended for critical/large-scale production use yet — feedback and testing are welcome.
Requirements
- CoreProtect — TunnelVision reads its block-break logs; it does not log anything itself.
- Access to TunnelVision's analysis service. The plugin does no computation itself — every command queries a central API over HTTP. Access is currently a free, limited-spot beta: request access on the website to get your API key.
- Works on any Paper/Spigot 1.21 server. No local Docker or heavy setup required on your end — just drop in the jar and configure your API key.
How it works
- The Java plugin reads mining data from CoreProtect and sends it to TunnelVision's analysis service over its API, using the key issued when your access was created.
- The analysis pipeline reconstructs each player's mining sessions from the raw block-break events.
- For each session, it computes trajectory and yield indicators — direction changes, straight-line "runs," ore yield per block dug, detour factor between veins, and whether turns consistently point toward the next (undiscovered) vein.
- These indicators feed a 0–100 suspicion score with a verdict (clear / worth watching / strongly suspicious), plus an independent anomaly score (Isolation Forest, unsupervised) that flags sessions statistically unlike the rest of the server's corpus.
- Results are available as an interactive 3D report: the mined path, ore locations, and the full breakdown of indicators for the selected session, with a per-server session leaderboard sorted by suspicion score. Reports can also be hosted on a shareable link with collaborative annotations, so they stay viewable without server access — see a live example.

What the score is (and isn't)
The 0–100 score is a heuristic, calibrated on known game mechanics (expected yield at a given depth, geometry of a legitimate grid-mining pattern, etc.) — not a trained classifier. It's meant as a triage tool to help admins decide which sessions deserve a manual look, not as automatic proof of cheating. The anomaly score adds a second, independent signal (statistical outlierness vs. the server's own data) precisely because a single heuristic can be wrong — a session flagged by one and not the other is exactly the kind of case that needs a human look before any action is taken.
Recommended use: treat every flagged session as a lead to investigate (e.g. via the visual report, or the /tp shortcut to the mined area), not as a verdict on its own.
Known limitations
- Path-straightness metrics can be distorted by common mining patterns (e.g. a 2-block-tall tunnel alternates a horizontal and a vertical step, which flattens the "straight segment" measurements for everyone).
- Thresholds are calibrated on the developer's own test data and known game knowledge; they haven't yet been validated against a large labeled real-world dataset.
- A player who mixes legitimate mining and x-ray behavior within the same session will have their score diluted.
- A player exploiting cave networks and only digging the last block or two toward a vein can partially evade the "dig yield" signal.
Roadmap
- Stabilize in-game commands and permissions.
- Improve path-simplification to better separate genuine strip-mining grids from erratic x-ray paths.
- Recalibrate score thresholds against real (non-synthetic) labeled data.
- Sliding-window scoring within a session, to catch players who only cheat part of the time.
? Full documentation, including every config key: tunnelvision.fr/documentation.html
Feedback, bug reports, and testing on real servers are especially valuable at this stage — this is beta software.
下载 TunnelVision
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TunnelVision
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TunnelVision
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TunnelVision
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TunnelVision
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 TunnelVision
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新增
- 更新通知: TunnelVision 现在每天检查一次 Modrinth,当有新版本发布时,会在游戏内控制台和管理员(
tunnelvision.admin)处发送提示并附带可点击的链接。该信息也会显示在/tunnelvision status命令中。不会向服务器发送任何关于您服务器的信息;如需关闭此功能,请在config.yml中将update-check设置为false。 - 首次使用指南: 当管理员首次运行
score或suspects命令时,会收到一个指向指南的链接,教他们如何解读分数和裁决结果。
改进
- 大幅加快
/tunnelvision score和suspects的速度: 结果现在来自 TunnelVision 服务已计算好的会话数据(仅需几十毫秒,而以前一周的数据需要约 10 秒)。如果这些数据尚未准备好,插件会自动回退到实时分析。 - 输出更清晰: 会话信息显示日期、开始时间和持续时间,以及
[cave]/[old calculation]标签,并在计算仍在追赶进度时显示警告。 - 按名称或 UUID 查找玩家: 包含以玩家旧名记录的会话。
- 同步进度和插件版本 会报告给 TunnelVision 服务,以便我们及时发现卡住的设置或过时的插件,从而更快地为您提供帮助。
修复
today和last-12h时间窗口无法获取当天的数据。
更新方法: 替换 plugins/ 目录中的 jar 文件并重启服务器。您的 config.yml 配置将被保留;新增的 update-check 选项默认开启。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧