Skip to content
InviteMe InviteMe

LuckPerms Integration

LuckPerms lets you set different invitation limits for different player groups (member, VIP, admin). This guide walks you through the complete setup.

Prerequisites

Section titled “Prerequisites”
  • LuckPerms installed and working on your server
  • InviteMe installed and configured

Why Use LuckPerms with InviteMe?

Section titled “Why Use LuckPerms with InviteMe?”

Without LuckPerms, every player has the same invite limit (set by default-invite-limit in config.yml).

With LuckPerms:

GroupInvite Slots
member (default)3
vip10
moderator20
admin99

Each group gets a different limit. Upgrading a player’s group instantly updates their invite limit.

Step 1: Enable LuckPerms Integration

Section titled “Step 1: Enable LuckPerms Integration”

Edit plugins/InviteMe/config.yml:

luckperms:
  enabled: true
  group-limits:
    member: 3
    vip: 10
    moderator: 20
    admin: 99

Then reload:

/im reload

Verify it’s active:

/im debug

Step 2: Set Up Player Groups

Section titled “Step 2: Set Up Player Groups”

If you don’t have groups yet, create them in LuckPerms:

/lp creategroup member
/lp creategroup vip
/lp creategroup moderator
/lp creategroup admin

Assign InviteMe Permissions to Groups

Section titled “Assign InviteMe Permissions to Groups”

member group (all players):

/lp group member permission set invite.use true

vip group:

/lp group vip permission set invite.use true
/lp group vip permission set invite.temp true

moderator group:

/lp group moderator permission set invite.use true
/lp group moderator permission set invite.temp true
/lp group moderator permission set invite.stats true
/lp group moderator permission set invite.log true

admin group:

/lp group admin permission set invite.admin true

The invite.admin permission grants access to all InviteMe commands automatically.

Step 3: Set the Default Group

Section titled “Step 3: Set the Default Group”

Make member the default group for new players:

/lp group default parent add member

Or if you want member to be the default group directly:

/lp group default permission set invite.use true

Step 4: Assign Players to Groups

Section titled “Step 4: Assign Players to Groups”

Upgrade a player to VIP:

/lp user PlayerName parent add vip

Assign moderator:

/lp user PlayerName parent add moderator

Make an admin:

/lp user PlayerName parent add admin

Check a player’s groups:

/lp user PlayerName info

Setting Per-Player Invite Limits

Section titled “Setting Per-Player Invite Limits”

In addition to group limits, you can set limits for individual players using the invite.number.X permission:

/lp user SpecialPlayer permission set invite.number.15 true

This gives SpecialPlayer exactly 15 invite slots, regardless of their group.

Priority: per-player limit (invite.number.X) always overrides the group limit.

Complete Example: Three-Tier Server

Section titled “Complete Example: Three-Tier Server”

config.yml

Section titled “config.yml”
luckperms:
  enabled: true
  group-limits:
    member: 3
    vip: 10
    admin: 99


default-invite-limit: 3   # fallback if no group match

LuckPerms Group Setup

Section titled “LuckPerms Group Setup”
/lp creategroup member
/lp creategroup vip
/lp creategroup admin


/lp group member permission set invite.use true
/lp group vip permission set invite.use true
/lp group vip permission set invite.temp true
/lp group admin permission set invite.admin true


/lp group default parent add member


/lp user Alice parent add vip


/lp user Alice info

Verify It Works

Section titled “Verify It Works”
/im profile Alice

Troubleshooting

Section titled “Troubleshooting”

“Group limits don’t seem to apply”

  • ✅ Confirm luckperms.enabled: true in config.yml
  • ✅ Run /im reload after editing config.yml
  • ✅ Check /im debug — LuckPerms should show Installed ✓
  • ✅ Verify the group name in config.yml matches exactly (case-sensitive)

“Player still has the default limit despite being in VIP group”

  • ✅ Check the player is actually in the group: /lp user PlayerName info
  • ✅ Reload InviteMe: /im reload
  • ✅ Make sure the group name matches exactly in config.yml

“LuckPerms shows ‘Not installed’ in /im debug”

  • ✅ Verify LuckPerms is loaded: /plugins (look for LuckPerms [enabled])
  • ✅ LuckPerms must load before InviteMe — check plugin load order
  • ✅ Restart the server (not just reload) if LuckPerms was recently installed

“invite.admin bypasses limits”

  • This is intentional. Players with invite.admin have no invite limit.

Next Steps

Section titled “Next Steps”