HYRUN Parkour Timer

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, &hellip;

/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.