InviteRewards
InviteRewards is an advanced Minecraft invitation and referral system designed to reward players who help grow the server by inviting new members to the community.

The plugin allows every player to have a unique invitation code or use their username to invite others. Once a new player registers using an invitation, the system performs multiple verification checks to prevent abuse and ensure that invitations are legitimate before rewards are granted.

Main Features
Unique Invitation System

• Every player automatically receives a personalized invitation code.
  
  
• New players can use either an invitation code or the inviter's username.
  
  
• Each account can only use an invitation once.
  
  
• Self-invitation protection.
  
  
• Duplicate invitation protection.
  
  
• IP verification system to prevent alt-account abuse.
  

Automatic Invitation Validation
Invitations are not considered valid immediately. To prevent abuse, invited players must meet requirements configured by the server administrator.

Currently, the system supports invitation validation through configurable playtime requirements.

Example:

validation:
required-playtime-hours: 24

Once the required playtime is reached, the invitation is automatically validated and credited to the player who sent the invitation.

Accumulative Reward System
Validated invitations generate claimable invitations.

Every time a player reaches the configured amount of invitations, they can claim a reward.

Example:

reward:
required-invites: 20

Unlike traditional systems where rewards can only be claimed once, InviteRewards allows players to claim rewards multiple times.

Example:

• 20 invitations = 1 reward.
  
  
• 40 invitations = 2 rewards.
  
  
• 60 invitations = 3 rewards.
  

Every time a reward is claimed, only the required amount of invitations is consumed, while any remaining invitations are kept for future rewards.

Reward Preview System
Players can preview the rewards they will receive directly from the GUI before claiming them.

Displayed rewards are fully configurable from the configuration file.

Example:

reward:
display:
- "&7You will receive:"
- "&e• VIP Rank"
- "&e• 5 Epic Keys"
- "&e• $50,000"

Intuitive GUI System
InviteRewards includes a fully integrated graphical interface that allows players to access all invitation-related information.

Profile Information
Players can view:

• Player name.
  
  
• Validated invitations.
  
  
• Available invitations.
  
  
• Personal invitation code.
  

Progress Tracking
The main menu displays:

• Validated invitations.
  
  
• Pending invitations.
  
  
• Available invitations.
  
  
• Current goal.
  
  
• Reward status.
  

The goal updates automatically whenever the administrator changes the configuration.

Reward Menu
The reward section displays:

• Available invitations.
  
  
• Remaining invitations needed.
  
  
• Configured rewards.
  
  
• Current reward status.
  

Top Inviters Leaderboard
InviteRewards includes a visual leaderboard system to highlight the players who contribute the most to the growth of the server.

Leaderboard Features

• Top 20 players.
  
  
• Automatically sorted by invitation count.
  
  
• Only displays players with at least one invitation.
  
  
• Real player heads.
  
  
• Optimized visual design.
  
  
• Special identification for the top three positions.
  
  
• Special marker for the server's best inviter.
  
  
• Informative message when there is not enough data yet.
  

Integrated Navigation
The leaderboard menu includes:

• Return button to the main menu.
  
  
• Full inventory protection.
  
  
• Optimized layout for a clean and professional experience.
  

Player Commands
/invite
Allows a player to register an invitation.

Examples:

/invite ABC123
/invite Brian

/invites
Opens the main invitation menu.

Administrative Commands
All administrative commands require the permission:

inviterewards.admin

/inviteadmin reload
Reloads the plugin configuration without restarting the server.

/inviteadmin info
Allows administrators to view detailed information about any registered player.

Includes:

• Invitation code.
  
  
• Registered invitations.
  
  
• Playtime.
  
  
• Related statistics.
  

/inviteadmin add
Adds valid invitations directly to a player.

These invitations are treated as legitimate invitations and are also added to the player's available invitation balance.

Example:

/inviteadmin add Brian 10

/inviteadmin reset
Completely resets the selected player's statistics.

/inviteadmin migrate
Automatically registers existing server players into the invitation system.

This feature is especially useful when installing InviteRewards on an already established server.

This allows:

• Existing players to automatically receive their invitation code.
  
  
• Only new invitations to be counted.
  
  
• No impact on previous server statistics.
  

Flexible Configuration
Most important plugin settings can be customized through the configuration file:

• Required hours for invitation validation.
  
  
• Required invitations to claim rewards.
  
  
• Commands executed when rewards are claimed.
  
  
• Reward preview displayed in the GUI.
  
  
• Custom messages.
  

Compatibility

• Spigot
  
  
• Paper
  
  
• Purpur
  
  
• Modern Minecraft versions
  

Advantages

• Easy to configure.
  
  
• Anti-abuse protection.
  
  
• Reusable reward system.
  
  
• Intuitive GUI menus.
  
  
• Integrated leaderboard.
  
  
• Compatible with both new and existing servers.
  
  
• Built-in SQLite database.
  
  
• Lightweight and optimized.
  
  
• Ideal for communities looking to encourage organic server growth.
  

InviteRewards provides a complete referral solution for Minecraft servers, helping administrators increase player activity while fairly rewarding community members who contribute to server growth.