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

• Restricted Access: The server is locked behind a whitelist.
• Earn Your Invites: 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:

• Automatic Detection: The system identifies the inviter of the banned player.
• Trust Penalty: The inviter receives a significant penalty to their Trust Score.
• Chain Reaction: If an inviter's score falls below the threshold, they are automatically unwhitelisted and kicked.

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

• Positive Growth: Earned via /rep + from other players or for the continued activity of invitees.
• Negative Impact: 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)

• Entry Fee: Set a specific price for using the /invite command.
• Investment & Risk: Requiring payment makes players more selective about who they invite, further reinforcing the Collective Responsibility system.
• Vault Required: 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

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

⚠️ Requirements

• Whitelist: 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.