HYRUN Parkour Timer

Short description

A time-trial / speedrun timer plugin for Hytale.

Create parkour/race levels with START, END, RESET, and CHECKPOINT zones, show an in-game timer HUD, and store times in a database with an in-game leaderboard. Players can browse levels through a menu UI and quickly reset/restart runs.

You can use this mod to time your single player parkours or use it to create maps for the hyrun.net server.

Join the hyrun discord: https://discord.gg/DVrJa4hNpJ

Commands

Always available to players (no special permissions)

/menu

• Opens the Time Trials level menu UI.

/timer reset

• Resets you during an active run.
• If the level’s reset mode is checkpoint, it sends you to your last checkpoint (or spawn if you haven’t reached one).
• If the reset mode is start/spawn, it sends you to the level spawn.

/timer restart

• Restarts the current run from the beginning.
• Clears checkpoint progress and resets your timer to 0:00.

Player-facing commands (may require permissions)

Depending on your server’s permission setup, you may need to explicitly grant these to regular players.

/timer play <level>

• Teleports you to the level spawn (or the START-zone center if no explicit spawn is set).
• If the level is in a different world, the plugin transfers you there.

/timer leaderboard <level>

• Shows the top 10 recorded times for the given level.

/timer info <level>

• Shows level info (world, start/end zone status, reset mode, checkpoint count, and best time).

Builder / admin commands (permission-gated by default)

Use /op self in your single player world to get these.

Level management

/timer create <level>

• Creates a new level for the current world.

/timer delete <level>

• Deletes the level and its stored data.

/timer list

• Lists all levels and whether START/END zones are set.

/timer setspawn <level>

• Saves your current position/rotation as the level spawn point.

/timer setcreator <level> <creator|none>

• Sets the displayed creator name for a level (use none to clear).

Zone setup

/timer zone <level> <start|end|reset|checkpoint>

• Starts a zone selection for the chosen type.
• After running this, select the two corners of the cuboid:
  • /timer pos1 (first corner)
  • /timer pos2 (second corner + saves the zone)

/timer pos1

• Sets the first corner of the current zone selection.

/timer pos2

• Sets the second corner and saves the zone to the database.

/timer cancel

• Cancels the current zone selection.

/timer zones <level>

• Lists all zones for the level.
• RESET and CHECKPOINT zones are shown as reset1, reset2, checkpoint1, …

/timer zonedelete <level> <start|end|resetN|checkpointN>

• Deletes a zone.
• Use indexed names for multi-zones, e.g. reset1 or checkpoint2.

Reset behavior

/timer resetmode <level> <checkpoint|start>

• Controls where a RESET action sends the player:
  • checkpoint: last checkpoint (fallback: spawn)
  • start: level spawn / start

Tags (level metadata)

/timer tag <name>

• Creates a new tag (max 32 characters).

/timer tagdelete <name>

• Deletes a tag.

/timer leveltag <level> <tag>

• Assigns a tag to a level.

/timer leveluntag <level> <tag>

• Removes a tag from a level.

Modes (loadout / rules)

/timer mode <level> <add|remove> <hand|dagger|sword|stamina>

• Adds or removes a mode for an entire level.
• stamina means Infinite Stamina.

/timer cpmode <level> <cp#> <add|remove> <hand|dagger|sword|stamina>

• Adds or removes a mode for a specific checkpoint.

/timer modes <level>

• Displays all configured modes for the level and per-checkpoint.

Debug / manual timer controls

/timer debug

• Toggles debug mode so you can inspect zones without triggering their actions.

/timer start [level]

• Manually starts the timer HUD (primarily for testing).

/timer end

• Manually stops the timer HUD.