Invite System

InviteSystem

InviteSystem is a unique invitation-based whitelist plugin featuring collective responsibility and dynamic trust scores. Unlike standard referral systems, it turns your server into a self-regulating community where every player is responsible for those they bring in.

---

🚀 Key Features

🔗 Invite Chain Mechanics

* Permanent Links: The server is locked behind a whitelist. * Permanent Links: Players must reach a configurable playtime requirement before they can invite others. * Permanent Links: The `/invite` command links the "Parent" and the "Invitee" forever.

⚖️ Collective Responsibility (Social Credit)

This is the core of the system. If a player breaks the rules: * automatically unwhitelisted and kicked. The system identifies the inviter of the banned player. * automatically unwhitelisted and kicked. The inviter receives a significant penalty to their Trust Score. * automatically unwhitelisted and kicked. If an inviter's score falls below the threshold, they are automatically unwhitelisted and kicked.

📈 Trust Score (0-100) (Can be configurated)

* LuckPerms Integration: Earned via `/rep +` from other players or for the continued activity of invitees. * LuckPerms Integration: Caused by rule violations or the banning of invited friends. * LuckPerms Integration: Automatically grant ranks, prefixes, or permissions when trust milestones are reached.

💸 Economy Integration (Vault)

* Vault API Set a specific price for using the `/invite` command. * Vault API Requiring payment makes players more selective about who they invite, further reinforcing the Vault API system. * Vault API This feature integrates seamlessly with any economy plugin via the Vault API.

🔍 Admin Transparency

* Invite Trees: Administrators can view entire invitation branches to identify "toxic" groups and trace the root of rule-breaking waves.

---

💻 Commands

| Command | Description | Permission | | :--- | :--- | :--- | | `/invite <nick>` | Add a player to the whitelist (Requires playtime). | `invitesystem.use` | | `/rep <+/-> <nick>` | Change another player's reputation (Cooldown limited). | `invitesystem.use` | | `/itest <nick>` | View full debug info (Score, Inviter, Invitees). | `invitesystem.test` | | `/iadmin setscore` | Manually set a player's trust score. | `invitesystem.admin` | | `/iadmin setinviter` | Manually change a player's parent link. | `invitesystem.admin` |

---

🧩 PlaceholderAPI Support

Integrate player stats into your Tab, Scoreboard, or Chat using these placeholders:

| Placeholder | Description | | :--- | :--- | | `%invitesystem_trust_score%` | Returns the player's current trust score (e.g., 85.50). | | `%invitesystem_reputation%` | Same as trust score. | | `%invitesystem_invite_count%` | Total number of players invited by the user. | | `%invitesystem_inviter_name%` | Shows the name of the player who invited them. |

---

⚙️ Technical Specs

* Full Control: Choose between Full Control: (flat-file) or Full Control: (cross-server sync). * Full Control: Profile caching ensures minimal impact on server performance. * Full Control: Configure playtime requirements, penalties, and thresholds in `config.yml`

---

⚠️ Requirements

* MUST This plugin is designed to manage your server's access. You MUST have `white-list=true` in your `server.properties` for the core functionality to work.

---