CauseChain

Companion to CoreProtect. Ask /why for the chain; /co i for who placed the block.

CauseChain sits next to CoreProtect. /co i is who touched the block. /why is how this became that.

It records causal chains on Paper and Folia — death, a named WorldGuard or GriefPrevention deny, fire, TNT, projectiles, and WorldEdit — then answers in chat. It is not a block-history logger and does not replace CoreProtect lookup or rollback.

Download

Download CauseChain-1.0.0.jar from Spigot. The Modrinth project exists and may still be under review.

SpigotMC

Download CauseChain 1.0.0 from Spigot.

Modrinth

CauseChain on Modrinth. The listing may still be under review.

Five jobs

1. Punch death — /why after you die. Alex ignited TNT → explosion instead of Steve was blown up by TNT.
2. Named deny — /why deny names WorldGuard spawn (visitor) / … or GriefPrevention <owner> (visitor) / ….
3. Inspect captured chains — /why inspect on fire, TNT, or WorldEdit inside land you can build in. Empty inspect names the land and points at CoreProtect /co i.
4. Bow kill — projectile chain; a dispenser stays a dispenser.
5. WorldEdit //set — one semantic node plus an effect set. Staff still get global /why, /chain, evidence, and optional particle traces.

TNT is the six-second demo, last on the list on purpose. The daily work is death, deny, and inspect.

Compatibility

• Server software: Paper or Folia (folia-supported: true)
• API: Paper 1.21 (api-version: "1.21")
• Java: Java 21 or newer. Paper 26.x hosts typically need Java 25+ at runtime
• License: Apache License 2.0. No account, no cloud, no extra JARs for the five jobs
• Keep CoreProtect (or Prism / Ledger) if you need who-placed-this and rollback

Folia uses region, entity, global, and async schedulers. That is scheduler support, not a published Folia stress run. Smoke TNT plus death on your Folia jar before you treat it as production-proven.

Soft-depends: WorldGuard, GriefPrevention, WorldEdit / FastAsyncWorldEdit, CoreProtect, PlaceholderAPI. Missing plugins do not crash CauseChain. Lands is not named until an adapter exists.

Quick commands

/why
/why deny
/why inspect
/cc adapters
/cc status

Documentation sections

Installation

Drop the jar, restart, keep CoreProtect, first /cc adapters.

How it works

Snapshot on the region thread, queue, SQLite, and confidence ranks.

/why

Death, deny, inspect, empty /co i copy, and staff vs player chat.

Commands

/why, /chain, /cc, and console /cc why.

Permissions

why.self / why.claim default true; staff nodes default op.

Configuration

Capture flags, retention, queue, privacy, and hints.

Integrations

WorldGuard, GriefPrevention, WorldEdit, CoreProtect, PlaceholderAPI.

FAQ

CoreProtect, Folia, Lands, rewind, unknown, storage, /reload.

Support

Discord

Support and questions.

Modrinth

CauseChain project page. The listing may still be under review.