BlockRunner
BlockRunner
What is it?
BlockRunner is a mix between parkour and a puzzle game, where the goal is to reach the end of the level by jumping around and using the block(s) given to you. These blocks allow for a whole new dimension to parkour, since the block only stays for a specific amount of time. You have to parkour, puzzle, think and react quickly to get to the end of the level, without falling!
How does it work?
Players join the game by using the join command (more at: "Commands"). Players have to use the blocks given to them to reach the end of the level. If a player hits water, he/she will be teleported back to the spawn of the level they are currently in. If the player falls into the void without hitting water, he/she will advance to the next level, or win the game if there are no more levels. The spawn of each level is set by an operator beforehand. This spawn point will be saved in a config file. Each level has a unique id, linking to the spawn point and the gamemode of that level. Custom gamemodes can be created which allow for different amounts of blocks given, and different timings of block disappearance and givebacks. This allows each level to possibly require a different method of approach.
How to progress in a level
Diamond Block | Player progresses to next level |
Player in Void | Player progresses to next level |
Gold Block | Checkpoint |
Water | Player retries at start of the level or at a checkpoint |
Lava | Player restarts from level 1 |
A possible level design (v0.5Beta):
Features
- Customisable:
- Blocks
- Levels
- Block remove and retreval times
- Prizes
- Music
- Gamemodes
- Easy to setup, out of the box operation
- A lot of operator commands, for high-level customisation
- Frequent updates, bugfixes and new features (suggested by YOU! =D)
- Support from the dev, in any way possible
Commands
(<> = optional, [] = required)
Command | Description | Permission |
---|---|---|
/blockrunner help <page> | Display the help page | blockrunner.help |
/blockrunner join | Join the game | blockrunner.join |
/blockrunner leave | Leave the game | blockrunner.leave |
/blockrunner music | Toggle music play | blockrunner.music |
/blockrunner setworld | Sets the current world to the world where the levels are located | blockrunner.admin.setworld |
/blockrunner setspawn <id> <gamemode> | Sets the spawn to a level, where id is the unique level id | blockrunner.admin.setspawn |
/blockrunner setprize [level-id] <amount> <item-id> <data-value> | Add a prize for players to receive on completing a level | blockrunner.admin.setprize |
/blockrunner gamemode list | Lists the availible gamemodes | blockrunner.admin.gamemode.list |
/blockrunner gamemode modify [gamemode] [data] [value] | Modifies the given setting of the specified gamemode to the value given | blockrunner.admin.gamemode.modify |
/blockrunner reload | Reloads the config | blockrunner.admin.reload |
/blockrunner reload all | Reloads the complete plugin | blockrunner.admin.reload |
Configuration file
Mostly this file doesn't need any modifications, since pretty much everything can be modified in-game and it works out-of-the-box. However, for those of you who do want to mod the config file, I'll explain the main features.
block: 35 world: levels: gamemodes: default: amount: 1 time: 20 return: 20
Block defines the block the player is given to play the game with. These can only be placeable blocks, and they cannot feature a data value. World defines the worldname where all the levels are located. Levels defines the storage of level spawns created in-game. Once a level has been created, it will feature the unique level ID, spawn location and gamemode. Gamemode defines all the availible gamemodes and their settings. In this case, default is the name, and the settings underneath that are gamemode specific settings. Amount equals the amount of blocks given to the player, Time equals the time the block stays in the world before disappearing, and Return equals the time for the block to return back into the inventory of a player. Time and Return are specified as ticks, where 20 ticks = 1 second. Time and Return are related to the block place, meaning that in this case, the block disappears after 1 second and is given back after 1 second when the block was placed.
Future features
- Option to show debug info in config
- Song playlist/multiple song looping
- Deny command usage when in-game, except for whitelisted commands
Save function(added in 0.9 Beta)- Gui related something
Customisable prizes(added in 0.8 Beta)- More gamemode settings
- Ability to create gamemode in-game
Leave game when switching worlds(added in 0.7.1Beta)Checkpoints(added in 0.6Beta)More methods of finishing a game(added in 0.6Beta)
Known bugs
- 0.9 Beta
- #3: Possible loophole where players are able to get back into the level after quiting the blockrunner game when using essentials' /back
- 0.8 Beta
#2: '/br reload all' buggy when players are in game, some of these players will parially leave the blockrunner game, others might not. If the error is thrown, the plugin stops reloading, but is still usable.
- 0.7.1B
#1: When a player falls in lava, and a checkpoint is set, the player level will be set to 1, but the player will respawn at the checkpoint. Once a player finishes the level it will teleport to level 2.
Changelog
(+: Addition, =: Bugfix, -: Removal)
- v0.9 Beta:
- +: Continue in the level you were when you left the game.
- =: Level data would not always be displayed.
- =: Bug #2
- v0.8 Beta:
- +: Customisable prizes per level
- +: Config and Plugin reloading
- =: Creating a level spawn without id being a number too low
- =: Bug #1
- v0.7.1Beta:
- +: Player now leaves the game when switching worlds
- +: Player now starts at level 1 again when touching lava
- v0.7Beta:
- +/=: Updated code to 1.6.2 with bukkit's changed health system
- =: Possible memory leak issues
- v0.6Beta:
- Added checkpoints: Stand on a gold block, and it will set your checkpoint
- Added new Level progresser: Stand on a diamond block to progress to the next level
- Removed unnecessary code
- BlockRunner v0.5Beta:
- First release
Donate
If you like this plugin and if you want to aid me with creating other plugins, please consider a donation. It would really help with creating future plugins =).
I made a midi: http://tgc4.webs.com/downloads
Its currently in use in my blockrunner arena. plz listen to it when u get the change :) the song is in beta im going to edit the notes and speed ect to make it sound perfect.
Tough im adding diffrent songs soon that are more parkouishlike. Id love to make alot of songs as a database for you if you like.
Id love to make alot of music then and setup a fanbase download midi files for this plugin :D
@CoolKill3r
I'll make a tutorial soon on how to create your own music for the game =)
Thanks alot kevvy :D Also i love the music added. cant wait for more touhou music :p Maybe?: http://www.youtube.com/watch?v=RFA6lH0E5I4 :D if the midi excists ofc.
@CoolKill3r
The song is Bad Apple from Touhou, and I will add that in the next version =)
Any way to make it so people cant use commands too in the parkour? with a whitelist of commands?
Thanks kevo.
Also i know the song, WHER is it from D:
@CoolKill3r
It doesn't use a lot of RAM and should be running fine on any server. Plus, more or less players in game don't change the amount of RAM required that much.
How much ram does this use? or is it like ram abbusive or almost no use?
@Pixiyo
Sure, I can add that. I also want to apologise for the lack of updates lately, but I've been busy with a lot of other things and I didn't find any time to code. I'll try to post a new update soon =)
Any updates? Can you please make a save function? We have 5 levels and people get crazy that they have to repeat every level if they log-out.
@xiProMan
Thanks for the heads up, I'll make a video asap!
i hate plugins with out videos :(
@AoH_Ruthless
Hi there, thanks for the request! This feature will be added in the next version of the plugin =)
Hi, you should add a feature where we can config prizes to give out to those who successfully complete a level. Other than that, this plugin is fantastic! I hope you keep up the good work!
@foreverblu
I'll see if I can compile it in Java 6, but as far as I've tested, there are no problems at all. Make sure you download the correct version for your Craftbukkit version.
@Pixiyo
I will add this in the next version. Thanks for the heads up!
We have survivalgames and this on the same server. When you join the survivalgames queue and then blockrunner a bug happens. Because survivalgames has a queue it will take a while before you can play. The player joins the SG queue and then blockrunner he will teleport when the survivalgame starts. Then when a player goes into the water he will be teleported back to the blockrunner parcour.
Please make it so you will automaticly leave blockrunner when you join another world.
Thank you
Can you compile this in Java 6? Unless this is already. Cuz i have this error on JavaPLugin Loader problem with latest craftbukkit build. The Postal plugin had the same error and the author said something about incompatibility on java 6 and 7. so He recompiled the mod in Java6 so it works fine...
Very nice, thanks for the great plugin.