Guide

Reading a TunnelVision report: score, indicators and verdicts

A TunnelVision report doesn't tell you who cheated. It tells you which mining sessions deserve your time, and why. This guide shows how to read one in a few minutes, from the overview to checking in game, with screenshots of a real report: the anonymized demo (its interface is in French).

Published

1. Start with the overview

The Vue d'ensemble (overview) button sums up every session in the report. On the left, the distribution of scores: on a real server, the overwhelming majority of sessions pile up near 0, and only a few stand out on the right. On the right, each dot is a session, placed by its score (horizontal) and its distance from the corpus (vertical); clicking a dot opens the session.

Overview of a TunnelVision report: histogram of suspicion scores and scatter plot of score against distance from the corpus. Three highly suspicious sessions top right, two clean sessions bottom left.
In the demo: three "highly suspicious" sessions grouped top right (high score and atypical session), two clean sessions bottom left.

Start with the top-right corner: a high score that the anomaly model also finds atypical means two independent views pointing at the same place.

2. The session ranking

The ranking, in the right-hand panel, sorts sessions by score. It can also sort by distance from the corpus, by yield of the tracked ore, by number of blocks or by duration, and search for a specific player.

Session ranking in a TunnelVision report, sorted by score: Silexis 73, Grimval 71, Silexis 70.1, Cobaltin 6, Grimval 0.
The same player can have several sessions: here, both of Silexis's sessions stand out. A repeated pattern counts for more than an isolated session.

Sorting by yield is raw data, not a verdict: a player who stumbled on a big vein will top it without cheating. It's there to go back to the facts when the score seems too lenient to you.

3. The score and its verdict

Every session gets a score from 0 to 100 and one of three verdicts:

Two score panels side by side. Left, Silexis: 73 out of 100, highly suspicious, yield 6.38 diamonds per 100 blocks dug, detour 2.83 times, turns toward the vein 69 %, distance from corpus 81.6. Right, Cobaltin: 6 out of 100, nothing to report, yield 1.52, detour 2.59 times, turns 55 %, distance from corpus 42.1.
Left, an x-ray session (73, highly suspicious); right, a legitimate strip-mining session (6, nothing to report). Both come from the same report.

A score decides nothing: it sorts. Even a 90 calls for a human check before any sanction, for the reasons detailed in why a suspicion score should never be enough to ban.

4. The indicators, one by one

Under the score, each indicator shows its value on the right and a gauge below it. The value is the raw measurement; the gauge shows how much this indicator weighs in the score.

A value without a gauge

Look at Cobaltin's detour above: 2.59×, but an empty gauge. The value is computed, but from a single pair of veins: too little to be reliable, so the indicator is left out of the score. A dash ("—") instead of a value means it couldn't be computed at all.

Two safeguards are worth knowing to read a score correctly. First, yield alone is never enough to reach "highly suspicious": at least one other indicator has to back it up. Second, in a corridor dug in a straight line, the trajectory indicators are left out: digging straight ahead isn't aiming, and a vein sitting on the line proves nothing.

5. Distance from the corpus: a second opinion

Under the indicators, the écart au corpus (distance from the corpus) comes from a model entirely independent of the score: it learned what a typical session looks like from thousands of real sessions, and measures how far this one strays from it. Above 50 (the mark on the bar), the session is more atypical than the vast majority; the "tiré par" (driven by) note says what makes it atypical.

Atypical doesn't mean cheater: a building session, a player clearing out a huge cave, a server event can all be out of the ordinary. This view is mostly there to confirm a high score (Silexis: score 73, distance 81.6) or to flag an odd session the score doesn't see.

6. The 3D scene: what doesn't lie

The numbers tell you where to look; the scene shows what happened. Every broken block sits at its real coordinates, ores in colour, and a line links the blocks in the order they were broken: that's the player's path.

3D scene of a legitimate session: a regular network of parallel corridors, with ores found along the branches.
Legitimate session (Cobaltin, 6/100): regular parallel corridors, a long access tunnel, ores collected where the corridors cross them.
3D scene of a suspicious session: a winding tunnel snaking from one diamond vein to the next, with no wasted corridor.
X-ray session (Silexis, 73/100): a tunnel snaking from vein to vein, 106 diamonds in 12 minutes, without a single dead-end corridor.

A few tools in the scene save a lot of time:

7. Special cases

A session that's too short

Score panel of a very short session: 0 out of 100, nothing to report, yield 0.92, detour not computable, turns 65 %.
A one-minute session, 115 blocks, a single diamond: score 0, detour not computable. "Nothing to report" means "nothing to say" here, not "cleared".

With few blocks and few veins, the indicators lack material. A clean verdict on a short session clears nobody: look at all of the player's sessions instead.

A cave session

In caves, an honest player picks up a lot of ore that's already visible: the score accounts for this with adapted thresholds, and is deliberately cautious. To understand why, and what really sets an explorer apart from a cheater in caves, see false positives in caves and the test that still works in caves.

A careful cheater

A player who only cheats in short bursts can drag down the average of a long session. Hence the time window, and the article on occasional x-ray.

8. From alert to decision

  1. Spot the sessions in the top right of the overview, or at the top of the ranking.
  2. Read which indicators drive the score, and on what basis (an empty gauge doesn't count).
  3. Look at the path in the scene: a grid, or a tunnel running from vein to vein?
  4. Compare with the player's other sessions: a repeated pattern weighs more than a one-off.
  5. Check in game, with Copier /tp and the CoreProtect commands from the full investigation method.
  6. Decide yourself. The report did the sorting; the decision stays with your team.

Key points

Try it on your server

TunnelVision rereads the CoreProtect history your server already records and produces this report, session by session, with the indicators behind each score. The demo above is a real, anonymized report.