NightExpress's Plugins Wiki

A complete party system for your players, fully compatible with the whole plugin and other plugins as well!

Party Creation:

  • Define the maximal party size and change it depends on player permission group.
  • Define if party should be auto-disbanded when leader leaves.​

Party Interaction:

  • Party GUI with interactive buttons.
  • Sounds for each party action.​
  • Chat channel for party members.
  • Teleport to party members with cooldown.
  • Auto-transfer party leader when current leader leaves.
  • Wait for player reconnect before auto-kick from the party.​

Compatibility:

  • Party Drop Mode:
    • Requires Loot module enabled to work.
    • Free mode: Allows any party member to view and take loot.
    • Auto mode: Selects random party member and make him owner of the loot.
    • Leader mode: Allows only party leader to view and take loot.
    • Roll mode: Allows any party member view and click the loot to start Roll the Dice. The right of possession of rolled item will be given to the member with highest dice value.​
  • Party Exp Mode:
    • Plugins supported: SkillAPI
    • Define the max. distance for Shared mode.
    • Shared mode: Will balance the exp between all the party members.
    • Killer mode: Will give the exp only to the mob killer.​
  • Quest Objectives:
    • Plugins supported: QuestCreator, MangoQuest
    • Mob kill objective: Counts the kill for each party member quest in specified radius from the mob.​

Media:


Settings.yml

Default module settings are described HERE.

# Party settings
party:
  # Default max party size
  max-size: 6
  # Auto-disband if leader leaves party
  leader-leave-disband: false
  # Time to accept party invite
  invite-timeout: 60
  # Auto-leave from party on disconnect
  quit-auto-leave: false
  # Time (in mins) before player will be kicked from the party while offline
  quit-timeout: 10
  # Teleport cooldown
  tp-cooldown: 60

# Party chat settings
chat:
  # Enable/Disable party chat.
  enabled: true
  #+--------------------------------------------------+
  # Party chat format.
  # NEVER use '%' placeholders such as '%player%', etc. For PlaceholderAPI use '{}' like '{player}'.
  #
  # Internal placeholders:
  # - {player} - Player name.
  # - {message} - Message
  #
  # External placeholders:
  # - PlaceholderAPI
  #+--------------------------------------------------+
  format: '&9[Group] &l{player}: &7{message}'

# Overrides the default party max size by a value of player rank below.
size-permissions:
  # Permission group name : Size
  vip: 8
  premium: 10

hooks:
  # Settings for Level/Exp plugins, that support QuantumRPG.
  level-plugins:
    # When 'true', enables the settings below
    enabled: true
    # Balance exp from level plugins: Exp dropped from mobs will be divided into nearest (or all) party members.
    # For exmaple: When mob drops 20 exp and party has 4 members, each member will got 5 exp.
    balance-exp:
      # Should we 'balance' the exp dropped from mobs for all party members?
      enabled: true
      # Maximal distance, where exp balance will be affected to party members.
      # Set this to 0 or -1 to disable the distance check.
      max-distance: 25
  
  # Compatibility for Quest plugins to do with party.
  quest-plugins:
    # When 'true', enables the settings below.
    enabled: true
    # Compatibility for quest objectives.
    objectives:
      # Mob Kill objective. When party member kills an mob, it will count the kill for each party member, who has an active quest to kill this mob.
      mob-kill:
        # Enable/Disable support for this objective
        enabled: true
        # Maximal distance from killer to party member to count the mob kill.
        # Set this to 0 or -1 to disable the distance check.
        max-distance: 25

# Sound for party actions
sounds:
  CREATE: ENTITY_FIREWORK_ROCKET_TWINKLE
  INVITE: BLOCK_NOTE_BLOCK_BASS
  JOIN: ENTITY_EXPERIENCE_ORB_PICKUP
  LEAVE: ENTITY_EXPERIENCE_ORB_PICKUP
  KICK: BLOCK_ANVIL_PLACE
  DISBAND: BLOCK_GLASS_BREAK
  QUIT: ENTITY_EXPERIENCE_ORB_PICKUP
  BACK: ENTITY_EXPERIENCE_ORB_PICKUP
  TP: ENTITY_ENDERMAN_TELEPORT

#+-----------------------------------------------------------------------------------------------------------+
# Party GUI menu.
# For plugin GUI format see HERE.
#
# Allowed item types:
# - PARTY_MEMBER - Displays skin of a member (for head items) and binds Teleport on LMB and Kick on RMB.
# - PARTY_DISBAND - Disbands the party on click. Leader only.
# - PARTY_LEAVE - Leaves the party on click.
# - PARTY_DROP - Toggles party drop mode. Leader only.
# - PARTY_CHAT - Toggles party chat mode.
#
# Internal placeholders:
# - %online% - Displays party member online status. Only for PARTY_MEMBER type.
# - %name% - Displays party member name. Only for PARTY_MEMBER type.
# - %party_name% - Displays party name.
# - %party_size% - Displays party max. size.
# - %party_members% - Displays amount of party members.
# - %party_leader% - Displays party leader name.
# - %party_drop% - Displays party drop mode.
#
# External placeholders:
# - PlaceholderAPI
#+-----------------------------------------------------------------------------------------------------------+
gui:
  title: '&4&l<&4&nParty&4&l>'
  size: 54
  content:
    filler_black:
      material: 'BLACK_STAINED_GLASS_PANE:0:1'
      skull-hash: ''
      enchanted: false
      name: ''
      lore: []
      slots: '9,10,11,12,13,14,15,16,17,45,46,47,48,49,50,51,52,53'
      type: NONE
    filler_gray:
      material: 'LIGHT_GRAY_STAINED_GLASS_PANE:0:1'
      skull-hash: ''
      enchanted: false
      name: ''
      lore: []
      slots: '18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44'
      type: NONE
    party_member:
      material: 'PLAYER_HEAD:0:1'
      skull-hash: ''
      enchanted: false
      name: '&eParty Member'
      lore:
      - '&7> &fOnline:           &e%online%'
      - '&7> &fName:             &e%name%'
      - '&8&m                                      '
      - '&7This is member of your party.'
      - ''
      - '&8&oLeft-Click to &6&oTeleport'
      - '&8&oRight-Click to &c&oKick'
      slots: '18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44'
      type: PARTY_MEMBER
    party_disband:
      material: 'BARRIER:0:1'
      skull-hash: ''
      enchanted: false
      name: '&4Disband Party  &c[Leader only]'
      lore: []
      slots: '0'
      type: PARTY_DISBAND
    party_chat:
      material: 'FEATHER:0:1'
      skull-hash: ''
      enchanted: false
      name: '&7Toggle Party Chat'
      lore:
      - '&7Toggle chat channel to party chat.'
      slots: '2'
      type: PARTY_CHAT
    party_info:
      material: 'MAP:0:1'
      skull-hash: ''
      enchanted: false
      name: '&6Party Info'
      lore:
      - '&7> &fName:             &6%party_name%'
      - '&7> &fLeader:           &6%party_leader%'
      - '&7> &fMembers:          &e%party_members%/%party_size%'
      - '&7> &fDrop mode:        &e%party_drop%'
      - '&8&m                                      '
      - '&7'
      slots: '4'
      type: NONE
    party_drop:
      material: 'CHEST:0:1'
      skull-hash: ''
      enchanted: false
      name: '&6Toggle Drop Mode &c[Leader only]'
      lore:
      - '&7> &fDrop mode:        &e%party_drop%'
      - '&8&m                                      '
      - '&7Toggles party drop mode.'
      slots: '6'
      type: PARTY_DROP
    party_leave:
      material: 'IRON_DOOR:0:1'
      skull-hash: ''
      enchanted: false
      name: '&9Leave Party'
      lore: []
      slots: '8'
      type: PARTY_LEAVE
Navigation