CU Gun Helper

CU Gun Helper 是《Casualties Unknown / 未知伤亡》的枪械操作辅助插件。它把繁琐的换弹、上膛、泵动流程压缩成一次按键，并给你一个清晰的弹药 HUD，让你把注意力放在战斗而不是菜单操作上。纯本地便利功能，不做任何作弊 / 弹道修改。

一键自动换弹

- 按 `G` 自动完成完整换弹：退弹匣 → 取新弹匣 → 装弹匣 → 上膛

- 每个阶段都有独立耗时（可调），屏幕准星处有进度条提示

- 可打断：换弹进行中按左键或再按一次 `G` 即可取消，取消时自动补上膛，让你立刻能开火

普通 / 战术换弹

- 普通：卸下的旧弹匣放回容器

- 战术：丢弃旧弹匣，直接用新弹匣（更快）

霰弹枪 & 简易步枪自动泵动

- 每开一枪自动重新拉栓（0. 4s 拉 + 0. 4s 推，可调），告别手动泵动

弹药 HUD（左下角）

- 实时显示枪内弹药、身上备用弹匣数、备弹（散装弹）

- 低弹量警告：弹匣存量低于阈值时枪内显示变红并提示"该换了"，可选闪烁

- 外观完全可调：背景/文字透明度、位置偏移、字号

内置设置面板

- 按 `0`（数字行，非小键盘）打开，所有选项实时生效，无需重启游戏

## 可配置项（设置面板或 BepInEx 配置文件）

- 自动换弹键（默认 G）、设置面板键（默认 0）

- 换弹方式（普通/战术）

- 霰弹枪/步枪自动泵动开关

- 换弹各段耗时（退弹匣 / 取弹匣 / 装弹匣 / 上膛）与泵动耗时（拉/推）

- 弹药显示模式（精确 / 大致 / 不显示）、备用弹匣数显示、备弹显示

- 低弹量警告开关、触发百分比、闪烁

- HUD 外观：背景透明度、文字透明度、距底偏移、距左偏移（百分比）、字号

1. 需要 BepInEx 5.x（Mono 版） 已安装（本插件基于 BepInEx 5. 4. 23. 4 开发）。

2. 把 `CU_GunHelper.dll` 放入游戏目录下的 `BepInEx/plugins/`。

3. 启动游戏即可。首次运行会在 `BepInEx/config/` 生成 `com.tigerlin.cu.gunhelper.cfg` 配置文件。

- 单机 / 自建主机（Co-op）可用；未对多人对战做任何增强。

- 版本：插件 v0. 4. 0，适配游戏 Demo。游戏更新后如失效请反馈。

- 本简介由插件作者 tigerLin 编写。任何 bug 或建议欢迎在评论区留言。

仅提供本地便利功能，不包含任何自动瞄准 / 透视 / 加速等作弊功能。

# CU Gun Helper (English Description · for Nexus Mods)

## Overview

CU Gun Helper is a QoL weapon-handling plugin for Casualties Unknown. It compresses the tedious reload, chambering, and pump-action steps into a single keypress and gives you a clear ammo HUD, so you can focus on the fight instead of the menu. Purely local convenience — no cheats, no ballistics modification.

## Features

One-Key Auto Reload

- Press `G` to run a full reload automatically: eject magazine → grab new magazine → insert magazine → chamber a round

- Each stage has its own adjustable duration, with a progress bar near the crosshair

- Interruptible: press LMB or `G` again mid-reload to cancel; it auto-chambers on cancel so you can fire immediately

Normal / Tactical Reload

- Normal: the old magazine is returned to a container

- Tactical: drop the old magazine and load a fresh one (faster)

Auto Pump for Shotguns & Makeshift Rifles

- Auto-racks the action after every shot (0. 4s pull + 0. 4s push, adjustable)

Ammo HUD (bottom-left)

- Live display of rounds in the gun, spare magazines, and reserve (loose) ammo

- Low-ammo warning: turns red and shows a "reload" hint when below threshold, optional blink

- Fully adjustable appearance: background/text opacity, position offset, font size

Built-in Settings Panel

- Press `0` (top row, not numpad) to open; all options apply live without restarting

## Configuration (settings panel or BepInEx config file)

- Auto reload key (default `G`), settings panel key (default `0`)

- Reload mode (normal / tactical)

- Auto pump toggle (shotguns & makeshift rifles)

- Reload stage durations (eject / fetch / insert / rack) and pump durations (pull / push)

- Ammo display mode (exact / approximate / off), spare mag display, reserve ammo display

- Low-ammo warning: toggle, trigger percentage, blink

- HUD appearance: background opacity, text opacity, bottom offset, left offset (%), font size

## Installation

1. Requires BepInEx 5.x (Mono) installed (built against BepInEx 5. 4. 23. 4).

2. Place `CU_GunHelper.dll` into the game's `BepInEx/plugins/` folder.

3. Launch the game. On first run it generates `com.tigerlin.cu.gunhelper.cfg` in `BepInEx/config/`.

## Compatibility

- Works in single-player / self-hosted co-op; no multiplayer PvP enhancements.

- Plugin v0. 4. 0, adapted to the current demo build. Report if it breaks after a game update.

## Feedback

Description written by the author, tigerLin. Report bugs or suggestions in the comments.

Local convenience only — no aim assist, ESP, speed hack, or other cheating features.