StarRuptureTimer

StarRuptureTimer

A lightweight HUD overlay for StarRupture that shows the current Arcadia rupture phase and a countdown to the next phase change.

Author: Juntoaxx

Game: StarRupture

Version: 0. 1. 0

License: Public Domain

Important Update Note

If you are updating from an older version, delete your old config file first:

"starrupturetimer.ini"

Overview

StarRuptureTimer adds a small HUD overlay showing:

• []Current Arcadia rupture phase[/]

  []Countdown to the next phase change[/]

  Timer behavior is server-authoritative:

  • []The timer only appears when trusted server values are available[/]

    []While waiting for sync, the timer shows "XX:XX" in red[/]

    []Before sync, the phase label uses the Stable color preset so color changes are visible immediately[/]

    ---

    Current Features

    • []Live rupture phase and countdown HUD[/]

      []F8 live sync poll[/]

      []F8 dismisses the active alarm for the current phase cycle[/]

      []Repeating system-beep alarm with no WAV dependency[/]

      []Preset-only phase colors, using "Preset=1-32"[/]

      []Optional debug logging via "DebugMode"[/]

      ---

      Requirements

      This mod requires AlienMod Loader.

      • []AlienX's Mod Loader[/]

        Without the loader, "StarRuptureTimer.dll" will not be loaded.

        ---

        Installation

        • []Install AlienX's Mod Loader[/]

          []Download StarRuptureTimer from the Files tab[/]

          []Copy "StarRuptureTimer.dll" to:

          "StarRupture\Binaries\Win64\Plugins"[/]

          []Launch the game[/]

          []The config file will be generated automatically at:

          "StarRupture\Binaries\Win64\Plugins\config\StarRuptureTimer.ini"[/]

          ---

          Configuration

          All settings are stored in:

          "StarRuptureTimer.ini"

          Changes apply live while the game is running.

          General

          • []Enabled — enables or disables the overlay[/]

            []DebugMode — enables debug logging to "starrupturetimer.log"[/]

            Display

            • []Alpha — overlay opacity, from 0 to 100[/]

              []Scale — panel width scale, from 0 to 100[/]

              []FontSize — text size, from 1 to 10[/]

              []PosX — X position, with -1 using automatic lower-left placement[/]

              []PosY — Y position, with -1 using automatic lower-left placement[/]

              []Rotation — panel tilt, from -90 to 90[/]

              Alarm

              • []Enabled — enables or disables the phase alarm[/]

                []Phase — trigger phase: 0 Stable, 1 Incoming, 2 Burning, 3 Cooling, 4 Stabilizing[/]

                []TriggerMinutes — minutes before phase end[/]

                []TriggerSeconds — additional seconds before phase end[/]

                []BeepIntervalMs — delay between beeps, from 100 to 5000 ms[/]

                Alarm notes:

                • []The alarm repeats until dismissed with F8[/]

                  []Dismissal only applies to the current phase cycle[/]

                  ---

                  Phase Color Presets

                  Each phase can use a preset color from 1 to 32.

                  • []Colors. Stable[/]

                    []Colors. Incoming[/]

                    []Colors. Burning[/]

                    []Colors. Cooling[/]

                    []Colors. Stabilizing[/]

                    Each section uses:

                    "Preset=1-32"

                    "Colors. Stable — Preset=14"

                    Available presets:

                    • []1 White[/]

                      []2 LightGrey[/]

                      []3 Grey[/]

                      []4 DarkGrey[/]

                      []5 Black[/]

                      []6 Red[/]

                      []7 DarkRed[/]

                      []8 Orange[/]

                      []9 Amber[/]

                      []10 Yellow[/]

                      []11 Lime[/]

                      []12 Green[/]

                      []13 DarkGreen[/]

                      []14 Teal[/]

                      []15 Cyan[/]

                      []16 SkyBlue[/]

                      []17 Blue[/]

                      []18 DarkBlue[/]

                      []19 Navy[/]

                      []20 Indigo[/]

                      []21 Purple[/]

                      []22 Violet[/]

                      []23 Magenta[/]

                      []24 HotPink[/]

                      []25 Pink[/]

                      []26 Coral[/]

                      []27 Salmon[/]

                      []28 Gold[/]

                      []29 Bronze[/]

                      []30 Turquoise[/]

                      []31 Mint[/]

                      []32 Lavender[/]

                      ---