HF Nightfall Overdrive
Advanced HF-BLADE Combat Enhancement Addon
HF Nightfall Overdrive is a combat enhancement addon designed for Epic Fight Nightfall 1.20.1. It significantly expands the combat capabilities of the existing HF-BLADE by introducing a specialized damage-processing system, combo-based damage scaling, advanced invulnerability handling, defensive bypass mechanics, and optional compatibility with FantasyEnding.
The primary goal of this addon is to make HF-BLADE attacks function reliably against powerful enemies, bosses, and entities protected by complex combat systems or other mods.
Unlike a conventional weapon addon, HF Nightfall Overdrive focuses on modifying the underlying combat mechanics of HF-BLADE. It uses server-authoritative attack validation and specialized combat processing to ensure that its effects are handled on the server rather than relying exclusively on client-side behavior.
1. HF-BLADE Combat Enhancement
The addon integrates directly with the existing HF-BLADE implementation from Epic Fight Nightfall.
It recognizes HF-BLADE attacks through their weapon identity, attack animations, and slash execution context.
The system specifically handles:
- HF-BLADE attack animations.
- Murasama attack animation processing.
- Zansetsu attack animation processing.
- HF-BLADE slash entities.
- Attack ownership and attacker validation.
- Active attack context tracking.
The addon distinguishes genuine HF-BLADE attacks from unrelated damage sources. This is important because its special damage rules should only apply to authorized HF-BLADE attacks.
It also tracks the beginning and ending of attack sequences to prevent unrelated attacks from accidentally inheriting HF-BLADE combat properties.
2. High-Power Damage System
HF Nightfall Overdrive introduces a configurable damage multiplier that affects HF-BLADE attack animations and HF-BLADE slash entities.
Default damage multiplier: 64x
The multiplier is configurable through the server configuration file.
The available configuration range is:
- Minimum: 1x
- Default: 64x
- Maximum: 1,000,000x
This allows server administrators to adjust the weapon’s damage output according to their modpack, boss difficulty, and combat environment.
The damage system is designed to work against targets with extremely high health values and combat modifications that would otherwise interfere with normal damage processing.
3. Dynamic Combo Damage Scaling
The addon includes a consecutive-hit combo system.
Successfully registered HF-BLADE hits increase the additional combo damage multiplier.
Default settings:
- Additional multiplier per successful hit: +0.15x
- Maximum additional multiplier: 2.5x
- Combo reset window: 40 ticks (2 seconds)
The combo system tracks successful hits rather than simply counting attack animations.
If another successful HF-BLADE hit occurs within the configured time window, the additional multiplier increases.
If the player fails to maintain the combo within the allowed time, the combo progression resets.
The maximum additional multiplier is capped to prevent unlimited scaling.
This system rewards continuous offensive pressure and allows players to build up stronger attacks through sustained combat.
4. Advanced Damage Reduction Bypass
One of the main features of HF Nightfall Overdrive is its ability to bypass several defensive mechanics for authorized HF-BLADE attacks.
The addon provides configurable bypass options for:
Vanilla Armor
- Bypasses vanilla armor calculations.
- Bypasses armor toughness calculations.
Magic Damage Reduction
- Bypasses vanilla magic damage reduction.
- Includes Resistance-related reduction.
- Includes Protection enchantment reduction.
Shields
- Can bypass vanilla shield blocking.
Epic Fight Defensive Mechanics
- Can bypass Epic Fight temporary invulnerability flags.
- Can bypass certain dodge-state MISS results.
- Can convert Epic Fight BLOCKED, guard, and parry results into successful HF-BLADE hits.
These systems are independently configurable.
The purpose is to prevent authorized HF-BLADE attacks from being unnecessarily rejected by defensive systems that would otherwise prevent the intended attack from connecting.
5. Invulnerability and Hit Registration System
HF Nightfall Overdrive includes specialized handling for temporary invulnerability and damage registration.
The addon can:
- Bypass timed Entity and LivingEntity invulnerability gates.
- Reset vanilla hurt cooldown for active HF-BLADE hits.
- Handle Epic Fight temporary invulnerability.
- Process authorized attacks through specific immunity checks.
- Validate whether the intended damage was actually applied.
The system also distinguishes between protected entities and valid attack targets.
Creative-mode and spectator players, as well as protected allies, retain their immunity under the relevant protection rules.
This is intended to prevent HF-BLADE attacks from unintentionally affecting entities that should remain protected.
6. Advanced Damage Validation and Entity Removal
Some mods modify damage processing in ways that can reduce, cancel, restore, or completely reject incoming damage.
For example, an entity may receive an attack but have its health restored by another system, or a mod may clamp incoming damage below the expected amount.
HF Nightfall Overdrive includes a damage validation system that checks the actual result of an authorized HF-BLADE hit.
It records information such as:
- Health before the attack.
- Expected damage.
- Actual health reduction.
- Whether the hurt operation was accepted.
- Whether lethal damage was prevented.
- Whether the damage was reduced below the configured threshold.
The default minimum accepted damage ratio is 0.95 (95%).
If an authorized attack is rejected or its damage is reduced below the configured threshold, the addon can activate configurable last-resort removal behavior.
Available options include:
- Removing non-player LivingEntities when an authorized hit is rejected.
- Removing non-player LivingEntities when damage is reduced excessively.
- Removing non-player LivingEntities when an otherwise lethal hit is prevented.
These emergency behaviors are configurable.
Important: Last-resort removal can bypass normal death processing, including drops and death animations. It should therefore be considered an advanced compatibility feature rather than a normal damage effect.
7. Resurrection and Re-Summoning Protection
The addon also includes mechanisms intended to prevent defeated entities from returning through certain resurrection or rejoining mechanics.
Its systems include:
Death Sealing
- Records entities defeated by authorized HF-BLADE attacks.
- Prevents certain same-instance resurrection and vanilla living-conversion resurrection paths.
- Uses persistent entity data to track the death-sealing state.
Local Re-Summon Blocking
- Temporarily blocks new entities of the same type from joining near an entity defeated by HF-BLADE.
- Uses a configurable time limit and radius.
Default settings:
- Duration: 600 ticks (30 seconds).
- Radius: 16 blocks.
This feature can also affect natural spawning of the same entity type within the restricted area.
The purpose is to prevent certain forms of immediate re-summoning from undermining the result of an HF-BLADE kill.
8. Zandatsu Descent Protection
HF Nightfall Overdrive includes a specialized defensive mechanic associated with Zandatsu animations.
When enabled, the HF-BLADE user receives protection while airborne and descending during a Zandatsu animation.
This protection is conditional rather than a permanent defensive bonus.
It is intended to protect the player during the specified part of the animation without granting unrestricted invulnerability throughout normal combat.
The feature can be enabled or disabled through configuration.
9. FantasyEnding Compatibility
HF Nightfall Overdrive includes optional integration with FantasyEnding.
The compatibility system is designed to interact with FantasyEnding’s Ultimate Order Manager (UOM) boss and its defensive mechanics.
The addon checks whether the required FantasyEnding classes are present before activating the corresponding compatibility mixins.
FantasyEnding integration includes:
Runic Shield Compatibility
- Can bypass FantasyEnding runic shield damage cancellation and reduction for authorized HF-BLADE attacks.
- Includes compatibility with the Fe Runic Shield capability.
- Includes compatibility with the Magic Runic Shield capability.
Ultimate Order Manager Compatibility
- Can bypass custom invulnerability timers.
- Can bypass certain dodge mechanics.
- Can bypass the final-skill timed immunity gate.
- Can bypass ordinary damage reduction.
- Includes compatibility with the UOM boss’s specialized damage-processing methods.
These compatibility options are controlled independently through the optional compatibility configuration section.
The addon also includes an optional UOM force-kill feature.
When enabled, a server-validated HF-BLADE hit against the Ultimate Order Manager can immediately remove the boss.
This intentionally bypasses scripted boss phases and is enabled by default.
The force-kill operation is subject to attack validation and server-side target checks.
FantasyEnding is an optional compatibility integration. It is not declared as a mandatory dependency in the mod metadata.
10. UOM Core Reward
HF Nightfall Overdrive adds a new item:
UOM Core
Internal item ID:
hf_nightfall_overdrive:uom_core
Properties:
- Epic rarity.
- Maximum stack size: 1.
- Registered as an independent item in the addon.
The item is associated with the Ultimate Order Manager defeat reward system.
When a qualifying UOM defeat is registered, the server can generate an UOM Core at the boss’s location.
The reward system includes duplicate-reward protection using persistent entity data.
It also includes an advancement:
End of the End
Description:
“Defeat the Ultimate Order Manager with HF-BLADE.”
This advancement is awarded through the server-side reward handling system.
11. Server-Authoritative Architecture
A major design principle of HF Nightfall Overdrive is server-side combat validation.
The addon performs important operations on the logical server, including:
- Attack authorization.
- Damage validation.
- Health-change observation.
- Entity removal.
- Death sealing.
- Local re-summon blocking.
- UOM reward generation.
- Advancement awarding.
The system uses a tracked attack context to associate damage with the appropriate HF-BLADE attacker.
This helps prevent unrelated damage sources from receiving the addon’s special combat effects.
It also reduces dependence on client-side attack state for important combat decisions.
12. Configuration and Customization
HF Nightfall Overdrive provides an extensive Forge configuration system.
Administrators can customize damage and compatibility behavior without modifying the mod’s source code.
The main configuration sections are:
hf_blade
- Damage multiplier.
- Combo multiplier per hit.
- Maximum combo multiplier.
- Combo reset window.
- Zandatsu descent protection.
- Armor bypass.
- Magic reduction bypass.
- Shield bypass.
- Hurt cooldown reset.
- Timed invulnerability bypass.
- Epic Fight temporary invulnerability bypass.
- Epic Fight guard and parry bypass.
- Entity immunity flag bypass.
- Forge damage event cancellation bypass.
- Forge death cancellation bypass.
- Rejected-hit removal.
- Reduced-damage removal.
- Prevented-lethal-hit removal.
- Minimum accepted damage ratio.
- Death sealing.
- Local re-summon blocking.
- Re-summon blocking duration.
- Re-summon blocking radius.
optional_compatibility
- FantasyEnding runic barrier bypass.
- FantasyEnding UOM damage reduction and invulnerability bypass.
- FantasyEnding UOM force kill.
The configuration allows administrators to decide how aggressively HF-BLADE should interact with other combat systems.
13. Debugging and Diagnostics
The addon includes a dedicated debug logging system.
Administrators can control detailed logging through the following command:
/debuglogaddon on
/debuglogaddon off
/debuglogaddon status
When enabled, detailed diagnostic information is written to:
logs/latest.log
The logging system includes information about attack authorization, damage processing, target validation, entity removal, and UOM compatibility operations.
This is particularly useful when investigating conflicts with other mods or determining why a particular target did not receive the expected damage.
14. Technical Information
Mod Name: HF Nightfall Overdrive
Mod ID: hf_nightfall_overdrive
Version: 1.0.6
Minecraft Version: 1.20.1
Mod Loader: Minecraft Forge 47.x
Java Version: Java 17
Primary Integration: Epic Fight Nightfall
Required EFN Version: 3.4.2
Optional Integration: FantasyEnding
License: MIT
Author: TeraMods
Required dependencies:
- Minecraft 1.20.1
- Minecraft Forge 47 or later within the supported environment
- Epic Fight Nightfall 3.4.2
FantasyEnding is optional and is only integrated when its required classes are available.
Overall Concept
HF Nightfall Overdrive is designed for players and modpack creators who want HF-BLADE to remain effective against extremely powerful enemies and complicated defensive systems.
Its focus is not simply increasing attack damage.
It combines damage scaling, combo progression, defensive bypass mechanics, damage validation, resurrection prevention, boss compatibility, and server-side combat processing into one integrated enhancement system.
Whether used in a heavily modified combat environment or alongside powerful boss mods, HF Nightfall Overdrive aims to provide a more consistent and configurable HF-BLADE combat experience.