Skip to content
InviteMe InviteMe

/invite Command - Complete Guide

Manage player invitations on your server. This is the main command for regular players.

Command Syntax

Section titled “Command Syntax”
/invite <subcommand> [options]

ADD - Invite a Player

Section titled “ADD - Invite a Player”

Syntax

Section titled “Syntax”
/invite add <player-name> [days]

Permissions

Section titled “Permissions”
  • invite.use - Basic permission (default: true)
  • invite.temp - Required to use days parameter (default: false)

Permanent Invitations

Section titled “Permanent Invitations”

Invite someone indefinitely:

/invite add Steve
/invite add Alice_Smith

Output: ✓ Steve has been invited to the server!

What happens:

  • ✅ Steve is added to the whitelist immediately
  • ✅ Steve can now join the server
  • ✅ Your name is recorded as the inviter
  • ✅ Invitation is permanent (never expires)

Temporary Invitations

Section titled “Temporary Invitations”

Invite someone for a limited time (requires invite.temp permission):

/invite add Bob 7
/invite add Charlie 14
/invite add Diana 30

Output: ✓ Bob has been invited for 7 days!

What happens:

  • ✅ Bob can join for 7 days
  • ✅ After 7 days, he’s automatically removed from whitelist
  • ✅ He won’t receive a warning when expired
  • ✅ To extend, just invite again

Duration examples:

  • 1 - 1 day (24 hours)
  • 7 - 1 week
  • 30 - 1 month
  • 365 - 1 year

Common Mistakes

Section titled “Common Mistakes”

❌ Typo in username:

/invite add Stev    (wrong - no such player)
/invite add Steve   (correct)

❌ Missing permission:

  • Regular players can’t use days parameter
  • Admin: grant invite.temp permission via LuckPerms

REMOVE - Revoke an Invitation

Section titled “REMOVE - Revoke an Invitation”

Syntax

Section titled “Syntax”
/invite remove <player-name> [reason]

Permissions

Section titled “Permissions”
  • invite.admin - Required to remove invitations

Basic Removal

Section titled “Basic Removal”

Remove someone’s invitation:

/invite remove Steve
/invite remove Alex

Output: ✓ Steve has been removed from the server!

What happens:

  • ✅ Steve is removed from the whitelist
  • ✅ Steve is disconnected if currently online
  • ✅ Action is logged but no reason recorded

Removal with Reason

Section titled “Removal with Reason”

Remove with a logged reason:

/invite remove Steve Player left the server
/invite remove Alex Griefing
/invite remove Bob Inactive for 30 days

Output: ✓ Steve has been removed. Reason: Player left the server

What’s recorded:

  • ✅ Your name as the one who removed
  • ✅ The reason you provided
  • ✅ Exact timestamp
  • ✅ Can be viewed later with /im log list

When to Remove

Section titled “When to Remove”
  • Player left: “Player left the server”
  • Rule violation: “Griefing reported”
  • Inactivity: “No activity for 60 days”
  • Requested by player: “Player requested”
  • Temporary expired: “Temporary invite expired”

LIST - View Invitations

Section titled “LIST - View Invitations”

Syntax

Section titled “Syntax”
/invite list [player-name | all]

Permissions

Section titled “Permissions”
  • invite.use - Can see own invitations (default: true)
  • invite.admin - Can see anyone’s invitations

View Your Own Invitations

Section titled “View Your Own Invitations”
/invite list

Output:

Your Invitations (2/5):
- Alice (permanent, invited 5 days ago)
- Bob (7 days left, expires in 5 days)

Shows:

  • Total invitations / limit
  • Player names
  • Status (permanent vs temporary)
  • Time remaining for temporary invites

View Someone Else’s Invitations (admin only)

Section titled “View Someone Else’s Invitations (admin only)”
/invite list Steve
/invite list Alice

Output:

Steve's Invitations (1/10):
- John (permanent, invited 20 days ago)

View All Invitations on Server (admin only)

Section titled “View All Invitations on Server (admin only)”
/invite list all

Output:

Server Invitations (15 total):
- Alice: 3 invitations
- Steve: 2 invitations
- Bob: 5 invitations
...

TREE - Invite Chain

Section titled “TREE - Invite Chain”

Syntax

Section titled “Syntax”
/invite tree [player-name]

Permissions

Section titled “Permissions”
  • invite.use - View your own invite chain (default: true)
  • invite.admin - View another player’s chain

View Your Invite Chain

Section titled “View Your Invite Chain”

Shows the full ancestry of who invited you, who invited them, and so on — up to 20 levels deep.

/invite tree

Output:

Invite chain for: Alice
  Root: Console
    └─ Steve (invited by Console)
      └─ Alice (invited by Steve)

View Another Player’s Chain (admin only)

Section titled “View Another Player’s Chain (admin only)”
/invite tree Bob
/invite tree Charlie

Notes

Section titled “Notes”
  • The chain traces upward (who invited whom), not downward (who you invited — use /invite list for that)
  • Chains deeper than 20 links are shown truncated with a notice
  • If the player has no recorded inviter, a “not found” message is shown

MENU - Inventory GUI

Section titled “MENU - Inventory GUI”

Syntax

Section titled “Syntax”
/invite menu

Permissions

Section titled “Permissions”
  • invite.use - Can open menu (default: true)

What You See

Section titled “What You See”

A 4-row inventory interface:

Rows 1-3: Player heads (max 27 heads per page)

  • Click any head to see details
  • Right-click to remove/confirm
  • Heads show:
    • Player name
    • Invitation type (permanent/temporary)
    • Days remaining (if temporary)
    • Inviter name (if admin viewing)

Row 4 (Navigation):

  • ◄ Prev (left arrow) - Previous page
  • · Info (center dot) - Info
  • 🔘 Self (center) - Your own invitations
  • · Info (center dot) - Info
  • ► Next (right arrow) - Next page

Using the Menu

Section titled “Using the Menu”

  1. Click a head - See full details

  2. Right-click a head - Confirmation dialog:

    • 🟩 CONFIRM (left) - Confirm action
    • ⬜ CANCEL (middle) - Cancel
    • 🟥 REMOVE (right) - Remove invitation

  3. Navigate - Use arrows for multiple pages

Admin Features

Section titled “Admin Features”

When you have invite.admin:

  • See ALL players on server
  • See who invited each player
  • Remove any invitation
  • No player limit

Permission Summary

Section titled “Permission Summary”
PermissionCan DoDefault
invite.use/invite add (permanent), /invite list, /invite tree, /invite menutrue
invite.temp/invite add <player> <days> (temporary)false
invite.adminAll commands, see others, remove invitations, view any player’s treeop

Examples Scenario

Section titled “Examples Scenario”

Scenario: Running a Whitelist Server

Section titled “Scenario: Running a Whitelist Server”

Setup:

  • 20 player server
  • Each player gets 3 invitation slots
  • VIPs get 10 slots
  • Admins handle removals

Workflow:

  1. Alice invites her friend Bob:

    /invite add Bob

  2. Bob joins and plays, Bob invites Charlie:

    /invite add Charlie

  3. Check who’s invited:

    /invite list

  4. Admin checks server stats:

    /im stats

  5. Someone breaks rules (Charlie), admin removes:

    /invite remove Charlie Rule violation - griefing

  6. Check action log:

    /im log list

Troubleshooting

Section titled “Troubleshooting”

“Command not recognized”

  • ✅ Make sure you typed it correctly: /invite
  • ✅ Check plugin is loaded: /im debug

“You don’t have permission”

  • ✅ Check your permission: ask an admin
  • ✅ For temp invites: need invite.temp
  • ✅ For removal: need invite.admin

“Player doesn’t appear in menu”

  • ✅ Check you have the right username
  • ✅ Try: /invite list to confirm they’re invited
  • ✅ Reload: /im reload

Next Steps

Section titled “Next Steps”