Advanced invitation management plugin for Paper/Spigot 1.21+ servers
๐ฎ What is InviteMe?
InviteMe turns your server's whitelist into a social invitation system. Each player has a configurable number of invitation slots to bring friends to the server. The plugin manages access, keeps an action log, provides an inventory GUI, and rewards proximity between mutually-invited players with an XP multiplier.
โจ Features
- ๐๏ธ Invitation system โ each player has a configurable slot limit; different limits per rank via LuckPerms
- โณ Temporary invitations โ invitations with automatic expiry date support
- ๐ฅ๏ธ Inventory GUI โ graphical interface with player heads, pagination and uninvite confirmation
- โก Mutual XP boost โ XP multiplier for mutually-invited players who are near each other
- ๐๏ธ Multiple backends โ JSON, SQLite, MySQL and PostgreSQL with live migration
- ๐ LuckPerms integration โ automatic group assignment and per-rank invitation limits
- ๐ PlaceholderAPI โ over 15 placeholders for scoreboards, tablist and HUDs
- ๐ Multilingual โ English, Spanish and German included; editable files in
plugins/InviteMe/locales/ - ๐ Action log โ full history of invites and uninvites, exportable to CSV
- ๐ Auto-sync โ keeps the native whitelist in sync with plugin data automatically
- ๐ Plugin mode โ alternative to the native whitelist; access control managed entirely by InviteMe
๐ Requirements
| Requirement | Minimum version | Notes |
|---|---|---|
| Paper / Spigot | 1.21 | Paper recommended |
| Java | 21 | |
| LuckPerms | any | Optional โ group assignment and per-rank limits |
| PlaceholderAPI | any | Optional โ placeholders in other plugins |
๐ Installation
- Download
InviteMe-<version>.jar. - Place it in your server's
plugins/folder. - Start or restart the server.
- The plugin automatically generates
plugins/InviteMe/config.yml. - Edit the configuration and run
/im reload.
๐ฌ Commands
๐ค Player commands
Require the
invite.usepermission (granted to all players by default).
| Command | Description |
|---|---|
/invite add <player> |
Invite a player to the server |
/invite add <player> <days> |
Temporary invitation with expiry (requires invite.temp) |
/invite list |
Show your invitations and remaining slots |
/invite list <player> |
Show another player's invitation list |
/invite list all |
Global inviter ranking |
/invite menu |
Open the inventory GUI |
๐ก๏ธ Admin commands
Require the
invite.adminpermission (OPs only by default).
| Command | Description |
|---|---|
/invite remove <player> [reason] |
Remove a player from the server |
/im profile <player> |
Full invitation profile of a player |
/im stats [N] |
Global statistics and top N inviters |
/im log list [player] [N] |
Action log, filterable by player |
/im log export |
Export the full log to a CSV file |
/im sync |
Force an immediate whitelist sync |
/im debug |
Plugin diagnostic information |
/im reload |
Reload configuration without restarting |
/im migrate [sqlite|mysql|postgresql] |
Migrate data between backends |
๐ Permissions
| Permission | Default | Description |
|---|---|---|
invite.use |
Everyone | Invite players and view own invitation list |
invite.admin |
OP | Full administrative access; bypasses limits and cooldown |
invite.temp |
false | Create temporary invitations with expiry |
invite.stats |
OP | View global statistics with /im stats |
invite.log |
OP | View and export the action log with /im log |
invite.number.X |
โ | Custom limit of X invitations (e.g. invite.number.10) |
invite.* |
OP | Wildcard โ grants all permissions |
Limit priority: invite.number.X > group-limits in config > max-invites in config.
๐ Placeholders
Requires PlaceholderAPI installed.
๐ค Per player
| Placeholder | Description |
|---|---|
%inviteme_max_invites% |
Maximum invitation limit (โ if unlimited) |
%inviteme_used_invites% |
Invitations already used |
%inviteme_remaining_invites% |
Remaining invitations |
%inviteme_invited_players% |
Number of players invited |
%inviteme_is_invited% |
true if the player was invited by someone |
%inviteme_invited_by% |
Name of the player who invited them |
%inviteme_rank% |
Position in the inviter ranking |
%inviteme_invites_bar% |
Visual progress bar (e.g. โโโโโโโโโโ) |
%inviteme_invites_percentage% |
Percentage of invitations used |
%inviteme_status% |
Status: Unlimited, Limited or Full |
โก Boost system
| Placeholder | Description |
|---|---|
%inviteme_boost_active% |
true if mutual boost is active |
%inviteme_boost_partners% |
Number of active boost partners |
%inviteme_boost_multiplier% |
Current XP multiplier (e.g. 1.5) |
%inviteme_boost_percentage% |
XP increase percentage (e.g. 50%) |
๐ Global stats
| Placeholder | Description |
|---|---|
%inviteme_total_invites% |
Total invitations on the server |
%inviteme_total_players% |
Total invited players |
%inviteme_top_inviter% |
Player with the most invitations |
%inviteme_top_inviter_count% |
Top inviter's invitation count |
๐๏ธ Storage
| Backend | Description |
|---|---|
json |
Local file invites.json, no additional setup |
sqlite |
Local database invites.db, recommended (default) |
mysql |
Remote MySQL or MariaDB database |
postgresql |
Remote PostgreSQL database |
To migrate between backends: run /im migrate <type>, wait for confirmation, then update storage.type in config.yml and run /im reload.
โก Mutual XP Boost
When two players who mutually invited each other enter the configured radius, both receive an XP multiplier. The effect stacks with multiple partners and is configurable per world.
mutual-invite-boost:
enabled: true
xp-multiplier: 1.5 # +50% XP
check-interval: 5 # seconds between checks
show-actionbar: true
particle-effects: true
max-boost-partners: 3
max-multiplier: 2.5
radius:
overworld: 50
nether: 75
end: 100
๐ Access control
access-control-mode: native # native | plugin
nativeโ Minecraft's native whitelist controls access (default).pluginโ InviteMe manages access directly; setwhite-list=falseinserver.properties.
โ FAQ
Why can't a player invite even with the invite.use permission?
They may have reached the max-invites limit or be on cooldown. Players with invite.admin have no such restrictions.
How do I give unlimited invitations to a rank?
/lp group <rank> permission set invite.admin true
Or a specific number with the invite.number.X permission (e.g. invite.number.20).
A player appears on the whitelist but not in /invite list.
They were added directly via /whitelist add. With whitelist-sync.auto-register-console: true the plugin will register them on the next sync, or force it with /im sync.
Does the boost work in custom worlds?
Yes, add the custom-worlds section under mutual-invite-boost.radius:
radius:
custom-worlds:
mining_world: 60
๐ Documentation
| Language | User guide |
|---|---|
| English | User guide |
| Espaรฑol | Guรญa de usuario |
Pinned Versions
- R1.21โ1.21.11
Pages
Members
1
Owner