---

👁️ The Concept

In standard Minecraft, a murder in a dark alley is just a respawn screen. Witness changes the stakes. If a crime is committed within the line of sight of another player, it is no longer just your word against theirs—it is an Official Testimony.

This plugin creates a tangible "paper trail" for every illegal act, forcing criminals to be calculated and victims to find protection.

---

✨ Key Features

📜 Official Testimony Records

When a crime (murder, theft, or griefing) is detected, the plugin automatically generates a Testimony Book for nearby witnesses.

• NBT-Secured Data: Includes the timestamp, coordinates, suspect's name, and victim's name.
• Evidence Level: Categorizes crimes from "Misdemeanor" to "High Felony."
• Non-Forgeable: Records are signed by the server, making them valid evidence for trials.

🕵️ Dynamic Detection Logic

Witness doesn't just check radius; it checks Line of Sight.

• Stealth Mechanics: Sneaking or wearing certain gear can reduce your detection profile.
• Environmental Factors: Foliage and darkness can affect whether a witness "clearly identifies" the suspect.
• Anonymous Tips: Servers can be configured to allow witnesses to remain anonymous to avoid retaliation.

📋 The Criminal Record

Every player has a permanent file accessible via the suite.

• Active Charges: Lists all witnessed crimes that haven't been resolved.
• Prescription System: Minor crimes eventually fade, but major felonies stay on your record forever.

---

🔗 CivCraft Suite Integration

Witness is the primary "data feeder" for the rest of the CivCraft Ecosystem:

Integration	Synergy Effect
🏹 BountyBoard	Automatically puts a price on a suspect's head once a report is filed.
⚖️ Tribunal	Reports are used as the primary evidence in court cases.
🪪 Reputation	Being witnessed committing a crime causes an instant, massive drop in social score.
⚔️ ReanimateMC	Failing to help a "Downed" player can be flagged as "Negligence" or "Abandoned."
🪦 Epitaph	Linking a Testimony Record to a Gravestone displays the "Cause of Death" in detail.

---

🛠️ Commands & Permissions

Command	Description	Permission
/witness report	Manually file a report for a crime you just saw	witness.report
/witness record <player>	View the criminal history of a player	witness.check
/witness evidence	View the data of a Testimony Book in your hand	witness.use
/witness purge	(Admin) Clear a player's criminal record	witness.admin

---

📦 Installation

1. Download Witness.jar.
2. Install CivCraft Core to enable cross-plugin crime reporting.
3. Drop into your /plugins folder and restart.
4. Define your "Crime Zones" in the config to toggle detection in specific areas.

---

⚙️ Configuration Snippet

# Witness - Configuration
crimes:
  detect-murder: true
  detect-theft: true # Requires chest-lock or similar plugin
  detect-grief: false # Recommended for creative/unprotected zones

detection:
  max-distance: 32
  require-line-of-sight: true
  blindness-blocks-detection: true

reporting:
  auto-generate-book: true
  alert-guards-on-crime: true