CustomTimer

A configurable mission timer mod for R.E.P.O., designed to add time pressure and flexible control to runs — including multiplayer support.

Features

• Mission timer with configurable initial time

• Stage-based time bonuses (official and modded stages)

• Player-count based time scaling

• Multiple behaviors when time runs out

• Multiplayer-safe synchronization

• Optional HUD display

• Chat commands for runtime control

• Configurable per-stage time overrides

• Designed to be stable across level reloads

Time-Up Behavior

You can configure what happens when the timer reaches zero:

• KillAll

All players are killed. GameOver handling is left to the game itself.

• ReloadImmediate

The level is immediately reloaded.

• KillNonTruckPlayers (Recommended / Default)

Only players who have not reached the Truck are killed.

Players who successfully reached the Truck and received the final heal survive.

👉 This is the default and recommended option, as it feels the most fair and consistent in co-op play.

Configuration

All settings are available via the BepInEx config file.

General

• Enable / disable the mod

• Base initial timer value

Player Scaling

• Add bonus time when player count is below a threshold

• Fully configurable per missing player

Stage Bonus

• Add or subtract time based on stage category:

• Museum

• Manor

• Arctic

• Wizard

• Other / Modded stages

Stage Time Overrides

You can define custom time bonuses for specific stages:

stage_name:seconds,another_stage:-120

These values are added to the base timer and can be updated in-game using commands.

HUD

• Toggle timer HUD on/off

Debug

• Enable or disable debug logging

Commands

Commands are entered via chat and are host-only.

• /time

Toggle pause / resume for the timer.

• /timeset <seconds>

Immediately overwrite the current remaining time.

• /timemapset <seconds>

Register a time bonus for the current stage if it belongs to the Other category.

The value is saved to the config and applied in future runs.

Multiplayer Notes

• The host is authoritative for timer state

• Clients receive synchronized updates automatically

• Initial synchronization happens when the timer starts

• Safe against level reloads and late UI initialization

Credits

• UI inspiration:

Timer HUD design and layout were inspired by

Swaggies' TimeAttack mod

https://thunderstore.io/c/repo/p/Swaggies/TimeAttack/

Thanks for the reference and inspiration!

Notes

This mod focuses on being:

• Predictable

• Configurable

• Friendly to multiplayer

It is intended to be a flexible tool rather than a strict game mode.

日本語説明

概要

CustomTimer は R.E.P.O. 用のミッションタイマー MOD です。

マルチプレイ対応を前提に、制限時間・ステージ補正・人数補正などを柔軟に設定できます。

主な機能

• 初期時間を設定できるミッションタイマー

• ステージごとの時間補正（公式・MODステージ対応）

• プレイヤー人数に応じた時間補正

• タイムアップ時の挙動を選択可能

• マルチプレイ完全対応（同期処理あり）

• HUD 表示の ON / OFF

• チャットコマンドによる操作

• ステージ個別の時間補正設定

• リロードや実行順序に強い設計

タイムアップ時の挙動

タイマーが 0 になったときの動作を選択できます。

• KillAll

全プレイヤーを死亡させます（GameOver 処理はゲーム側に任せます）

• ReloadImmediate

即座にステージをリロードします

• KillNonTruckPlayers（推奨・デフォルト）

トラックに到達していないプレイヤーのみ死亡します

トラックに到達し、最終回復を受けたプレイヤーは生存します

👉 協力プレイで最も自然な挙動のため、この設定をデフォルトとして推奨しています

設定項目

基本設定

• MOD の有効 / 無効

• 初期タイマー時間

プレイヤー人数補正

• 人数が一定以下の場合にボーナス時間を追加

• 不足人数ごとに秒数を設定可能

ステージ補正

• Museum / Manor / Arctic / Wizard / Other

• マイナス値も設定可能

ステージ個別補正（自由記述）

stage_name:秒数,another_stage:-120

BaseTimer に 加算 される補正です。

コマンドからの登録も可能です。

HUD

• タイマー表示の ON / OFF

デバッグ

• デバッグログの有効 / 無効

コマンド（ホスト専用）

• /time

タイマーの一時停止 / 再開を切り替えます

• /timeset <秒数>

現在の残り時間を即座に上書きします

• /timemapset <秒数>

現在のステージが Other の場合、そのステージの時間補正を登録します

設定は Config に保存され、次回以降も有効です

クレジット

• UI 参考元

HUD のレイアウトや見せ方は

Swaggies 氏の TimeAttack MOD を参考にしています

https://thunderstore.io/c/repo/p/Swaggies/TimeAttack/

素晴らしい MOD をありがとう！

「制限時間を遊びに取り入れるためのツール」として使ってもらえると嬉しいです。

Changelog

[1.0.0]

Changed

• Updated compatibility for R.E.P.O. game version 0.4.x.

[0.2.3]

Improved

• Added a safeguard for rare cases where a player could remain alive after Time-up.
• If an extraction completes after Time-up and a survivor is detected, the timer will now resume with the configured Survivor Bonus Time.
• Survivor bonus notifications are now sent only to surviving players.

[0.2.2]

Fixed

• Fixed an issue where Time-up could incorrectly trigger while players were in the Shop.
• Fixed a UI layering issue where the Status UI was obscured by the Timer UI.

[0.2.1]

Changed

• Time-up penalties are now delayed while an extraction point is active.

• During extraction, time-up effects are suppressed and will only apply after cancellation.

• Updated KillNonTruckPlayers behavior:

  • Players who received Final Heal are now immune to time-up penalties.

[0.1.0] - Initial Release

Added

• Host-authoritative timer notifications:

  • Timer start (initial activation)
  • Timer pause / resume
  • Bonus time and forced time updates
  • Time-up announcement

• Chat notifications optimized for TTS readability

• Truck screen timer messages with formatted remaining time (mm:ss)

• Countdown notifications from 10 to 1 seconds

• Threshold-based timer notifications (configurable)

Configuration

• Fine-grained chat notification controls:

  • Enable / disable countdown, threshold, and bonus notifications independently
  • Adjustable notification cooldown
  • Customizable threshold seconds

• Single master toggle for truck screen notifications

Design Notes

• All notifications are host-authoritative

• Basic timer functionality and truck screen notifications work with host-only installation

• Installing the mod on clients is required to enable all chat-based and client-side features

• Chat and Truck notifications use different formats:

  • Chat: audio / TTS friendly
  • Truck: visual status display

• Notifications are triggered only on timer state changes, not every tick

[0.0.2]

Added

• Optional timer cap to limit maximum time
• Blackout-time forced timer override
• Blackout restrictions preventing further time bonuses

Changed

• Improved timer HUD behavior:

  • Timer UI remains visible while paused
  • Paused state is visually indicated
  • More consistent host/client display behavior

[0.0.1] - Initial Release

Added

• Configurable mission timer for R.E.P.O.

• Stage-based time bonuses (including modded stages)

• Player-count based time scaling

• Multiple time-up behaviors:

  • KillAll
  • ReloadImmediate
  • KillNonTruckPlayers (default / recommended)

• Multiplayer-safe timer synchronization

• Optional timer HUD

• Chat commands:

  • /time (pause / resume)
  • /timeset (overwrite remaining time)
  • /timemapset (register stage-specific time bonus)

• Configurable per-stage time overrides

• Debug logging option