CoreViz

Supported Versions

• Plugin: 1.3.2 — coreviz-1.3.2.jar
• Minecraft: 26.1 – 26.3 (26.1 Apr 2026 / 26.2 / 26.3 Wilderness Bound 2026-09-15) — one jar for all
• Server: Paper 26.1+ ([26.1.build,), api-version: '26.1') — also Purpur & forks tracking Paper API 26.1+. Not 1.21.x (Paper's version break). No Fabric/Forge.
• Java: 25+ (build + runtime, <release>25</release>)
• CoreProtect: 23.1+ (API v11+) — full behavior (blocks + containers + sessions) on both 23.x and 24.0+

What's New in 1.3.2

Roll back everything from the results screen (NEW)

A new two-step "Roll back all" button on the results screen undoes every eligible entry in the current view — all pages, respecting the GUI filter you have active — in one go.

• Sessions and already rolled-back actions are skipped automatically
• Click once to arm, click again within 10 s to confirm — no accidental mass reversions
• The whole batch goes through the existing preview/snapshot/repair guard in one pass and reports a single combined summary instead of a message per entry
• "Clear highlights" now refreshes the results GUI in place instead of closing it

Look up several players at once (NEW)

u: now accepts a comma-separated player list — e.g. u:Notch,ThermedWolf — up to 50 names (duplicate names are merged case-insensitively).

• Block lookups run one native multi-user query; containers and sessions run one query per player, merged under a shared row budget
• The custom lookup GUI's player field takes the same comma list, and its labels were updated to say so
• Sessions still need a player, but any name in a comma list works

Mixed +/- signs per action category (NEW)

Each comma-separated category in a: can now carry its own sign, mirroring CoreProtect: + = placements/logins, - = breaks/logouts, unsigned = both. So a:+block,-container searches placed blocks and removed container items in one single lookup.

• An unsigned category (a:+block,container) still shows both directions — signs never inherit across categories — and so do opposite signs on the same category (a:-block,+block)
• Tab completion extended; the old "mixed signs unsupported" warning is gone

Inspector is all-time by default (CHANGED)

Inspector clicks now search all recorded time by default — exactly like CoreProtect's own /co inspect — instead of 1.3.1's 30-day default, regardless of any range picked in the time range menu.

• /cpviz i t:<time> sets an optional per-player lookback window for inspector clicks (e.g. /cpviz i t:7d); it resets when inspector mode is disabled, and oversized values clamp to 10 years
• Config key inspect-default-lookback-hours (added in 1.3.1) has been removed — see Notes below
• Inspector enable messages are terser now, matching /co inspect's tone

CoreProtect refusals now show a reason (FIXED)

CoreProtect's API returns null when it refuses a query and an empty list when nothing was found — CoreViz used to report "no results found" for both. Refusals are now detected, mapped to a reason (mirroring CoreProtect 24.0's argument checks), logged as a warning, shown in red chat, and rendered as a distinct "Lookup refused" state in the results GUI.

Typed block lookups without t: really search all history (FIXED)

A bug in the blocks lookup turned t:-less queries (documented as "all logged history") into a filter at time >= now — matching nothing, silently. Time <= 0 now omits the time filter entirely for a true all-time query. Containers, sessions, xray and rollback were unaffected.

Installation

1. Download coreviz-1.3.2.jar from Modrinth or CurseForge
2. Drop into plugins/ alongside CoreProtect.jar on Paper 26.1+ with Java 25+
3. Restart, join on matching client, run /cpviz

Commands & Permissions

/cpviz [player]                          # menu GUI (bare /cviz re-opens last)
/cpviz u:<players> t:<time> r:<radius> a:<block|container|session> b:<item>  # typed lookup
/cpviz i | /cpviz inspect [t:<time>]     # click-to-inspect mode (all-time by default; t: narrows it)
/cpv check u:<player> a:mining [t:<time>] # x-ray mining check
/cpv see                                 # re-open last check
/cpviz clear                             # clear highlights
Aliases: /cpv, /coreviz, /cviz

• cpviz.use (op) — use GUI & highlights & inspector
• cpviz.teleport (op) — Teleport button in results
• cpviz.rollback (op) — roll back / restore entries
• cpviz.check (op) — /cpv check & /cpv see

Typed flags: u:/user: comma-separated players (max 50), t:/time: (1h, 2d12h, omit = all time), r:/radius: number or #global, a:/action: comma-separated categories (block/container/session/mining) each with its own optional +/- sign, b:/block:/item: one Material, h: highlight.

See README for Aggregation rule (aggregation-window-seconds default 3600s = 1h bucket) and all xray-* tuning.

Notes

• Config migration: if you set inspect-default-lookback-hours (the 1.3.1 key), it is now unused and safe to delete; otherwise nothing to do. No new permissions.
• Paper 26.1+ and Java 25 are mandatory — older Paper / Java 21/17 will fail to load.
• Requires repo.papermc.io + maven.playpro.com only at build time.

Built from net.thermedwolf:coreviz:1.3.2 — Paper API [26.1.build,) — CoreProtect 24.0 (compile) / 23.1+ (runtime floor)