Modular Melee Hitbox System (MMHS) is a lightweight Blueprint framework for implementing reliable melee hit detection in Unreal Engine.
Traditional melee systems often rely on traces or complex collision setups that can produce inconsistent results, multi-hit bugs, or desynchronized animation timing. MMHS provides a clean, animation-driven approach that keeps hit detection predictable and easy to manage.
The system uses socket-attached hitboxes that activate during animation notify windows. When an attack animation reaches its active frames, the hitboxes become active and automatically detect valid targets. Each hitbox tracks which actors have already been hit to prevent duplicate damage events.
Because the system is modular and Blueprint-based, it can be integrated into existing projects without forcing a specific combat architecture. Developers can connect the hit events to their own damage systems, gameplay abilities, or combat logic.
The included Hitbox Rig component manages hitbox creation, activation windows, and collision filtering, allowing melee attacks to be configured through simple arrays and animation notifies.
Key Features
• Socket-based hitboxes that attach to character bones
• Animation Notify State driven activation windows
• Duplicate hit prevention per attack window
• Modular Blueprint component architecture
• Multiple hitboxes per attack supported
• Easy integration with existing combat systems
• Debug visualization for hitboxes and hit events
• Example demo map with test dummies included
Typical Use Cases
MMHS is designed as a foundation layer for melee combat systems and can be used in:
• Action combat games
• Fighting systems
• RPG melee combat
• Ability-based combat frameworks
• Prototyping combat mechanics
Integration
Add the Hitbox Rig component to a character.
Configure hitboxes using socket names.
Place Hit Window notify states inside attack animations.
Bind to the OnValidHit event to trigger damage or gameplay effects
The system handles hit detection, leaving damage logic and combat design fully customizable.
MMHS is intended to be lightweight, readable, and easily expandable, making it suitable for both production projects and learning environments.