ReputationMC

<div align="center">

🪪 Reputation

*Your name is your greatest asset.*

Forged in action. Etched in memory.

</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>