🚀 Why Rep?

Rep is a high-performance community engine built for Folia 🍃, Paper 📄, and Purpur 🟣 on Minecraft 1.21 through 26.x (including 26.1.x and 26.2.x).

Most reputation plugins run on the main thread, causing lag. Rep is different. All database operations are 100% asynchronous, ensuring your server stays at 20 TPS no matter how many players are online.

✨ The Customization Update

Rep is constantly evolving based on community feedback. It is 100% Translatable and includes powerful Rewards:

• 🎁 Rank Rewards: Automatically execute console commands (Money, Keys, Permissions) when players rank up.
• 🎨 Ultimate Customization: Translate every message and GUI Title ("Top Players", etc.). Use Hex Colors everywhere.
• 📊 Smart Placeholders: Show reputation as 10k, 1.2m, and more — fully configurable suffixes (k, m, b, t, q) in config.yml.
• 🔊 Immersive Audio: Configurable Sound Effects and Particles when gaining or losing rep.
• 🛡️ Anti-Abuse: Set daily reputation limits to prevent spam.

---

🔥 Key Features

• 🧵 Folia Native: Built specifically for multi-threaded environments.
• 🎨 Fully Configurable: Change GUI items, messages, and titles to fit your server's theme.
• 🎁 Rank Rewards: Create an addictive loop by rewarding players for high reputation.
• 💾 Dual Storage: YAML (local files) or MySQL (network sync).
• 🎮 Event Triggers: Auto-give rep for gameplay actions:
  • Killing Villagers (-)
  • Trading with Villagers (+)
  • Taming Animals (+)
  • Killing Iron Golems (-)
• 🏆 Infinite Leaderboards: A beautiful, paginated GUI leaderboard that handles thousands of players.

---

💻 Commands & Permissions

Player (rep.use)

• /rep - Open your profile
• /rep <player> - View another player's profile
• /rep <player> plus - Give +1 Reputation
• /rep <player> minus - Give -1 Reputation
• /rep top - Open Leaderboard
• /rep rewards - View Rank Rewards GUI
• /rep help - Open Help Menu

Admin (rep.admin)

• /rep set <player> <amount> - Force set score (Console Supported)
• /rep add <player> <amount> - Add/Subtract score (Console Supported)
• /rep reload - Reload configuration

---

⚙️ Configuration

Rep features over 400 lines of configuration options. Control everything from sound effects to GUI items.

---

🔗 PlaceholderAPI

Rep integrates with PlaceholderAPI for use in scoreboards, tab lists, and chat plugins.

Placeholder	Description
%rep_score%	Reputation score (raw or compact — see placeholders.score-format in config)
%rep_score_raw%	Full integer score (e.g. 10000)
%rep_score_compact%	Compact score (e.g. 10k) — suffixes configurable in config
%rep_rank%	Player's current rank name
%rep_prefix%	Player's rank chat prefix

Config Snippets

Compact score placeholders:

placeholders:
  score-format: compact  # or raw
  compact:
    suffixes:
      thousand: k
      million: m
      billion: b
    thresholds:
      thousand: 1000
      million: 1000000

Rank Rewards:

ranks:
  honored:
    name: Honored
    score-threshold: 100
    chat-prefix: "&a[Honored]"
    rewards:
      - "eco give %player% 1000"
      - "broadcast &a%player% is now Honored!"

---