Bukkit

Parkour Configuration

Parkour Configuration File Example

start: world:145:1:299
finish: world:151:1:330
players: {}
rewardmoney: 100
reward:
- ==: org.bukkit.inventory.ItemStack
  type: WOOL
  damage: 4
  amount: 3
- ==: org.bukkit.inventory.ItemStack
  type: STONE
dispenser:
- ARROW:10:world:127:3:312:EAST
checkpoints:
  '0':
    location: world:136:1:309
    dispenser: []
  '1':
    location: world:135:1:325
    dispenser:
    - LARGEFIREBALL:20:world:127:3:313:EAST

Creating a simple parkour

While a player is inside of a parkour, he cannot leave until using the command /horse parkour leave. If the player or the horse takes any damage, he will immediately be teleported back to the start or the last checkpoint, that he reached. You can also make your parkour more difficult by adding some wool blocks to it. If a player gets too close to a wool block, he will also be teleported back.

1. Creation and defining start position: Go to the position, that should be the start of your parkour and type /horse parkour create <parkourName>. You can also manually edit the starting position with the command /horse parkour setstart <parkourName>
2. Defining finish position: Define the finish by going to its position and type /horse parkour setfinish <parkourName>. You can now already start the parkour with the command /horse parkour <parkourName>
3. Adding rewards:
   1. You can simply add an item reward. Just hold the item stack that you want to add as a reward in your hand and type /horse parkour addreward <parkourName>. The amount of the item stack will also be saved as well as enchantments and lore
   2. If you want to delete a reward, you can do so by editing the parkour configuration file and reloading the plugin with /horse reload or you have to delete all item rewards by typing /horse parkour clearreward <parkourName>
   3. If you have Vault and a compatible Economy Plugin installed, you can add a money reward by using the command /horse parkour rewardmoney <parkourName> <amount>

Creating an advanced parkour

You can add auto shooting dispensers to your parkour as well as adding checkpoints to make your parkour even more fun.

1. Adding dispensers: You can add auto shooting dispensers to a parkour, but you have to define a few things like the period and the type that should be shot. The full command is /horse parkour dispenser <parkourName> <projectileType> <delay>
   1. Available projectile types: arrow, snowball, largefireball (it is a ghast fireball)
   2. A period of 1 equals 200ms (0.2s), that means 5 equals 1 second, 7 equals 1.4 seconds ...
   3. After you typed in the command, you will be prompted to leftclick the dispenser that you want to add. The facing direction will be saved
   4. To remove a dispenser from a parkour, just destroy it
2. Adding checkpoints: A checkpoint has a unique id, that also represents its priority. To add a checkpoint, use the command /horse parkour addcheckpoint <parkourName> <checkpointID>
   1. You can only use ids greater than -1, because -1 is internally used as the id for the starting point. If a player reaches a checkpoint, that has an id greater than the id of the previous checkpoint that he reached, he will be assigned to this checkpoint
   2. Dispensers that are assigned to a checkpoint are only enabled, if any player is in between the current and the next checkpoint section of the parkour. Dispensers that are not assigned to any checkpoint are instead assigned to the starting checkpoint, meaning that they are disabled, if all players inside of the parkour reached at least the first checkpoint. To edit the dispensers of a checkpoint, you have to define which checkpoint you want to edit by using the command /horse parkour editcheckpoint <parkourName> <checkpointId>

In the example

dispenser:
- ARROW:10:world:127:3:312:EAST

is enabled as long as there is any player inside of the parkour, that did not yet reach checkpoint '0'. Since there are no dispensers assigned to checkpoint '0', no additional dispensers will be enabled, but when any player reaches checkpoint '1', the dispenser

dispenser:
- LARGEFIREBALL:20:world:127:3:313:EAST

will be enabled.