Hyronic Mcmmo DocsParties
How mcMMO parties work - creating and managing one, how party levels and feature unlocks work, and the real XP-share and item-share math.
A party is a player-made group that grows stronger together. As members earn XP, the party levels up and unlocks features: party chat, teleport, alliances, and shared XP or items. Parties are managed entirely by mcMMO and are separate from any other party plugin.
At a glance
| Create with | /party create <name> |
| Party levels up from | every member's individual XP gains |
| Default level cap | 10 |
| Default max size | unlimited (-1) |
| Default friendly fire | off (party members can't hurt each other) |
| Default share range | 75 blocks |
Creating and managing a party
All party features run through /party <subcommand>. The most-used ones:
| Command | What it does |
|---|---|
/party create <name> | Create a party. |
/party create <name> <password> | Create a password-locked party. |
/party join <player> | Ask to join that player's party. |
/party accept | Accept a pending invite. |
/party invite <player> | Invite a player to your party. |
/party quit | Leave your party. |
/party info (or just /party) | Show members, level, and unlocked features. |
/party chat | Toggle party chat (or use /p <message>). |
/party teleport <player> | Warp to a party member (Teleport feature). |
/party itemshare <category> <mode> | Set item sharing. |
/party xpshare <NONE|EQUAL> | Set XP sharing. |
/party alliance <party> | Form/accept an alliance with another party. |
/party kick <player> | (Leader) remove a member. |
/party owner <player> | (Leader) transfer ownership. |
/party rename <name> | (Leader) rename the party. |
/party lock / /party unlock | (Leader) toggle invite-only. |
/party password <password> | (Leader) set/change the password. |
/party disband | (Leader) delete the party. |
/party ? | Show the full subcommand list. |
How a party levels up
Every time a member earns individual mcMMO XP, the party gains XP too. The XP needed for the next party level is the regular skill XP formula multiplied by the number of online members plus a modifier:
party XP to next level = normalXpForLevel(level) × (online members + Xp_Curve_Modifier)With the default Xp_Curve_Modifier: 3, a 2-member party needs × (2 + 3) = ×5 the base
XP per level, a 5-member party needs × 8, and so on. Bigger parties need more total XP per
level, but because everyone contributes, they still tend to climb steadily.
Reaching certain levels unlocks features (all under config.yml → Party.Leveling):
| Party level | Unlocks | Config key | Default |
|---|---|---|---|
| 1 | Party Chat (/p, /party chat) | Chat_UnlockLevel | 1 |
| 2 | Party Teleport (/party teleport) | Teleport_UnlockLevel | 2 |
| 5 | Alliances (/party alliance) | Alliance_UnlockLevel | 5 |
| 8 | Item Share | ItemShare_UnlockLevel | 8 |
| 10 | XP Share | XpShare_UnlockLevel | 10 |
The cap is Party.Leveling.Level_Cap (default 10). Raise it if you want progression to
continue past the last feature unlock.
XP Share
When XP Share is unlocked and set to EQUAL, the XP a member earns is split among all
nearby, online party members (including the earner). mcMMO adds a share bonus so the
group nets more than a solo player would - partly offsetting the split.
The exact math (from config.yml → Party.Sharing):
shareBonus = min( ExpShare_bonus_base + (membersSharing × ExpShare_bonus_increase),
ExpShare_bonus_cap )
each member receives = baseXP ÷ membersSharing × shareBonusDefaults: ExpShare_bonus_base: 1.1, ExpShare_bonus_increase: 1.05, ExpShare_bonus_cap: 1.5.
A subtle but important point: sharing always involves at least 2 members, so the bonus
is already 1.1 + (2 × 1.05) = 3.2 before the cap - which means with the default values
the bonus is always pinned at the cap, 1.5. In practice every sharing party gets a flat
×1.5 total, split evenly:
- 2 members: each gets
XP ÷ 2 × 1.5 = 0.75 × XP→ group total1.5 × XP - 3 members: each gets
XP ÷ 3 × 1.5 = 0.5 × XP→ group total1.5 × XP
The bonus_increase value only starts to matter if you lower base/increase or
raise the cap.
| Key | Default | Meaning |
|---|---|---|
ExpShare_bonus_base | 1.1 | Base of the bonus calculation |
ExpShare_bonus_increase | 1.05 | Added per sharing member |
ExpShare_bonus_cap | 1.5 | Maximum total multiplier (the effective value at defaults) |
Range | 75.0 | Max block distance to count as "nearby" for sharing |
A member must be within Range blocks of the earner (and online/visible) to get a share.
Members out of range get nothing from that XP gain.
Item Share
Item Share routes drops into the party. Configure it per category with
/party itemshare <category> <mode>:
- Categories: loot (mob drops), mining, herbalism, woodcutting, misc.
- Modes:
NONE- don't share this category.EQUAL- give one item to each in-range member if the stack is big enough; otherwise fall back to a single random member.RANDOM- give the whole drop to one random in-range member.
Server owner settings
Main toggles live under Party: in config.yml (and the master switch in party.yml):
| Key | Default | Meaning |
|---|---|---|
Party.Enabled (in party.yml) | true | Master on/off for the entire party system. |
Party.FriendlyFire | false | If true, party members can damage each other. |
Party.MaxSize | -1 | Max members (-1 = unlimited). |
Party.AutoKick_Interval | 12 | Hours between auto-kicking inactive members (0 = at server start only, -1 = never). |
Party.Old_Party_Member_Cutoff | 7 | Days of inactivity before a member is eligible for auto-kick. |
Party.Leveling.Level_Cap | 10 | Maximum party level. |
Party.Leveling.Xp_Curve_Modifier | 3 | Added to the online-member count in the party-XP formula. |
Party.Leveling.Near_Members_Needed | false | If true, the earner needs a party member nearby to grant party XP. |
Party.Leveling.Inform_All_Party_Members_On_LevelUp | false | Notify every member on party level-up, not just the earner. |
Permissions
Party commands live under mcmmo.commands.party.*; party gameplay perks under
mcmmo.party.*.
| Permission | Grants |
|---|---|
mcmmo.commands.party | Use /party at all. |
mcmmo.commands.party.all | All party subcommands. |
mcmmo.commands.party.chat | Party chat. |
mcmmo.commands.party.teleport | /party teleport. |
mcmmo.commands.party.itemshare | /party itemshare. |
mcmmo.commands.party.xpshare | /party xpshare. |
mcmmo.party.friendlyfire | The friendly-fire gameplay perk. |
See Permissions for the full tree.