BattleArena/ConfigAdvanced

From Battle Plugins
Jump to: navigation, search
Bdwikiheader.png

PAGE MOVED - clovisd

AdvancedBA.png
Please excuse the messiness of this page, it is still a work in progress

Server Currency

If your server has a form of currency, you can tell BattleArena the name so it can display accurate messages.

 moneyName: Gold

Adding New Classes

Here are some examples of adding classes:

 classes:
     gladiator:
         items:
             - diamond_sword: sharp:1 1
             - bow: 1
             - arrow: 32
             - diamond_helm: 1
             - diamond_chest: 1
             - diamond_leggings: 1
             - diamond_boots: 1
             - 373;8229: 1 # potion of healing 2
             - 373;8193: 1 # potion of regen
             - 373;16396: 1 # splash potion of harming 1
         enchants:
             - speed:1:900
             - resistance:1:900
     archer:
         items:
             - iron_sword: sharp:1 1
             - bow: flame:2 power:3 punch:2 1 
             - arrow: 32
             - leather_helm: 1
             - iron_chest: prot:3 1
             - leather_leggings: 1
             - leather_boots: 1
             - 373;8229: 1 # potion of healing 2
             - 373;8193: 1 # potion of regen
             - 373;16396: 1 # splash potion of harming 1
     monk:
         items:
             - leather_helm: 1
             - leather_chest: 1
             - leather_leggings: 1
             - leather_boots: 1
             - 373;8229: 2 # potion of healing 2
             - 373;8193: 2 # potion of regen
             - 373;16396: 3 # splash potion of harming 1
         enchants:
             - strength:3:900 # increase attack power
             - speed:2:900 # increase movement
             - haste:3:900 # increase attack speed
             - resistance:2:900 # reduce damage taken
             - jump:2:900 # jump 2 blocks higher than normal
             - regen:1:900 # regen life

default Match Options (these can be overridden by each match type)

defaultMatchOptions:

   secondsTillMatch: 3 ## Time between onPrestart and onStart
   secondsToLoot: 5 ## Time after winning to run around and collect loot
   matchTime: 120 ## How long do timed matches last, (in seconds)
   matchUpdateInterval: 30 ## For timed matched, how long between sending players match updates
   eventCountdownTime: 180 ## How long before announcing an automated event and its start
   eventCountdownInterval: 60 ## How often will it announce a reminder that its open and you can join
   ### Match Announcements
   ## these only affect the broadcasts, not the messages the fighting players receive
   ## announce : announce this message to the server
   ## hc=<channel> : use herochat with the channel specified
   announcements:
       onPreStart: [announce, hc=pvp ]  ## match going to happen soon, example 'P1[p1Elo] vs P2[p2elo]'
       onVictory: [announce, hc=pvp ] ## match has been won, exmaple 'P1[p1elo] has defeated P2[p2elo]'
      1. Prerequisites
  1. prerequisites is what they need to have BEFORE joining, this will also be rechecked when the players teleport in
  2. if there is money, this is taken from their account when they type the command to join
  3. Prerequisite Options
  4. needsArmor
  5. needsItems: if specified you need an item list below
  6. money=<amount of money>
  7. maxElo=<maximum elo to join>
  8. minElo=<minimum elo to join>
      1. Match Stages
  1. onOpen: *only called for events, such as ffa/tourney, that have an open stage.
  2. onPrestart: happens secondsTillMatch seconds before onStart
  3. onStart: Start of match
  4. onVictory : happens when match is won by a player
  5. onComplete: What happens after the match, happens between the time period (onVictory + timeToLoot)
  6. if onComplete contains clearInventory it will not allow a player to take inventory out of the arena
  7. (except for prize items, or givenItems from onComplete)
      1. Match Transition Events
  1. onSpawn: Happens on teleport or on player Respawn ( if respawn is set within onDeath)
  2. onDeath: What happens when a player dies
  3. onJoin: player joining a match
  4. onEnter: Happens when the player first enters the arena. right after before they are teleported in.
  5. onLeave: Happens when the player leaves the arena(aka if they win(after onComplete), or if they die(and dont respawn) )
      1. Prizes
  1. winner: given to the winner after onComplete
  2. losers: given to the losers after onComplete
  3. firstPlace: (for tourneys) given to winner after tournament complete
  4. participants: (for tourneys) given to all participants(except winner) after tournament complete
  1. valid options for everything but preReqs
  2. clearInventory,
  3. giveItems: needs a list under items
  4. teleportIn
  5. teleportOut
  6. pvpon or pvpoff
  7. health=<health amount>
  8. hunger=<hunger amount>
  9. money=<money to give>
  10. experience=<exp to give>
  11. teamPvpOn : if not specified defaults to off
  12. respawn:
  13. enchants: needs a list of enchants under enchants
  14. deEnchant: get rid of all potion effects on player
  15. disguiseAll=<name>: disguise all players with the given value
  16. undisguise: undisguise players
  17. storeExperience/restoreExperience: store/restore Experience
  18. storeItems/restoreItems : store/restore items
    1. Defaults: these events(if not overwritten) get filled with the following values
  1. onEnter:
  2. options: [storeExperience, storeItems(if preReqs contains clearInventory)]
  3. onLeave:
  4. options: [restoreExperience, restoreItems(if preReqs contains clearInventory)]
        1. Events vs Matches
      1. Events
    1. Events can have "open" phases were people are joining but the event hasnt started
    2. They also can have multiple "matches" that occur as part of the event (like a tournament, where
    3. each match is part of the whole 'Tournament Event')
    4. Some Events like the FreeForAll only have 1 match, but still have the open phase that lasts until someone starts it
      1. Match
    5. a single battle between teams
      1. Arena
arena:
    enabled: true
    type: versus
    tracking:
        dbTableName: arena
    rated: true
    prefix: "&6[Arena]&e"
    onJoin:
        options: [pvpOff]
    preReqs:
        options: [clearInventory]
    onStart:
        options: [teleportIn, pvpOn,blockBreakOff]
    onSpawn:
        options: [deEnchant, giveItems, hunger=20, health=20]
        giveClass:
            default: gladiator
        items: # ignored if options doesnt have "giveItems"
            - bread: 5
    onComplete:
        options: [teleportOut, clearInventory]
    winner:
        options: [health=20, hunger=20]
      1. Skirmish
skirmish:
    enabled: true
    type: versus
    database: arena
    rated: false
    prefix: "&b[Skirmish]&e"
    onStart:
        options: [teleportIn, pvpOn, blockBreakOff]
    onComplete:
        options: [teleportOut]
    winner:
        options: [health=20, hunger=20]
 
      1. BattleGround
battleground:
    enabled: true
    command: bg
    type: battleground
    database: bg
    prefix: "&c[Battleground]&e"
    victoryCondition: highestKills
    matchTime: 60
    minTeams: 2
    minTeamSize: 5
    maxTeamSize: 5
    preReqs:
        options: [clearInventory]
    onJoin:
        options: [pvpOff]
    onPrestart:
        options: [pvpOff, teleportIn, giveItems, deEnchant, disguiseAllAs=ArenaGuy]
        giveClass:
            default: gladiator
            team1: archer
            team2: monk
            team3: gladiator
        items: # ignored if options doesnt have "giveItems"
            - bread: 5
    onStart:
        options: [pvpOn]
    onComplete:
        options: [teleportOut, clearInventory, deEnchant, undisguise]
    onSpawn:
        options: [enchants, health=20, hunger=20, deEnchant, disguiseAllAs=ConfusedGuy,woolTeams]
        enchants:
            - speed:3
    onDeath:
        options: [respawn]
    winner:
        options: [enchants, money=1,experience=300, health=20, hunger=20]
        enchants:
            - speed:1:900
            - resistance:1:900
      1. Colliseum
colliseum:
    enabled: true
    command: col
    type: colliseum
    database: col
    victoryCondition: highestKills
    matchTime: 60
    minTeams: 4
    preReqs:
        options: [clearInventory]
    onJoin:
        options: [pvpOff]
    onPrestart:
        options: [pvpOff, teleportIn, deEnchant]
    onStart:
        options: [pvpOn]
    onComplete:
        options: [teleportOut, clearInventory, deEnchant, undisguise]
    onSpawn:
        options: [enchants, health=20, hunger=20, deEnchant,giveItems, woolTeams]
        enchants:
            - speed:1
        items: # ignored if options doesnt have "giveItems"
            - diamond_sword: sharpness:1 1
            - bow: 1
            - arrow: 32
            - diamond_helm: 1
            - diamond_chest: 1
            - diamond_leggings: 1
            - diamond_boot: 1
    onDeath:
        options: [respawn, clearInventory]
    winner:
        options: [enchants, money=1,experience=300, health=20, hunger=20]
        enchants:
            - speed:1:900
            - resistance:1:900
        1. EVENTS ####
      1. FFA Event
freeForAll:
    enabled: true
    command: ffa
    type: ffa
    database: ffa
    prefix: "&c[FFA]&e"
    preReqs:
        options: [clearInventory]
    onJoin:
        options: [teleportIn, woolTeams]
    onOpen:
        options: [pvpOff]
    onPrestart:
        options: [pvpOff, giveItems, deEnchant]
        items: # ignored if options doesnt have "giveItems"
            - iron_sword: 1
            - bow: 1
            - tnt: 3
            - arrow: 32
            - leather_helm: 1
            - leather_chest: 1
            - leather_leggings: 1
            - leather_boot: 1
            - bread: 5
    onStart:
        options: [pvpOn]
    onComplete:
        options: [teleportOut, clearInventory, deEnchant, undisguise]
    onSpawn:
        options: [enchants, health=20, hunger=20, deEnchant]
        enchants:
            - speed:3
    winner:
        options: [enchants, money=1,experience=300, health=20, hunger=20]
        enchants:
            - speed:2:900
            - resistance:2:900
      1. Death Match Event
deathMatch:
    enabled: true
    command: dm
    type: deathMatch
    victoryCondition: highestKills
    database: dm
    prefix: "&8[DeathMatch]&e"
    preReqs:
        options: [clearInventory]
    onJoin:
        options: [teleportIn, woolTeams]
    onOpen:
        options: [pvpOff]
    onStart:
        options: [pvpOn]
    onComplete:
        options: [teleportOut, clearInventory, deEnchant, undisguise]
    onSpawn:
        options: [enchants, giveItems, health=20, hunger=20, deEnchant]
        items: # ignored if options doesnt have "giveItems"
            - iron_sword: 1
            - bow: 1
            - tnt: 3
            - arrow: 32
            - leather_helm: 1
            - leather_chest: 1
            - leather_leggings: 1
            - leather_boot: 1
            - bread: 5
        enchants:
            - speed:1
    onDeath:
        options: [respawn,clearInventory]
    winner:
        options: [enchants, money=1,experience=300, health=20, hunger=20]
        enchants:
            - speed:2:900
            - resistance:2:900
    1. Tournament Event
tourney:
    name: Punch Drunk
    type: Versus
    database: tourney
    prefix: "&5[Tourney]&e"
    timeBetweenRounds: 3
    preReqs:
        options: [clearInventory]
    onStart:
        options: [teleportIn, pvpOn, woolTeams]
    onComplete:
        options: [teleportOut, clearInventory]
    onSpawn:
        options: [deEnchant, giveItems, hunger=20, health=20]
        items:
            - iron_sword: 1
            - bow: 1
            - arrow: 16
            - iron_helm: 1
            - iron_chest: 1
            - iron_leggings: 1
            - iron_boots: 1
            - 373;8197: 2
            - bread: 3
    winner:
        options: [clearInventory, experience=100, health=20, hunger=20]
    firstPlace:
        options: [enchants,experience=1000]
        enchants:
            - speed:2:900
            - resistance:2:900
            - haste:1:900
            - regen:1:900

Return to Index

BattleArena

Main Page