Wikis / MythicRPG / Social

Social

MythicRPG ships two account-wide social subsystems: Parties (transient groups that share experience and loot) and Friends (a persistent friend list with online/offline notifications). Each is toggled independently, and both are fully scriptable through MythicMobs mechanics, conditions, targeters, and triggers.

Unlike profiles and waystones, party membership and friend lists are keyed to the player's account, not the active profile: switching profiles does not change your party or your friends.

Parties

A party is a transient group led by one member. The leader invites players with /party invite; an invite stays valid for Party.InviteExpirySeconds. A party holds up to Party.MaxSize members. Parties are not saved across restarts.

While Party.Enabled is on, parties drive three optional features.

Shared Experience

When Party.SharedExperience.Enabled is on, RPG experience earned from mob kills is shared with party members within Party.SharedExperience.Radius blocks of the earner (0 = no distance limit). Party.SharedExperience.Mode picks the split:

  • REPLICATE: each in-range member receives a copy of the earned amount, scaled by Party.SharedExperience.ShareMultiplier. The earner keeps the full amount.
  • SPLIT: the earned amount is divided evenly among the earner and the in-range members. ShareMultiplier is ignored.

Shared Loot

When Party.SharedLoot.Enabled is on, mob loot is distributed among party members within Party.SharedLoot.Radius blocks (0 = no limit). Party.SharedLoot.Mode picks the split:

  • ROUND_ROBIN: each dropped stack is handed to a single member, cycling through the party.
  • SHARE: every in-range member receives a copy of each dropped stack.

Party Chat

When Party.Chat.Enabled is on, /party chat toggles a party-only chat channel, or /party chat <message> sends a single message to the party.

Friends

The friends subsystem is a persistent, account-wide friend list. /friend add sends a request that stays valid for Friends.RequestExpirySeconds; the recipient accepts it with /friend accept. A player can hold up to Friends.MaxFriends friends. When a friend joins or leaves the server, the online/offline triggers fire so you can script notifications.

Commands

/party and /friend are available to every player (no permission node) while the matching subsystem is enabled. See Commands and Permissions for the canonical list.

/party (alias p)

Running /party with no arguments prints the command help.

Command Description
/party invite <player> Invite a player, creating a party if you have none. Aliases: add, i.
/party accept Accept a pending party invite. Alias: join.
/party deny Decline a pending party invite. Alias: decline.
/party leave Leave your current party. Alias: quit.
/party disband Disband your party (leader only).
/party kick <player> Remove a member from your party (leader only). Alias: remove.
/party promote <player> Hand party leadership to a member. Alias: leader.
/party list Show your party's members. Alias: info.
/party chat [message] Toggle party chat, or send a single message. Alias: c.
/party gui Open the party menu. Alias: menu.

/friend (aliases friends, f)

Running /friend with no arguments shows your friend list.

Command Description
/friend add <player> Send a friend request. Aliases: request, invite.
/friend accept <player> Accept a pending request. Alias: confirm.
/friend deny <player> Decline a pending request. Aliases: decline, reject.
/friend remove <player> Remove a friend. Aliases: delete, unfriend.
/friend requests List your incoming friend requests. Alias: pending.
/friend list Show your friend list.
/friend gui Open the friends menu. Alias: menu.

Configuration

All social settings live in config-rpg.yml under the top-level Social block (a sibling of Configuration, not nested inside it). Party.Enabled and Friends.Enabled each require a server restart to take effect; every other value applies on /mythicrpg reload.

Social:
  Party:
    Enabled: true
    MaxSize: 5
    InviteExpirySeconds: 60
    SharedExperience:
      Enabled: true
      Radius: 30
      Mode: REPLICATE                     # REPLICATE or SPLIT
      ShareMultiplier: 1.0
    SharedLoot:
      Enabled: true
      Mode: ROUND_ROBIN                   # ROUND_ROBIN or SHARE
      Radius: 30
    Chat:
      Enabled: true
  Friends:
    Enabled: true
    MaxFriends: 100
    RequestExpirySeconds: 120
Option Description Default
Party.Enabled Enable the party subsystem (/party, party skills, shared XP/loot). Requires a restart. true
Party.MaxSize Maximum players per party. Clamped to a minimum of 2. 5
Party.InviteExpirySeconds How long a party invite stays valid, in seconds. Clamped to a minimum of 5. 60
Party.SharedExperience.Enabled Share RPG experience from mob kills with nearby party members. true
Party.SharedExperience.Radius Blocks from the earner a member must be within to share. 0 = no limit. 30
Party.SharedExperience.Mode REPLICATE (each nearby member gets a copy) or SPLIT (earned XP divided evenly among earner and members). REPLICATE
Party.SharedExperience.ShareMultiplier REPLICATE only: scales each nearby member's share (e.g. 0.5 = half). Ignored for SPLIT. 1.0
Party.SharedLoot.Enabled Distribute mob loot among nearby party members. true
Party.SharedLoot.Mode ROUND_ROBIN (cycle members) or SHARE (every member gets a copy). ROUND_ROBIN
Party.SharedLoot.Radius Blocks from the drop a member must be within to share. 0 = no limit. 30
Party.Chat.Enabled Enable the party-only chat channel (/party chat). true
Friends.Enabled Enable the friends subsystem (/friend, online/offline notifications). Requires a restart. true
Friends.MaxFriends Maximum friends per player. Clamped to a minimum of 1. 100
Friends.RequestExpirySeconds How long a friend request stays valid, in seconds. Clamped to a minimum of 5. 120

MythicMobs Integration

The full surface MythicRPG exposes for scripting party and friend behavior.

Mechanics

Mechanic Description
partyGiveExperience Grants experience to every online member of the caster's party.
partyBuff Casts a meta-skill on each online member of the caster's party.
partyHeal Heals every online member of the caster's party.
partyMessage Sends a message to every online member of the caster's party.
partyTeleport Teleports the caster's online party members to a destination.

Conditions

Condition Description
inParty Whether the entity is currently in a party.
isPartyMember Whether the target shares a party with the caster.
isPartyLeader Whether the entity is the leader of their party.
partySize Whether the caster's party size is within the given range.
isFriend Whether the target is a friend of the caster.
friendsOnline Whether the caster's online-friend count is within the given range.

Targeters

Targeter Description
partyMembers The online members of the caster's party.
partyMembersInRadius The online party members within a radius of the caster.
partyLeader The leader of the caster's party.
onlineFriends The online friends of the caster.

Triggers

Trigger When it fires
~onPartyCreate A player forms a new party (fires for the new leader).
~onPartyJoin A player joins a party (fires for the joining player).
~onPartyMemberJoin Someone joins a party you are already in (fires for existing members).
~onPartyLeave A player leaves a party (fires for the leaving player).
~onPartyMemberLeave A member of your party leaves (fires for the remaining members).
~onPartyMemberDeath A member of your party dies (fires for the other members).
~onPartyLeaderChange Party leadership changes (fires for the members).
~onPartyDisband The party is disbanded (fires for the members).
~onFriendAdd A friend request is accepted (fires for both players).
~onFriendRemove A friend is removed (fires for both players).
~onFriendOnline One of your friends joins the server.
~onFriendOffline One of your friends leaves the server.

Placeholders

See the Placeholders page for the party and friend PAPI surface.

Updated Aug 19, 2026