Invite Boost System
InviteMe includes an XP boost system that rewards players connected by an invite link. When two linked players are near each other, both receive a bonus XP multiplier — and a share of each other’s XP.
What Creates a Boost Link?
Section titled “What Creates a Boost Link?”A boost link exists when one player invited the other — in either direction:
Alice invited Bob ← /invite add BobThat single invite is enough. Bob cannot invite Alice back because Alice was already on the server before him. The “mutual” part refers to the benefit: both players receive the boost, not to both having invited each other.
A one-way invite creates the link. Bidirectional invites are not possible or required.
How the Boost Works
Section titled “How the Boost Works”When two linked players are online, in the same world, and within range:
- Vanilla XP events are intercepted (mining, mob kills, breeding, etc.)
- The XP amount is multiplied by the configured factor (default: ×1.5, cap: ×2.5)
- A percentage of the original XP is also shared with the nearby partner (default: 25% — XP sharing)
- Boost time is tracked in seconds while in range
- All stats are saved to InviteMe’s database per pair
Proximity & Radius
Section titled “Proximity & Radius”The boost activates when both players are within the configured radius. The radius differs by dimension:
| Dimension | Default radius |
|---|---|
| Overworld | 50 blocks |
| Nether | 75 blocks |
| End | 100 blocks |
Both players must be in the same world. Custom per-world radii can also be set in config.yml.
The proximity is checked on a configurable interval (default every 5 seconds, configurable via check-interval).
Streak / Combo
Section titled “Streak / Combo”While the boost is active, consecutive XP events within a short time window (default: 10 s) build a streak. The action bar shows the total XP accumulated in the streak and the combo count. If no XP event happens within the window, the streak ends with a “combo broken” notification.
Cooldown
Section titled “Cooldown”When a player leaves the boost radius, a cooldown starts (default: 30 s) before the boost can re-activate. This prevents the multiplier from flickering on/off when players move in and out of range.
Visual Feedback
Section titled “Visual Feedback”| Event | Effect |
|---|---|
| Boost activates | HAPPY_VILLAGER particles + beacon activate sound + action bar |
| Boost deactivates | Red dust particles + beacon deactivate sound + action bar with cooldown |
| XP event during boost | Action bar showing streak total and combo count |
Multiple Boost Partners
Section titled “Multiple Boost Partners”A player can have boost links with multiple people at the same time:
Alice → Bob (Alice invited Bob)Alice → Charlie (Alice invited Charlie)If all three are near each other, Alice boosts with Bob and Charlie simultaneously. There is a configurable maximum (default: 3 partners, range: 1–10). If a player has more invite links than the maximum, the closest ones within range take priority.
Tracking Your Stats
Section titled “Tracking Your Stats”Via the GUI Menu
Section titled “Via the GUI Menu”Open /invite menu and hover over the Self head (slot 29):
Boost Activity (always shown)
| Stat | Meaning |
|---|---|
| Boost time | Total time spent within range of a boost partner |
| Boosted vanilla XP | Total vanilla XP received while the boost was active |
| Net boost XP | Bonus XP from the multiplier (boosted − original) |
Invite XP Level (only shown when plugin-xp-slots.enabled: true)
| Stat | Meaning |
|---|---|
| Level | Current invite level, earned by accumulating boost XP |
| XP progress | Current XP toward the next level |
| Bonus invite slots | Extra invite slots unlocked at this level |
XP Sharing
| Stat | Meaning |
|---|---|
| Shared given | XP you have shared with your nearby boost partners |
| Shared received | XP you have received from nearby boost partners |
Via the per-pair head
Section titled “Via the per-pair head”Each invited player’s head in /invite menu also shows the XP exchanged specifically with that person (XP given / XP received), so you can track who you boost with most.
Via Admin Command
Section titled “Via Admin Command”/im boost status [player]Shows whether a player has an active boost and who their current partners are. See the /im Command Guide for full details.
Example Scenario
Section titled “Example Scenario”Setup: Alice is an existing player. She invites Bob with /invite add Bob.
Session:
- Bob joins the server for the first time
- Alice and Bob are both online and play near each other
- Alice mines a diamond ore → Alice’s XP is multiplied (×1.5) and Bob receives 25% of the original XP as a share
- Bob kills a mob → Bob’s XP is multiplied and Alice receives a share
- They stay within range for 30 minutes — 30 min of boost time is logged for both
After uninviting:
If Alice runs /invite remove Bob, the boost link is removed. Any XP stats already accumulated are kept.
Frequently Asked Questions
Section titled “Frequently Asked Questions”Does Bob need to invite Alice back? No. One invite in either direction creates the link. Bob cannot invite Alice back anyway because she was already on the server.
Do both players need to be online for the boost? Yes — the boost only activates when both linked players are on the server and within range.
Does the boost work across worlds? No — both players must be in the same world.
What happens when a player is uninvited? The boost link is removed immediately. Accumulated XP stats are kept.
Is there a maximum number of boost partners?
Yes — configurable via max-boost-partners (default: 3, max: 10). The boost activates with the closest eligible partners up to the limit.
Next Steps
Section titled “Next Steps”- 📊 View statistics: Statistics & Logging
- 📖 Invite command: /invite Command Guide
- 🔧 Boost admin tools: /im Command Guide
- 🔑 Permissions: Permissions Guide