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.
Shared combo: The streak is shared across all nearby boost partners. When one player earns XP, the combo timers of their active partners are also reset and each partner’s combo count increments. Partners see the exact same action bar notification as the earner (⚡ +{total} XP · x{combo} combo) — but their {total} reflects the bonus XP they personally racked up during the streak (their own boosted gains plus anything received via XP sharing), not the earner’s. This means: as long as any player in the group is earning XP, the streak stays alive for everyone — it only expires when the whole group goes 10 s without any XP event. Because the same tracking drives the “combo broken” notification too, when the shared streak ends, every player in the group — earner and partners alike — sees their own bonus XP total in that message, not just the person who triggered the XP events.
Reward Scaling (Combo Rewards)
Section titled “Reward Scaling (Combo Rewards)”The streak isn’t just visual — it can also scale your actual boost reward. xp-multiplier and xp-sharing.share-percentage set the base values you get the instant the boost activates (so it always feels good from second one), and an optional combo rewards layer adds a bonus on top that grows with how consistently you generate your own XP.
That bonus is driven by your active combo — a personal counter that increases only on your own XP events, never on XP received through sharing from a partner. It follows the same window as the streak: go longer than streak-window-seconds (default 10 s) without generating your own XP, and your active combo resets to 0, dropping your bonus back to the base value. Riding along with a partner who’s actively grinding keeps the shared streak alive for both of you, but only the partner actually generating XP grows their own reward bonus.
The bonus follows a logarithmic curve — it grows quickly at first and then flattens out, so chasing extreme combos stops being mathematically worth it. This keeps the system self-limiting on its own, with the hard caps (max-multiplier / max-share-percentage) acting as a final safety net rather than the main control:
effective multiplier = min(base multiplier + multiplier-log-scale × ln(1 + active combo), max-multiplier)effective share % = min(base share % + share-log-scale × ln(1 + active combo), max-share-percentage)Configurable under mutual-invite-boost.combo-rewards in config.yml:
| Option | Meaning |
|---|---|
enabled | Turns the scaling on/off (default: true). When false, the multiplier and share % stay fixed at their base values — the original behavior |
tier-thresholds | Shared-combo counts that define the visual tiers (color/sound/particle escalation) — see below |
multiplier-log-scale | How fast the multiplier bonus grows with your active combo |
share-log-scale | How fast the XP-sharing bonus grows with your active combo |
max-share-percentage | Hard cap on the effective share %, mirroring max-multiplier |
Check your current effective values anytime with /im boost status [player] (shows both the base and the effective multiplier/share %) or the %inviteme_boost_multiplier% / %inviteme_boost_percentage% placeholders.
Visual Escalation & Milestones
Section titled “Visual Escalation & Milestones”As the shared combo grows, its on-screen color escalates through tiers — and crossing one of the configured thresholds (tier-thresholds, default [10, 25, 50, 100]) triggers a one-time milestone celebration for the whole group: an on-screen title, a sound, and particles, scaled in intensity to the tier reached.
The combo’s color also tells you, at a glance, whether you are currently fueling it: while your active combo is “warm” (you’ve generated XP within the streak window), the number glows in the tier’s full color; if you’re riding along without generating your own XP, it shows in a dimmed gray instead — same number, same streak, just an honest signal about who’s contributing right now. Generating XP again brings your color back instantly, without ever breaking the shared streak.
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 (earner) | Action bar showing own streak total and combo count |
| XP event during boost (partner) | Same action bar format, showing the partner’s own bonus XP total and shared combo count |
| Shared streak ends | Every player in the group sees a “combo broken” action bar with their own accumulated bonus XP |
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