AlienX's Rupture Timer

RuptureTimer — Rupture Wave Overlay for StarRupture

Adds a stylish, configurable in-game overlay that shows what the Rupture Wave is doing right now, how long until it changes, and what comes next.

Multiplayer-aware — the server reads the wave state and synchronises it to connected clients.

What It Does

RuptureTimer provides an at-a-glance view of the current Rupture Wave state without having to rely solely on the vanilla HUD.

The overlay shows:

• []Current state — Pre-Wave, Moving, Fadeout, Growback or Calm[/]

  []Active substage — Fire Wave, Burning, Regrowth and other substages[/]

  []Time until the next state — countdown with a progress ring[/]

  []Stage timeline — see where you currently are in the wave cycle[/]

  []Next state — see what the wave will transition into[/]

  []Multiplayer status — shows the current network role and data freshness

  When the plugin does not have the required data, it does not guess. Unknown countdowns are displayed as --:-- along with the reason.

  ---

  Multiplayer & Server Support

  RuptureTimer uses the side of the game that has authority over the wave state and sends a compact snapshot to clients through the ModLoader plugin network channel.

  • []Solo / Offline — the client reads the wave locally and does not use networking[/]

    []Listen Server / Host — the host reads the wave and broadcasts it to connected clients[/]

    []Joined Server — the client displays the wave state received from the server[/]

    []Dedicated Server — the server reads and broadcasts the wave state; no UI is displayed

    Important: A client connected to a server without the server DLL installed will remain in its waiting state. This is intentional.

    ---

    Client & Server Installation

    • []For players and listen-server hosts, install RuptureTimer-Client[/]

      []For dedicated servers, install RuptureTimer-Server[/]

      []Place the DLL in the game's Plugins directory which is in the ModLoader directory next to dwmapi.dll.

      The release ZIPs already contain a correctly named Plugins\RuptureTimer.dll together with the sidecar required for automatic updates, so installing from the release ZIP is recommended.

      On first launch, AxRuptureTimer.ini will be generated in:

      <game_dir>\StarRupture\Binaries\Win64\ModLoader\Plugins\config

      Important: The client and server DLLs must be from the same release. The network wire format is versioned, and mismatched versions will be rejected rather than decoded incorrectly.

      ---

      Configuration

      Configuration can be edited through:

      Plugins\config\AxRuptureTimer.ini

      Alternatively, use the ModLoader configuration tab. Changes are applied live and do not require a restart.

      []Enabled — master enable/disable switch

      []ShowOverlay — show or hide the on-screen overlay

      []ToggleKey — key used to show/hide the overlay (default: F7)

      []ShowStageTimeline — show the Pre-Wave → Calm stage timeline

      []ShowProgressRing — show the countdown progress ring

      []ShowNextState — show the NEXT state line

      []ShowSubstage — show the active substage

      []ShowWavePosition — show the wave's map position while moving

      []ShowNetworkStatus — show the network role and data freshness

      []ShowTimeSinceWave — show how long the current wave has been running

      []CompactMode — display countdown only

      []LockWindow — prevent the overlay from being dragged

      []AccentByWaveType — change the accent based on Heat/Cold wave type

      []Scale — overlay size multiplier (default: 1. 0, range: 0. 6–2. 0)

      []Opacity — overlay background opacity (default: 0. 88, range: 0. 15–1. 0)

      []AccentPreset — 0 Signal, 1 Amber, 2 Violet, 3 Mono

      []BroadcastIntervalSeconds — server snapshot interval (default: 1. 0)

      []StaleAfterSeconds — time before network data is marked stale (default: 5. 0)

      [*]CountdownInterpolation — loc