Invite System
PluginLicenseRef-All-Rights-Reserved

Invite System

Whitelist plugin with collective responsibility. Banning an invitee penalizes the inviter. Low trust scores result in automatic unwhitelisting. LuckPerms and MySQL/YAML supported. Has a reputation system.

8
Downloads
1
Followers
2 months ago
Updated
📦
3
Versions

📖About 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

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