A floating damage numbers mod for 7 Days to Die that provides instant visual feedback during combat. Built with defensive coding principles to ensure reliability, stability, and performance without complicating your setup.
- Floating Damage Numbers — Customizable colors for normal hits, headshots, kills, and headshot kills
- Crosshair Hit Markers — Screen-center indicators that flash on successful hits
- TextMeshPro Rendering — High-quality fonts with outline support for better visibility
- Dual Configuration — Traditional XML files plus optional in-game UI (via Gears mod)
- Performance Optimized — Smart culling, cooldowns, and efficient memory usage
- No Corpse Spam — Numbers only appear on living targets and actual player damage
- Memory Safe — Proper cleanup prevents long-term degradation
This mod is designed around the idea that modding should enrich gameplay, not complicate it:
- Works instantly with sensible defaults
- Gracefully degrades when dependencies are missing — no crashes
- No prerequisites required
- Enhances feedback without changing gameplay balance
The goal is immediate enrichment with zero friction.
- Defensive by Design — Extensive error handling and fallback mechanisms
- Dependency Isolation — Gears integration is optional and fully separated
- Fail-Safe Defaults — Every setting has a working baseline
- Progressive Enhancement — XML configs stand alone; Gears UI adds convenience
- Download the mod
- Extract to the
Mods/folder - Disable EAC (required for all DLL mods)
- Launch the game — the mod works immediately
- (Optional) Install Gears for in-game configuration
- Sensible defaults are applied automatically.
- No user input required for basic functionality.
Toggle debug logging, restrict numbers to player-only damage, or randomize position for more dynamic effects.
Full RGB + hex color control for every damage type: normal, headshot, kill, and headshot kill.
Customize hit markers at the center of your crosshair. Adjust duration, size, and styles for each hit type.
Enable outlines around damage numbers for maximum visibility, with adjustable thickness and color control.
With Gears installed, configure the mod via Options > Mods > Angel's Damage Numbers. Settings include color pickers, sliders, and toggles. Changes apply instantly without restart.
Advanced users can edit:
Mods/Angel\_DamageNumbers/AngelDamageNumbersConfig.xml
- Shim Pattern — Gears integration is optional and isolated
- Automatic Fallbacks — Font loading, config, and camera detection all degrade gracefully
- Error Boundaries — Failures in one area won’t crash the mod
- Clean Lifecycle — Proper initialization and cleanup ensures stability
MIT License
- Fork the repository
- Create a feature branch
- Follow defensive coding principles
- Submit a pull request
Guideline: Always prioritize stability and user experience. Defaults must be safe, errors must degrade gracefully.
- Added optional Gears integration with in-game configuration UI
- Implemented TextMeshPro rendering with outline support
- Fixed memory leaks and improved long-term performance
- Suppressed damage numbers for corpses/dead entities
- Added automatic XML migration from older versions
- Enhanced error handling and graceful fallbacks
- Improved default settings
- Refactored architecture for maintainability