ReputationMC

<div align="center"> # 🪪 Reputation ### *Your name is your greatest asset.* !(https://img.shields.io/badge/version-1.0.0-darkgrey) !(https://img.shields.io/badge/Minecraft-1.19%20→%201.21-green) !(https://img.shields.io/badge/platform-Paper%20%7C%20Spigot%20%7C%20Purpur-blue) !(https://img.shields.io/badge/CivCraft-Suite-orange) **Forged in action. Etched in memory.** !(https://iili.io/BUyxTsp.md.png) </div> --- ## 🎭 The Concept Every player carries a **Social Score** from -100 (Infamous) to +100 (Venerated). It floats above their head for all to see, unlocks or closes zones, and ripples across every other plugin in the CivCraft Suite. --- ## ✨ Features **🏷️ Reputation Tiers & Nametags** Seven tiers from *Venerated* to *Infamous*, each with a colored title above the player's head. Neutral players stay clean. **📊 Score History** Every point gained or lost is logged with a reason and timestamp. `/rep history <player>` shows the full ledger. **🏆 Server Leaderboard** `/rep view` displays top and bottom players, cached every 5 minutes. **🏛️ Zone Protection** Set a minimum reputation threshold on any location. Players below it are knocked back — no entry for the infamous. **📋 Physical Reputation Signs** Place a sign in the world that displays a player's live reputation, updated every 60 seconds. **🔄 Natural Decay (Optional)** Negative scores recover at +1/day, very high scores lose 0.5/day above the threshold. Disabled by default. --- ## 📈 Score Sources | Event | Points | Source | |-------|--------|--------| | Murder (witnessed) | -10 | Witness | | KO assault | -5 | Witness + ReanimateMC | | KO execution | -15 | Witness + ReanimateMC | | Bounty claimed on you | -5 | BountyBoard | | Tribunal conviction | -20 | Tribunal | | Reviving a KO player | +5 | Witness + ReanimateMC | | Claiming a bounty | +3 | BountyBoard | | Crime prescribed | +2 | Witness | | Tribunal acquittal | +10 | Tribunal | --- ## 💻 Commands Available as `/rep` and `/reputation`. | Command | Permission | Description | |---------|------------|-------------| | `/rep <player>` | `reputation.use` | Score, tier and recent history | | `/rep view` | `reputation.use` | Server leaderboard | | `/rep history <player>` | `reputation.use` | Full event history | | `/rep tiers` | `reputation.use` | List all tiers and thresholds | | `/rep give <player> <pts>` | `reputation.admin` | Manually adjust score | | `/rep reset <player>` | `reputation.admin` | Reset to 0 | | `/rep sign <player>` | `reputation.sign.place` | Place a live reputation sign | | `/rep zone <score>` | `reputation.admin` | Set zone threshold at your location | | `/rep zones` | `reputation.admin` | List protected zones | | `/rep reload` | `reputation.admin` | Reload configuration | --- ## ⚙️ Configuration Highlights ```yaml reputation: starting_score: 0 min_score: -100 / max_score: 100 nametag_enabled: true hide_neutral_tag: true # Only notable scores get a visible tag history_display_count: 5 leaderboard_cache_seconds: 300 zone_knockback_strength: 1.1 natural_decay: enabled: false negative_recovery_per_day: 1 positive_decay_per_day: 0.5 positive_decay_threshold: 80 ``` --- <div align="center"> *Part of the CivCraftSuite* - **Building better societies, one block at a time.** </div>