Alarm Spawn Teller

Alarm Spawn Teller is a GTFO HUD mod that shows dynamic enemy spawn information in real time.

It displays total spawned enemies, alive enemy count, and enemy type grouping on the HUD.

Features

• Shows dynamic enemy spawns on the HUD
• Displays total spawned count and alive count
• Groups enemies by enemy type
• Supports both Host and Client
• Uses an external localization JSON file
• Supports English, Chinese, and Japanese text

Installation

Install with a Thunderstore-compatible mod manager.

Manual installation structure:

BepInEx/plugins/AlarmSpawnTeller/
├─ AlarmSpawnTeller.dll
└─ AlarmSpawnTeller.localization.json

The localization file must stay beside the plugin DLL.

Localization

Localization is loaded from:

BepInEx/plugins/AlarmSpawnTeller/AlarmSpawnTeller.localization.json

You can edit this file to adjust displayed text and enemy names.

Currently supported languages:

• English
• Chinese
• Japanese

Known Notes

• Different dynamic spawn sources may currently be grouped as Dynamic Spawns.
• Door alarms, error alarms, scout-triggered waves, and other dynamic waves may share similar internal SurvivalWave behavior.
• This mod only displays HUD information locally.
• This mod does not send team chat messages.

Planned Improvements

• Better classification of specific spawn sources
• HUD redesign to better match GTFO’s visual style
• Automatic localization based on the game language when possible

AI Disclosure

This mod was developed with assistance from AI tools.

AI tools were used for debugging assistance, documentation/localization refinement, packaging guidance, and icon generation. The final implementation, testing, and release decisions were reviewed and controlled by the author.

中文说明

Alarm Spawn Teller 是一个 GTFO HUD 模组，用于实时显示动态刷怪信息。

它会在 HUD 上显示已刷怪物总数、当前存活数量，以及按怪物类型分组的统计信息。

功能

• 在 HUD 上显示动态刷怪信息
• 显示已刷怪物总数和当前存活数量
• 按怪物类型进行分组显示
• 支持 Host 和 Client
• 使用外置本地化 JSON 文件
• 支持英文、中文、日文文本

安装方式

推荐使用支持 Thunderstore 的模组管理器安装。

手动安装时，目录结构应为：

BepInEx/plugins/AlarmSpawnTeller/
├─ AlarmSpawnTeller.dll
└─ AlarmSpawnTeller.localization.json

本地化文件必须和插件 DLL 放在同一个目录下。

本地化

本地化文件读取路径为：

BepInEx/plugins/AlarmSpawnTeller/AlarmSpawnTeller.localization.json

你可以编辑该文件来调整 HUD 文本和怪物名称显示。

当前支持语言：

• English
• Chinese
• Japanese

已知说明

• 不同动态刷怪来源目前可能会统一显示为 动态刷怪。
• 警报门、错误警报、Scout 触发波次，以及其他动态刷怪，可能在游戏内部使用相似的 SurvivalWave 行为。
• 本模组只在本地显示 HUD 信息。
• 本模组不会发送队伍聊天消息。

后续计划

• 更准确地区分具体刷怪来源
• 将 HUD/UI 调整得更符合 GTFO 的视觉风格
• 尽可能让本地化自动跟随游戏语言

AI 使用说明

本模组在开发过程中使用了 AI 工具辅助。

AI 工具主要用于调试辅助、文档和本地化文本整理、打包流程检查，以及图标生成。最终实现、测试、打包和发布决定均由作者本人检查和控制。

Changelog

v0.5.1

English

• Maintenance release.
• Updated package metadata and documentation.
• No gameplay logic changes from v0.5.0.

中文

• 维护型小版本更新。
• 更新包信息与文档。
• 相比 v0.5.0 没有游戏逻辑变化。

v0.5.0 / Feature update

English

• Added experimental Blood Door spawn tracking.
• Added a separate Blood Door Spawns HUD block.
• Blood Door candidate spawns are now routed exclusively to the Blood Door tracker.
• Dynamic and Blood Door spawn displays are separated.
• Added special enemy fallback tracking for Tank, BossTank, and Pouncer.
• Added per-enemy-type Dynamic HUD cleanup.
• Dynamic enemy rows are removed after that type reaches zero alive enemies and remains unchanged for the configured timeout.
• Added configuration for DynamicAutoHideEnabled and DynamicAutoHideAfterSeconds.
• Added configuration for Blood Door spawn data classification.
• Added configuration for special enemy fallback tracking.
• Diagnostics are disabled by default.
• Localization behavior remains unchanged.

中文

• 新增实验性 Blood Door 刷怪统计。
• 新增独立的 Blood Door Spawns HUD 显示框。
• Blood Door candidate 刷怪现在会独占进入 BloodDoor tracker。
• Dynamic Spawns 与 Blood Door Spawns 分离显示。
• 新增 Tank、BossTank、Pouncer 的特殊敌人 fallback 统计。
• 新增 Dynamic HUD 按敌人类型逐行自动清理。
• 当某类 Dynamic 敌人存活归零并超过配置等待时间后，仅清除该类型条目。
• 新增 DynamicAutoHideEnabled 与 DynamicAutoHideAfterSeconds 配置。
• 新增 Blood Door spawn data classification 配置。
• 新增 special enemy fallback tracking 配置。
• 诊断日志默认关闭。
• 本地化行为保持不变。