death counter

A BepInEx plugin for Hollow Knight: Silksong that tracks and displays player deaths. Supports per-archive and per-run counters, hotkey resets, automatic configuration saving, and UI overrides. Provides verbose logging and alternate detection when switching archive slots.

Silksong Death Counter

✨ **BOSS Update 4.0.0 - September 30, 2025** ✨

🎯Mod Overview

**Silksong Death Counter** is a full-featured BepInEx mod that upgrades simple death tracking into a complete statistics system. It supports global death statistics, independent counts for each archive, and Boss-specific death analysis, with a beautiful UI interface and detailed data analysis.

Perfect for challenge runs, speedrunning, boss practice, or comprehensive game data analysis!

---

✨ Core Functions

🎯 Advanced Death Tracking

• **Global and Archive Independent Tracking** - Maintain independent counters for each archive file
• **Boss Exclusive Death Statistics** - Detailed statistics for each Boss encounter
• **RUN COUNTER SYSTEM** - Tracks the number of deaths per game session
• **File-based storage system** - Provides reliable data persistence outside of configuration files

🎨 Rich user interface

• **Screen HUD** - Death counter continuously displayed in the upper left corner
• **Boss Statistics Interface (F9)** - Exquisite overlay displays Boss death analysis
• **Unity Resource Pack Integration** - Professional UI components that support appropriate scaling
• **Log Wizard Integration** - Boss icons are pulled directly from the game's logging system
• **Toggle Visibility (F8)** - Hide/show death counter at will

⚔️ Boss battle system

• **Automatic Boss Detection** - Real-time identification of boss battles
• **Boss Metadata Tracking** - stores log name, display name and sprite reference
• **Boss Death Analysis** - Know exactly which bosses cause the most trouble
• **Boss battle status management** - Track the start and end time of the battle

⚙️ Configuration and Control

• **F8** - Toggle death counter visibility
• **F9** - Show/Hide Boss Stats Overlay
• **F10** - Reset running death counter
• **Fully Configurable** - Position, font size, visibility settings
• **Archive Slot Detection** - Support automatic profile switching

---

📥 Installation Guide

• Install BepInEx 5 (latest stable version) for your version of the game
• Unzip BepInEx to the Silk Song installation directory
• After running the game once, the plugins folder will be created
• Download the module compressed package from
• Internal folders:

```

SilksongDeathCounter/

└── SilksongDeathCounter.dll

└── ui_bundle

```

• Copy the SilksongDeathCounter folder to: `/BepInEx/plugins/`
• Start the game

---

🎮 How to use

Death Counter HUD

• Automatically displayed in the upper left corner
• Format: Number of deaths: (Run:)
• F8 key to toggle visibility

Boss Statistics (F9)

• Beautiful overlay showing boss death analysis
• Display the Boss sprite from the log system
• Show death count for each boss
• Scroll through boss death history

Hot key function

• **F8** - Toggle death counter visibility
• **F9** - Show/Hide Boss Statistics
• **F10** - Reset running counter

Data Storage

• Death count is stored in: BepInEx/plugins/SilksongDeathCounter/DeathCounterData/
• Separate files per archive slot: Save_1_Deaths.txt, etc.
• Boss data is in: BossDeaths/Boss__Save_.json

---

⚙️ Configuration Settings

After first startup, the module will create a configuration file:

`BepInEx/config/com.peacestudio.silksongdeathcounter.cfg`

Available settings:

**Hotkey Settings**

• ResetRunDeaths = F10 # Reset run counter
• BossStats = F9 # Boss statistics overlay
• ToggleCounter = F8 # Toggle counter visibility

**UI Settings**

• XPosition = 12 # Horizontal screen offset
• YPosition = 12 # Vertical screen offset
• FontSize = 16 # Death counter font size
• CounterVisible = true # Counter visible state

---

🎯 **Improve your Silk Song game experience an …