◦•●❤♡ ᴄᴏɴᴛᴀᴄᴛ Dekomori on discord ꜰᴏʀ ꜱᴜᴘᴘᴏʀᴛ ♡❤●•◦
Tested Minecraft Versions: 1.8 / 1.9 / 1.10 / 1.11 / 1.12
SpeedRun is a race with parkour.
Bugs
I can't fix problems if I don't find them! If you have any issues, report via discussion or private message. Do not use the rating area to report bugs or request features. Please go to discussion.
Dependencies
To work with Leaderboards you can add Holographic Displays.
NBS Music
You can play custom Note Block Studio songs! You need NoteBlockAPI for this.
Arena setup
Required permission: sr.admin
First of all set global spawn using /sr setgspawn
Step by step tutorial
Sign format:
Leaderboards
You need HolographicDisplays to work with Leaderboards, just use the placeholder:
Time Leaderboard/Map Records
Players can set their own record on each map.
Extra Information about Map Records:
For now some users have tested and everything is in place and no changes are needed.
Extra permissions
MCJukebox:
Showcase & Setup
API
Tested Minecraft Versions: 1.8 / 1.9 / 1.10 / 1.11 / 1.12
SpeedRun is a race with parkour.
![[IMG] [IMG]](/proxy.php?image=https%3A%2F%2Fi.imgur.com%2FOrqU9nr.png&hash=2cf808d7eeb037a12c3adaac36e6f91f)
- Multi-Arena or bungee support.
- Achievements.
- Win fireworks & effects.
- Checkpoint effects.
- MySQL, Flatfile or SQLite support.
- Most game messages are configurable.
- Custom and configurable signs.
- Save and restore player inventory, levels and more.
- API with Game events.
- Visibility system.
- NoteBlockAPI for .NBS Game sounds! Play with custom different musics per map!
- 1 Winner, 3 positions, 2 and 3 positions will receive half of win coins.
- Win & checkpoints rewards.
- MCJukebox support! Play a real music with MCJukebox.
- Leaderboards and Map Records!
- Custom pads.
![[IMG] [IMG]](/proxy.php?image=https%3A%2F%2Fi.imgur.com%2FtZsJMgY.jpg&hash=a7497dbb9a9b6f415d4a701fbfc11dc2)
Bugs
I can't fix problems if I don't find them! If you have any issues, report via discussion or private message. Do not use the rating area to report bugs or request features. Please go to discussion.
Dependencies
To work with Leaderboards you can add Holographic Displays.
NBS Music
You can play custom Note Block Studio songs! You need NoteBlockAPI for this.
![[IMG] [IMG]](/proxy.php?image=https%3A%2F%2Fi.imgur.com%2FShe6p1t.png&hash=7d6be3af20f5f19b7191d8cf229e49f6)
Arena setup
Required permission: sr.admin
First of all set global spawn using /sr setgspawn
Step by step tutorial
- Create your arena - /sr create <name>.
- Set arena waiting lobby - /sr setlobby <name>
- Add spawn - /sr setspawn <name>
- Set min players - /sr setMinPlayers <name> <amount>
- Set max players - /sr setMaxPlayers <name> <amount>
- Select the checkpoint area with WorldEdit - /sr addCheckpoint <name>
- Put the block on your hand - /sr addblock <name>
- Finish the arena with - /sr finish <name>
Sign format:
- [SpeedRun]
- join
- ArenaName
![[IMG] [IMG]](/proxy.php?image=https%3A%2F%2Fi.imgur.com%2FPOU7614.png&hash=31bc9d60a54f9ec871a95f140836be70)
Leaderboards
You need HolographicDisplays to work with Leaderboards, just use the placeholder:
- {sr_wins_number}
- Example: {sr_wins_1} will return player with most wins.
- {sr_wins_2} etc
- The message can be modified at
Leaderboard.Messages.Wins-Format Use the placeholders %player% for the player %wins% for the win amount and %position% for the position.
- {sr_checkponts_number}
- Example: {sr_checkponts_1} will return player with most checkpoints
- {sr_checkponts_2} etc
- The message can be modified at
Leaderboard.Messages.Checkpoints-Format Use the placeholders %player% for the player %checkpoints% for the checkpoint amount and %position% for the position.
- {sr_records_map_position}
- {sr_records_sr1_1} will return the player with the best time on the map sr1.
- {sr_records_sr1_2} etc
- The message can be modified at
Leaderboard.Messages.Map-Record-Format. Use the placeholders %time% for time in milliseconds,
%formatted_time% for mm:ss, %map% for the Map name and %position% for the position.
![[IMG] [IMG]](/proxy.php?image=https%3A%2F%2Fi.imgur.com%2FvT0ijLL.png&hash=c04b9700ec2ba489b29a8ab16f9d94e0)
Time Leaderboard/Map Records
Players can set their own record on each map.
![[IMG] [IMG]](/proxy.php?image=https%3A%2F%2Fi.imgur.com%2F1Byzqoa.png&hash=b367f9fe9bff75e7946b457bdce12c3b)
![[IMG] [IMG]](/proxy.php?image=https%3A%2F%2Fi.imgur.com%2F3zO2TVI.png&hash=90b8d9c993e5aea86c43f22b48f5806c)
Extra Information about Map Records:
- It only works with SQLite or MySQL.
- Can be disabled if you don't want to use.
- Will create a new database table.
- Will update and load before (reload) every game.
- This process should not have any impacts on performance.
For now some users have tested and everything is in place and no changes are needed.
- /sr join <arena> - sr.player
- /sr leave - no permission.
- /sr stats - sr.player
- /sr setgspawn - sr.admin
- /sr start <arena> - sr.moderator/sr.admin
- /sr stop <arena> - sr.moderator/sr.admin
- /sr config set/update <path> <value> - sr.commands.config/sr.admin
- /sr coins set/add/remve <player> <amount> - sr.command.coins/sr.admin
- /sr updatedata <player> - sr.command.update/sr.admin
- /sr leaderboard update - sr.admin
- /sr create <name> - Create a new arena.
- /sr setlobby <name> - Set arena waiting lobby.
- /sr setspawn <name> - Set the arena spawn (like a first checkpoint, where players will be teleported when game starts and if they failed and haven't a checkpoint yet.)
- /sr setMinPlayers <name> <amount> - Min of players to start the game.
- /sr setMaxPlayers <name> <amount> - Max of players.
- /sr cptool - Area Selecting Tool.
- /sr addcheckpoint <name> - Add a game checkpoint, players may not win the game without going through this checkpoint!
- /sr addblock <name> - Add a block (Item in your main hand) that the player can step, if someone step in a block that isn't on this list he will be teleported to the his last checkpoint.
- /sr finish <name> - Reloads the arena and finish the setup. Note: This command can be used everytime.
- /sr setgspawn - Set the global spawn where players will be teleported when game ends.
- /sr leaderboard - Update the Leaderboards and player data.
- /sr start <arena> - Start a game.
- /sr stop <arena> - Stop a game.
- /sr config - Update settings.yml.
- /sr coins - Edit the balance of a player.
- /sr join <name> - Join in a game.
- /sr quit - Left the game.
- /sr stats - See your stats.
![[IMG] [IMG]](/proxy.php?image=https%3A%2F%2Fi.imgur.com%2Fw7gBd5k.jpg&hash=da6f1446f1f48285bb9877c6568d6396)
Extra permissions
- sr.joinfull - Allows you to join in full games.
MCJukebox:
- You can install MCJukebox to play musics.
![[IMG] [IMG]](/proxy.php?image=https%3A%2F%2Fi.imgur.com%2FLR6jLu2.png&hash=a18415e5c0a45848d3eefd3646d853e9)
![[IMG] [IMG]](/proxy.php?image=https%3A%2F%2Fi.imgur.com%2FUWE1PfY.png&hash=38c0bb324ac7204b8c638266932b5dc3)
Showcase & Setup
API
Code:
*/
public GamePlayer getPlayerData(UUID uuid);
/**
* Get player data from UUID.
*
* @param uuid - The UUID.
* @return GamePlayer - The player data.
*
*/
public GamePlayer getPlayerData(String name);
/**
* Get player a game from name.
*
* @param name - The map name.
* @return Game - The game.
*
*/
public Game getGame(String name);
/**
* Get player a game from a player.
*
* @param GamePlayer - The game player.
* @return Game - The game.
*
*/
public Game getGame(GamePlayer fromPlayer);
/**
* Send a updated data to Database (MySQL, SQLite or YAML)
*
* @param players - Players to save
*
*/
public void saveData(Player... players);
/**
* Get the music from the game.
*
* @return Music - the GameMusic class
*
*/
public Music getGameMusic(Game fromGame);
/**
* Send a plugin message to a channel via BungeeCord's channel and SpeedRun's subchannels.
*
* @param player - The player sending the message -- Player must be online.
* @param server - The target server.
* @param key - Your key to listen the message.
*
*/
public boolean forwardData(Player player, String server, String key);
/**
* Get the wins leaderboard;
*
* @return The list of avaliable data.
*/
public List<Entry<String, Integer>> getWinsLeaderboard();
/**
* Get checkpoints leaderboard;
*
* @return The list of avaliable data.
*/
public List<Entry<String, Integer>> getCheckpointsLeaderboard();
/**
* Get offline player data.
*
* @param name - The player name
* @return Offline player data
*/
public OfflineGamePlayer getOfflineGamePlayer(String name);
@EventHandler
public void onGameStart(GameStartEvent event) {
event.getGame().sendGameMessage("Game started!");
}