Private Games Addon

PRIVATE GAMES ADDON

FOR MBEDWARS

This addon allows you to create matches that are restricted to members of your own party. Additionally to that, you may fun-up your experience by modifying various gameplay-changing attributes of the match!

Requirements

• 
  
  
  • Latest MBedwars version
  • Must use a party plugin supported by MBedwars (see wiki). You may register custom ones using the HookAPI (for developers)

Installation

1. 
   
   
   • Drop the plugin inside the following folder: /MBedwars/add-ons
   • Verify that you are running one of the supported party plugins
   • Open /MBedwars/lobby-hotbar.yml and add the following new items:
     

     private-leader-menu:
       name: '&e&lPrivate Match Menu' # The name the player will see
       slot: 2 # Make sure this does not collide with another item
       handler: private_games:leader_menu # Do not change
       item: chest # The item the player will
     
     private-force-start: ### OPTIONAL. Remove this if you don't want them to start matches with less than min players
       name: '&e&lForce Start' # The name the player will see
       slot: 7 # Should be equal to the force-start item. If it's not configured, use whatever you want
       handler: force_start:leader_menu # Do not change
       item: clock # The item the player will

   • That’s it! Check your console to verify whether the addon was able to hook with your parties plugin

Create a private match

1. Create a party using the party plugin that you use and invite members
2. Make sure you are the leader of the party
3. Make sure that you have the privategame.bypass.create permission
4. Type /privategames private to enable the private mode. Type it again to disable it
5. Join an arena while being in private mode. It may take a second, but you should receive the lobby items in the hotbar now. The chat should announce that as well

Permissions

• privateadmin.create: Ability to toggle private mode using /privategames private
• privategame.admin: Access to various admin commands
• Permissions to access the given buffs (config Per_buff_perm must be enabled):
  • privategame.buffs.onehit
  • privategame.buffs.health
  • privategame.buffs.gravity
  • privategame.buffs.respawn
  • privategame.buffs.nospawner
  • privategame.buffs.speed
  • privategame.buffs.falldamage
  • privategame.buffs.maxupgrade
  • privategame.buffs.blockprot
  • privategame.buffs.spawnrate

Filtering out private matches from /bw join, Arenas GUI etc.
This addon adds a new is_private arena condition variable ( see wiki). It returns a number that is either 1 (is private) or 0 (not private), representing the state of the arena.

Examples to ignore / hide private arenas:

• /bw join %best[status=2 & is_private=0]
• /bw arenasgui open <gui> <player> [is_private=0]

Configurations
They can be found at /MBedwars/add-ons/PrivateGamesAddon/settings.yml

Messages
They are all fully customizable. Visit the following Pastebin and copy&paste them inside MBedwars’ messages file (e.g. /MBedwars/language/English.yml). You are now free to customize them how ever you like.