# 🕵️ Witness ### *No crime goes unseen. No truth stays hidden.* ![Version](https://img.shields.io/badge/version-1.0.0-gold) ![Minecraft](https://img.shields.io/badge/Minecraft-1.21.x-green) ![Platform](https://img.shields.io/badge/platform-Paper%20%7C%20Spigot%20%7C%20Purpur-blue) ![Ecosystem](https://img.shields.io/badge/Suite-CivCraft-orange) **The walls have eyes.**
![Tesitmony Banner](https://iili.io/BUyBcoN.md.png)

--- ## 👁️ 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 ` | 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 ```yaml # 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

GridExpert