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.

---