You are viewing a potentially older version of this package. View all versions.
zooooox-ReloadTimer-1.5.0 icon

ReloadTimer

A tactical reload timer for GTFO with ammo warning. Supports hot-reloading, custom offsets, and synchronized circle animations.

By zooooox
Date uploaded 2 months ago
Version 1.5.0
Download link zooooox-ReloadTimer-1.5.0.zip
Downloads 581
Dependency string zooooox-ReloadTimer-1.5.0

This mod requires the following mods to function

BepInEx-BepInExPack_GTFO-3.2.2 icon
BepInEx-BepInExPack_GTFO

BepInEx pack for GTFO. Preconfigured and includes Unity Base DLLs.

Preferred version: 3.2.2

README

ReloadTimer

This mod replaces the generic reload process with a tactical, minimalist HUD positioned right below your crosshair.

Features

  • Reloading: Shows a countdown timer (e.g., 1.25s) perfectly synced with the circle progress.
    • Note: Since the game's ammo refresh timing is calculated using a combination of base reload time and multipliers, the countdown circle may experience a slight desync during a weapon's first reload. The correct timing is then cached locally, ensuring all subsequent reloads are perfectly synchronized.
  • Low Ammo: A persistent, jittering RELOAD warning in red when magazine capacity is low (ammo count removed for a cleaner HUD).
  • Calibration Persistence: Automatically saves and loads reload timings for each weapon across different Rundowns (Supports MTFO, TheArchive, and Vanilla).
  • Hot-Reload Support:
    • Change settings in r2modman (Config Editor) and click Save to see the changes in-game immediately.

Configuration

  • TextOffset: The vertical distance from the crosshair center. Default is 85.
  • ChargeUpColor: Custom color for the reload/charge-up circle. Default is #00FF0080.
  • LowAmmoThreshold: The ammo percentage (0.0 - 1.0) to trigger the "RELOAD" warning. Default is 0.35 (35%).
    • (Note: For weapons with a magazine size of 20 or less, the threshold is fixed at 0.50 (50%) for better visibility.)
  • LowAmmoColor: Custom color for the "RELOAD" warning text. Default is #FF000080.

CHANGELOG

[1.5.0]

  • UI Compatibility: Fixed the conflict between the reload progress circle and native charge weapons (e.g., Helgun).
  • Code Refactoring: Comprehensive optimization and code cleanup for better performance and professional compliance.

[1.4.0]

  • Reload Feedback: The reload timer's numeric text now turns green when the reload is complete, providing clearer visual confirmation.

[1.3.0]

  • Ammo HUD Cleanup: Removed ammo count from low-ammo warnings to reduce visual clutter; players now only see the "RELOAD" glitch indicator.
  • Calibration Persistence: Added local persistence for weapon reload calibration data, ensuring that custom reload timings are saved and loaded correctly across game sessions.
  • Rundown-Aware Fingerprinting: Implemented broad-spectrum Rundown identification (supporting MTFO, TheArchive, and Vanilla) to prevent calibration data contamination between different Rundown MODs.

[1.2.0]

  • Ultra-Minimalist HUD: Removed READY text and [ERR] prefixes from warnings to maintain a perfectly clean crosshair area.
  • Ammo Display: Ammo count now only appears during low-ammo warnings for enhanced tactical focus.

[1.1.3]

  • Increased the reload complete circle scale to 1.25 for a more noticeable visual effect.

[1.1.2]

  • Optimized reload warning visual performance.
  • Added a 100% progress circle scaling animation to enhance reload completion feedback.

[1.1.1]

  • Fixed an issue where the ammo warning (RELOAD) and reload timer text disappeared while aiming down sights (ADS).