Inventory GUI Guide

The /invite menu command opens an interactive inventory interface — the easiest way to manage your invitations without memorizing commands.

/invite menu

Permission: invite.use (default: true for all players)

Interface Layout

The menu is a 4-row inventory (36 slots):

┌─────────────────────────────────────────────────────────────┐
│ Row 1 │ Invited player heads  (slots  0–8)                  │
│ Row 2 │ Invited player heads  (slots  9–17)                 │
│ Row 3 │ Invited player heads  (slots 18–26)                 │
│ Row 4 │ [◄][Filter][Self][ ][Page][ ][Inviter][ ][►]       │
│        │  27   28    29  30   31  32    33     34  35       │
└─────────────────────────────────────────────────────────────┘

Rows 1–3: Invited Player Heads (Slots 0–26)

Each slot shows the skull of an invited player. Up to 27 players per page, sorted from newest to oldest invitation. Your own entry is never shown.

Head Lore

Hovering over a head shows:

PlayerName [Online] ⚡         ← name + online status + boost badge (if active)
─────────────────────────────
Invited by: Alice              ← admin view only
Invited on: 2024-01-15 14:30
Permanent                      ← or "Expires: 2024-02-15 14:30"  ¹

Mutual boost: Active           ← or "Mutual boost: Inactive"
XP given: 340                  ← per-pair XP stats (non-admin only)
XP received: 210

★ Favourite                    ← shown only if marked as favourite
Right-click to toggle favourite

Click to uninvite              ← admins only (not shown for other admins/OPs)

¹ The expiry line is only visible to admins or players with the invite.temp permission. Regular players without that permission do not see expiry dates.

Click Interactions

Action	Who	Result
Left-click	Admin only	Opens uninvite confirmation dialog
Right-click / Shift+Right-click	Everyone	Toggles favourite for that player

Left-click does nothing for non-admins. Admins cannot uninvite another admin or OP via the GUI.

Available Slot Indicators (non-admin view only)

When viewing your own invitations with the favourites filter off, empty slots in rows 1–3 display coloured glass panes indicating your remaining invite capacity:

Glass colour	Meaning
Light Blue	Available slot from your base limit (`max-invites` / permissions / group)
Lime Green	Bonus slot unlocked through Plugin XP progression

These indicators only appear up to your current invite limit. Slots beyond the limit are left empty. They disappear when the favourites filter is active or when you are in admin view.

Slot	Item	Action
27	Arrow — Previous	Go to previous page (hidden if on page 1)
28	Filter button	Toggle favourites-only filter (lime dye = active, gray dye = off)
29	Your own head	Shows your stats; click to refresh
30	Filler (gray glass)	—
31	Paper — Page info	Page number, entry count, and slot usage
32	Filler (gray glass)	—
33	Inviter head	Shows who invited you; BARRIER icon if no inviter on record
34	Filler (gray glass)	—
35	Arrow — Next	Go to next page (hidden if on last page)

Slot 28 — Favourites Filter

Click to toggle a filter that shows only the heads you have right-clicked to mark as a favourite. The button material changes:

Lime Dye — filter is active
Gray Dye — filter is off (showing all)

Click again to deactivate the filter and show all invitees.

Slot 29 — Self Head

Your own skull. The lore updates every second automatically (live boost stats). Clicking it forces an immediate refresh from the database.

Boost Activity (always visible)

Time spent inside an active mutual-boost range
Vanilla XP earned while boost was active
Net boost XP (the bonus portion from the multiplier only)

Invite XP Level (only when plugin-xp-slots.enabled: true)

Current level
XP progress toward the next level, or “Max level” if capped
Number of bonus invite slots currently unlocked (if any)

XP Sharing (always visible)

Total XP shared with your invited players
Total XP received from players who invited you

Slot 31 — Page Info

Shows a PAPER item with pagination details. The format differs by role:

Role	Display
Admin	`Page X / Y · N entries`
Regular player	`Page X / Y · N / LIMIT slots`

The regular-player format shows how many of your invite slots are used vs your current limit (including any XP bonus slots).

Slot 33 — Inviter Head

Shows the skull of whoever invited you to this server. The lore includes:

The date you were invited
Mutual boost status with your inviter (active / inactive)
Per-pair XP stats: XP you received from them and XP you gave to them

Special cases:

Situation	What appears
You were invited by a player	Their player skull with the lore above
You were invited by Console (or `/whitelist add`)	A special Observer skull texture with the inviter’s display name
You have no invite record at all	A BARRIER icon with a “No inviter” message

Uninvite Confirmation Dialog

When an admin left-clicks a player’s head, a 3-row confirmation inventory opens:

┌──────────────────────────────────────────────────┐
│                                                  │
│  [🟩 CONFIRM]    [Player Head]    [🟥 CANCEL]    │
│     slot 11         slot 13         slot 15      │
│                                                  │
└──────────────────────────────────────────────────┘

Button	Material	Action
CONFIRM (slot 11)	Lime Terracotta	Remove the player’s invite and return to the list
CANCEL (slot 15)	Red Terracotta	Go back to the invite list without changes

Closing the inventory (Escape) also cancels.

Admin View

Players with invite.admin see a different version of the menu:

All invited players server-wide (not just their own)
Inviter name shown in each head’s lore
Left-click on any head to uninvite (except other admins/OPs)
No slot limit per page (pagination works the same way)

The SELF head (slot 29) and INVITER head (slot 33) always reflect your own stats and inviter, regardless of admin/non-admin view.

Tips

Remove a player quickly:

/invite menu
Find their head → left-click (admin required)
Click CONFIRM

Mark your favourite invitees:

Right-click any head to star it
Click the Filter button (slot 28) to show only favourites
Useful for keeping track of active boost partners

Heads are sorted newest → oldest, so recently invited players appear first.

Troubleshooting

“The menu opens empty”

✅ You haven’t invited anyone yet — use /invite add PlayerName
✅ Run /invite list to confirm your invitations exist

“I can’t see other players’ invitations”

✅ You need invite.admin to see all players
✅ Regular players only see their own invitations

“Left-clicking a head does nothing”

✅ Uninvite is admin-only; non-admins use right-click to toggle favourite
✅ Admins cannot uninvite other admins or OPs via the GUI

“The inviter head shows a barrier icon”

✅ Your account was added to the whitelist manually (no /invite add was used) — no invite record exists

“The inviter head shows an Observer-style skull, not a player face”

✅ Your inviter was Console (or a non-player source like /whitelist add via sync) — this is by design

“I can’t see when an invite expires”

✅ Expiry dates are only visible to admins (invite.admin) or players with invite.temp permission
✅ Ask an admin to check, or use /invite list if you have access

“I don’t see light blue or lime glass in empty slots”

✅ Glass slot indicators only appear in your own view (non-admin) with the favourites filter off
✅ In admin view, unused slots are always left empty

“The menu shows outdated information”

✅ Close and reopen with /invite menu — data is refreshed on open
✅ Click your own head (slot 29) to force-refresh your boost stats without closing

Next Steps

📖 Command reference: /invite Command Guide
⚙️ Permissions: Permissions Guide
⚡ Boost system: Mutual Boost Guide
❓ FAQ: Frequently Asked Questions