DeathRun is a plugin for well known minigame from the HiveMC Network server where players are divided into two teams, runners and deaths. As a runner, you have to run through the entire map, avoiding traps that is triggered by players with the death role will use against you.
This plugin works on 1.16+
servers with Paper
or Spigot
server software, Java 17
and WorldEdit (v7.2.9+)
plugin.
If you need support contact us on our Discord server or visit our Documentation page. If you want to contribute this repository please read CONTRIBUTING file.
Plugin configuration files using YAML format. Configuration files is described bellow.
File: config.yml
#
# ------------------------------------------------------------------------
# INFORMATION
# ------------------------------------------------------------------------
#
# This is configuration file for DeathRun plugin, if you found any issue
# contact with us through Discord or create issue on GitHub. If you need
# help with configuration visit https://mrstudios.pl/documentation.
#
# ------------------------------------------------------------------------
# GENERAL
# ------------------------------------------------------------------------
# Lobby Server Name
server: dr-lobby-1
# Minimum amount of players that is needed to game start.
arena-min-players: 5
# Amount of players with 'DEATH' role on arena.
arena-deaths-amount: 1
# Amount of time that runners have to complete run. (in seconds)
arena-game-time: 600
# Amount of time that is needed to game start.
arena-pre-starting-time: 30
# Amount of time before start barrier will be removed.
arena-starting-time: 10
# Amount of time before players on server will be moved to lobby.
arena-end-delay: 10
# Amount of time before trap can be used again.
arena-trap-delay: 20
# Max ,,survivable`` distance that player can fall.
arena-max-fall-distance: 8
# Speed Amplifier for Death role.
arena-death-speed-amplifier: 10
# ------------------------------------------------------------------------
# EFFECTS
# ------------------------------------------------------------------------
block-effects:
- block: EMERALD_BLOCK
effect: JUMP
amplifier: 7
duration: 1.5
- block: REDSTONE_BLOCK
effect: SPEED
amplifier: 5
duration: 1.5
# ------------------------------------------------------------------------
# BOOSTERS
# ------------------------------------------------------------------------
boosters:
- slot: 0
power: 2.5
delay: 10
item:
name: <green>Booster <gray>(Right Click)
material: FEATHER
delayItem:
name: <red>Booster <gray>(<delay> seconds)
material: FEATHER
direction: FORWARD
sound: ENTITY_BLAZE_AMBIENT
# ------------------------------------------------------------------------
# SOUNDS
# ------------------------------------------------------------------------
arena-sound-pre-starting: BLOCK_NOTE_BLOCK_PLING
arena-sound-starting: ENTITY_EXPERIENCE_ORB_PICKUP
arena-sound-started: ENTITY_ENDER_DRAGON_GROWL
arena-sound-checkpoint-reached: ENTITY_EXPERIENCE_ORB_PICKUP
arena-sound-trap-delay: ENTITY_VILLAGER_NO
arena-sound-player-death: ENTITY_SKELETON_DEATH
File: language.yml
#
# ------------------------------------------------------------------------
# INFORMATION
# ------------------------------------------------------------------------
#
# This is configuration file for DeathRun plugin, if you found any issue
# contact with us through Discord or create issue on GitHub. If you need
# help with configuration visit https://mrstudios.pl/documentation.
#
# ------------------------------------------------------------------------
# GENERAL
# ------------------------------------------------------------------------
chat-message-no-permissions: <red>You don't have permissions to this command.
chat-message-invalid-command-usage: <red>Invalid command usage, correct usage is <dark_red><usage><red>.
chat-message-arena-player-joined: <gray><player> <yellow>has joined. <aqua>(<currentPlayers>/<maxPlayers>)
chat-message-arena-player-left: <gray><player> <yellow>has quit.
chat-message-arena-starting-timer: <yellow>Game starts in <gold><timer> seconds<yellow>.
chat-message-arena-player-finished: <reset> <white><b>FINISH ></b> <gray>Player <gold><player>
<gray>has finished game in <white><seconds> seconds<gray>. <dark_gray>(#<finishPosition>)
chat-message-arena-game-start-runner:
- <reset>
- <reset> <gold><b>*</b> <gray>You are <green>Runner<gray>.
- <reset> <white><b>*</b> <gray>Your task is complete run in shortest possible time,
during this task interfering player will trigger various traps.
- <reset>
chat-message-arena-game-start-death:
- <reset>
- <reset> <gold><b>*</b> <gray>You are <red>Death<gray>.
- <reset> <white><b>*</b> <gray>Your task is to disturb runners by launching traps.
- <reset>
chat-message-game-end-spectator:
- <reset>
- <reset> <gold><b>*</b> <gray>You are <dark_gray>Spectator<gray>.
- <reset> <white><b>*</b> <gray>Now you can follow other players.
- <reset>
# ------------------------------------------------------------------------
# TITLES
# ------------------------------------------------------------------------
arena-pre-starting-title: <red><timer>
arena-pre-starting-subtitle: <reset>
arena-starting-title: <red><timer>
arena-starting-subtitle: <reset>
arena-death-title: <red>YOU DIED!
arena-death-subtitle: <yellow>Don't give up! Try again!
arena-checkpoint-title: <yellow>CHECKPOINT!
arena-checkpoint-subtitle: <gold>You reached <yellow>#<checkpoint> checkpoint<gold>.
arena-finish-title: <dark_aqua><b>FINISH
arena-finish-subtitle: <gray>Your position is <white>#<position><gray>.
arena-game-end-title: <red><b>GAME END!
arena-game-end-subtitle: <reset>
arena-move-server-title: <aqua>Waiting..
arena-move-server-subtitle: <gray>You will be transferred to lobby in <white><endTimer>
seconds<gray>.
# ------------------------------------------------------------------------
# SCOREBOARD
# ------------------------------------------------------------------------
arena-scoreboard-title: <yellow><b>DEATH RUN
arena-scoreboard-lines-waiting:
- <reset>
- '<white>Map: <green><map>'
- '<white>Players: <green><currentPlayers>/<maxPlayers>'
- <reset>
- <white>Waiting..
- <reset>
- <yellow>www.mrstudios.pl
arena-scoreboard-lines-starting:
- <reset>
- '<white>Map: <green><map>'
- '<white>Players: <green><currentPlayers>/<maxPlayers>'
- <reset>
- <white>Start in <green><timer> seconds
- <reset>
- <yellow>www.mrstudios.pl
arena-scoreboard-lines-playing:
- <reset>
- '<white>Time: <green><timeFormatted>'
- '<white>Role: <green><role>'
- <reset>
- '<white>Runners: <green><runners>'
- '<white>Deaths: <red><deaths>'
- <reset>
- '<white>Map: <green><map>'
- <reset>
- <yellow>www.mrstudios.pl
# ------------------------------------------------------------------------
# HOLOGRAMS
# ------------------------------------------------------------------------
arena-hologram-trap-delayed: <red><delay> seconds
# ------------------------------------------------------------------------
# ROLES
# ------------------------------------------------------------------------
arena-roles-runner-name: <green>Runner
arena-roles-death-name: <red>Death
arena-roles-spectator-name: <gray>Spectator
# ------------------------------------------------------------------------
# ITEMS
# ------------------------------------------------------------------------
arena-item-leave-name: <red>Leave <gray>(Right Click)
If you want to sponsor this project you can do it by clicking Sponsor
button. You can also support us by clicking on the star button on the top of this page.
Libraries that is used in this project, most of them are open source libraries.
- LiteCommands by Rollczi
- ProtocolSidebar by CatCoderr
- Kyori Adventure by Kyori
- Java Annotations by JetBrains
- okaeri-configs by Okaeri
- commons-io by Apache Software Foundation
- java-commons by MrStudios Industries
- Zip4J by Lingala