Speedrun Timer

Speedrun Timer adds in-game timing overlays and LiveSplit-style biome splits for Hades II runs.

Part of the Speedrun modpack.

What It Does

Speedrun Timer shows selected timing information on screen while you play. Its main feature is a split table that tracks your route through a run like a compact in-game LiveSplit layout.

The split table supports:

• Underworld routes: Erebus, Oceanus, Fields, and Tartarus.
• Surface routes: Ephyra, Thessaly, Olympus, and The Summit.
• Dream Dive routes, where the biome order is detected from the run.
• Single-run splits for a normal attempt.
• Multi-run batch recording for routing or practice sessions across several consecutive runs.

The timer can show these timing columns:

• IGT: in-game run time from the game's run timer.
• RTA: real elapsed time.
• LrT: load-removed time, with map-load time subtracted.

Current Options

• Choose which timer columns are visible.
• Show or hide the compact live timer rows.
• Show or hide the LiveSplit-style biome split table.
• Use single-run split mode or multi-run batch recording.
• Record a batch of 1 to 10 runs and keep cumulative batch totals.

Gameplay Impact

This module only displays timing information. It does not change rooms, rewards, enemies, boons, or run generation.

Installation

Install via r2modman.

This module is usually installed as part of the full Speedrun modpack, where it appears in the shared Speedrun UI.

Changelog

Unreleased

1.1.2 - 2026-05-06

Changed

• Split recording now uses explicit Start/Clear/Stop controls for both single-run and multi-run modes.
• Single-run timer results now persist after the victory screen until the next run or recording reset.

1.1.1 - 2026-05-05

Changed

• Quick tab minor bug fix
• Single run timer now persists after victory screen

1.1.0 - 2026-05-05

Changed

• Moved game hooks to the ModpackLib hook contract for reload-safe registration.
• Hardened GitHub Actions so Lua validation runs before releases.
• Moved timer HUD rendering onto ModpackLib managed overlays.
• Reworked the module UI around selectable timer columns, live timer rows, split table visibility, split mode, and batch recording controls.
• Updated the packaged README to describe the current player-facing timer and split features.

Added

• Added IGT, RTA, and LrT column selection for live timer rows and split tables.
• Added biome split tables for Underworld, Surface, and Dream Dive routes.
• Added multi-run batch recording with cumulative IGT/RTA/LrT totals.
• Added Quick Setup content with a simple module enable toggle.
• Added runtime persistence for batch recording intent across reloads.
• Added tests for timer formatting, route rows, batch recording, and UI fallback behavior.

1.0.0 - 2026-04-21

Initial release