CoreViz

Supported versions

Component	Version	Notes
Plugin	1.2.0	coreviz-1.2.0.jar
Minecraft (Java Edition)	26.1 – 26.3	26.1 (Apr 2026), 26.2, and 26.3 Wilderness Bound (2026-09-15) — same jar for all
Server	Paper 26.1+ ([26.1.build,))	api-version: '26.1' — loads on 26.1.x, 26.2.x, 26.3.x and newer. Will not load on 1.21.x and older. Works on forks that track Paper API 26.1+ (Purpur, etc.). No Fabric/Forge.
Java	25+ (build + runtime)	Minecraft 26.1+ requires Java 25. Compiled with <release>25</release>.
CoreProtect	24.0+	Required (depend: [CoreProtect]). Uses typed API v12 containerLookup()/ContainerResult.

One jar for the whole 26.x line. plugin.yml declares api-version: '26.1' and pom.xml compiles against [26.1.build,) (forward-compatible).

What's new in 1.2.0

Feature release — GUI, highlights, and new X-Ray check.

🔍 X-Ray Check — /cpv check u:<player> a:mining (NEW)

Multi-heuristic mining analysis, split by world:

• Overworld + Nether lookups via restrict_blocks — overworld checks diamonds, emeralds, iron, gold, redstone (+ deepslate variants; coal/copper/lapis excluded), nether checks ANCIENT_DEBRIS only. Both lists configurable via config.yml (xray-overworld-blocks, xray-nether-blocks).
• Time control: t: optional (e.g. t:24h, t:7d), defaults to xray-default-lookback-hours: 168 (7 days), capped at xray-max-lookback-hours: 720 (30 days). Safety cap xray-max-lookup-rows: 5000 per world.
• Heuristics scored NONE / LOW / MEDIUM / SUSPICIOUS with human-readable reasons:
  • Axis jumps — gaps where ΔY > 5 or horizontal >30 between diamonds; ratio jumps/(diamonds-1) > 0.6 (≥8 diamonds) flags teleporting between veins
  • Stone ratio (Sentinel-style) — queries STONE/DEEPSLATE/TUFF/NETHERRACK/BASALT/BLACKSTONE baseline; tiers: pure-ore (≤20 stone + ≥5 diamonds), low-stone (≤50 + ≥10), high-ratio (>0.12 on ≥100 stone), medium (>0.06)
  • Velocity / burst (MineAlert-style) — 5 diamonds in 10 min / 12 in 60 min, diamonds/hour (>8 high, >4 medium) + nether rate
• GUI + chat: Results in paginated GUI with highlights/teleport per location; /cpv see re-opens last check (per-checker store). Clickable chat notification. Permission cpviz.check (default: op).

# examples
/cpv check u:Notch a:mining
/cpv check u:Notch a:mining t:24h
/cpv see

↩️ Re-open last results with bare /cviz (NEW)

Bare /cviz now re-opens your last cached results instead of resetting to the player picker — close to inspect highlights, then /cviz to get straight back without re-querying CoreProtect. Also adds explicit /cviz reopen/last/resume and /cviz new/open, a "Reopen last results" clock button in the player picker, and a "New lookup" compass in results.

🟥 Highlight — Removed blocks show actual block type (IMPROVED)

Removed/broken highlights now render as the original block (0.92×, centered) inside a glowing red stained-glass shell (1.002×) instead of a solid red cube. Non-block materials still fall back to red glass. Placed blocks stay green. Both entities tracked so /cpviz clear removes the pair.

🌐 Compatibility — Paper 26.1+ forward-compatible jar

Same jar now loads on every 26.1.x / 26.2.x / 26.3.x server (paper-api [26.1.build,), api-version: '26.1'). No config migration needed — new xray-* keys have sensible defaults and auto-append.

Dependencies

• Hard: CoreProtect 24.0+ on the server.
• None else — no database, no extra libs.

Installation

1. Download coreviz-1.2.0.jar
2. Put it in plugins/ alongside CoreProtect.jar on a Paper 26.1+ server running Java 25+
3. Restart, join on a matching 26.1+ client, run /cpviz

Commands & Permissions

/cpviz [player]                          # menu-driven GUI (bare /cviz re-opens last results)
/cpviz u:<player> t:<time> r:<radius> a:<block|container|session> b:<item>  # typed lookup
/cpv check u:<player> a:mining [t:<time>] # x-ray check (overworld + nether)
/cpv see                                 # re-open last x-ray check
/cpviz clear                             # clear highlights
Aliases: /cpv, /coreviz, /cviz

• cpviz.use (default: op) — GUI / highlights
• cpviz.teleport (default: op) — Teleport button
• cpviz.check (default: op) — /cpv check / /cpv see

Typed flags: u:/user:, t:/time: (1h, 2d12h, ... omit = all time), r:/radius: (#global or number), a:/action: (block, container, session, mining), b:/block:/item: (one Material), h: (highlight).

Compatibility notes

• Not compatible with Paper 1.21.x and older — that's Paper's major version break at 26.1 (26.x.build.* scheme).
• Java 25 is mandatory on all 26.x.

---

Built from net.thermedwolf:coreviz:1.2.0 — Paper API [26.1.build,) (api-version: '26.1') — CoreProtect 24.0