Dcurrent: /* Defense */

2026-07-26T01:59:28Z

Defense

← Older revision		Revision as of 21:59, 25 July 2026
Line 110:		Line 110:
	\|<code>0</code> (Global)		\|<code>0</code> (Global)
	\|Selects the resource damaged by a blocked attack:		\|Selects the resource damaged by a blocked attack:
	<code>-1</code> – HP only.
	<code>0</code> – Global; use the module's global MP-block setting.		* <code>-1</code> – HP only.
	<code>1</code> – MP first, then apply any remainder to HP.		* <code>0</code> – Global; use the module's global MP-block setting.
	<code>2</code> – MP only; excess damage is discarded when MP reaches 0.		* <code>1</code> – MP first, then apply any remainder to HP.
	<code>3</code> – Both MP and HP receive the full blocked damage.		* <code>2</code> – MP only; excess damage is discarded when MP reaches 0.
			* <code>3</code> – Both MP and HP receive the full blocked damage.
	\|-		\|-
	\|<code>defense.damage.adjust</code>		\|<code>defense.damage.adjust</code>

Dcurrent at 20:25, 22 July 2026

2026-07-22T20:25:03Z

← Older revision		Revision as of 16:25, 22 July 2026
Line 1:		Line 1:
	OpenBOR includes a native system of damage control and mitigation. These settings adjust how entities deliver and respond to damage from different sources. For example, a character may resist, ignore, or absorb burn damage while remaining vulnerable to another attack type.		OpenBOR includes a native system of damage control and mitigation. These settings adjust how entities deliver and respond to damage from different sources. For example, a character may resist, ignore, or absorb burn damage while remaining vulnerable to another [[Attack Type\|attack type]].

	Offense properties modify damage delivered by an attacker. Defense properties modify incoming damage and reactions for the target. Both sets of properties may be configured independently for each [[Attack Type\|attack type]].		Offense properties modify damage delivered by an attacker. Defense properties modify incoming damage and reactions for the target. Both sets of properties may be configured independently for each [[Attack Type\|attack type]].

	== Model ==		== Model ==

Dcurrent: Added to categories.

2026-07-22T20:08:05Z

Added to categories.

← Older revision		Revision as of 16:08, 22 July 2026
Line 180:		Line 180:

	'''Tip:''' Factors and adjustments accept negative values. A negative final damage value restores hit points, up to the entity's maximum health.		'''Tip:''' Factors and adjustments accept negative values. A negative final damage value restores hit points, up to the entity's maximum health.
			[[Category:Openbor]]
			[[Category:Game Mechanics]]

Dcurrent: Created page with "OpenBOR includes a native system of damage control and mitigation. These settings adjust how entities deliver and respond to damage from different sources. For example, a character may resist, ignore, or absorb burn damage while remaining vulnerable to another attack type. Offense properties modify damage delivered by an attacker. Defense properties modify incoming damage and reactions for the target. Both sets of properties may be configured independently for each At..."

2026-07-22T20:07:24Z

Created page with "OpenBOR includes a native system of damage control and mitigation. These settings adjust how entities deliver and respond to damage from different sources. For example, a character may resist, ignore, or absorb burn damage while remaining vulnerable to another attack type. Offense properties modify damage delivered by an attacker. Defense properties modify incoming damage and reactions for the target. Both sets of properties may be configured independently for each At..."

New page

OpenBOR includes a native system of damage control and mitigation. These settings adjust how entities deliver and respond to damage from different sources. For example, a character may resist, ignore, or absorb burn damage while remaining vulnerable to another attack type.

Offense properties modify damage delivered by an attacker. Defense properties modify incoming damage and reactions for the target. Both sets of properties may be configured independently for each [[Attack Type|attack type]].

== Model ==
The following commands are model properties. They apply to every entity spawned from the model unless changed at runtime through script.

=== Pain Configuration ===
<syntaxhighlight lang="text">
pain_config <flags>

# Default
pain_config none
</syntaxhighlight>Controls basic reactions to hits. The command accepts one or more of the following flags:

* <code>none</code> – No pain configuration. This flag has no effect when combined with other flags.
* <code>back_pain</code> – Enables back-pain animations when the entity is hit from behind and does not otherwise ignore pain.
* <code>fall_disable</code> – Prevents knockdown while the entity is at ground level. An airborne hit may still cause knockdown unless <code>fall_disable_air</code> is also enabled.
* <code>fall_disable_air</code> – Prevents the automatic knockdown normally caused by an airborne hit.
* <code>pain_disable</code> – Prevents the entity from entering a pain animation.

==== Script ====
Pain configuration is an integer bitmask. The corresponding script constants are:

* <code>openborconstant("PAIN_CONFIG_NONE")</code>
* <code>openborconstant("PAIN_CONFIG_BACK_PAIN")</code>
* <code>openborconstant("PAIN_CONFIG_FALL_DISABLE")</code>
* <code>openborconstant("PAIN_CONFIG_FALL_DISABLE_AIR")</code>
* <code>openborconstant("PAIN_CONFIG_PAIN_DISABLE")</code>

=== Damage Types ===
Offense and defense commands accept an attack type followed by the property value. See [[Attack Type|Attack Types]] for full details.

* <code>all</code> – Applies the property to every non-special attack type, including creator-defined types. Special types must be configured individually.
* <code>normal#</code> – A numbered attack type. Replace <code>#</code> with the creator-facing, one-indexed type number; for example, <code>normal5</code> selects attack type 5.
* <code>blast</code> – Blast type.
* <code>burn</code> – Burn type.
* <code>freeze</code> – Freeze type.
* <code>shock</code> – Shock type.
* <code>steal</code> – Steal type.
* <code>boss_death</code> – Special type used to KO remaining enemies when a boss is defeated.
* <code>item</code> – Special type used when an item is collected.
* <code>land</code> – Special type used for landing damage.
* <code>lifespan</code> – Special type used when an entity's lifespan expires.
* <code>lose</code> – Special type used when time expires for players with a lose animation.
* <code>pit</code> – Special type used when an entity reaches pit depth.
* <code>sub_entity_parent_kill</code> – Special type used to KO a summon when its parent is removed.
* <code>sub_entity_unsummon</code> – Special type used to KO a summon at its unsummon frame.
* <code>timeover</code> – Special type used when time expires for players without a lose animation.

=== Offense ===
Offense properties modify the attacker's damage output before ordinary defense mitigation is applied.
{| class="wikitable"
!Command
!Default
!Description
|-
|<code>offense.damage.adjust</code>
|<code>0</code>
|Adds a fixed amount to damage after applying <code>offense.damage.factor</code>.
|-
|<code>offense.damage.max</code>
|<code>MAX_INT</code>
|Maximum damage after applying the offense factor and adjustment.
|-
|<code>offense.damage.min</code>
|<code>MIN_INT</code>
|Minimum damage after applying the offense factor and adjustment.
|-
|<code>offense.damage.factor</code>
|<code>1.0</code>
|Multiplies damage output. The intended property is floating-point; for example, <code>1.5</code> produces 150% damage. Fractional calculation results are truncated toward zero when converted to an integer.
|}
The following model delivers 50% more damage with burn attacks:<syntaxhighlight lang="text">
offense.damage.factor burn 1.5
</syntaxhighlight>

=== Defense ===
Defense properties modify incoming damage, blocking, pain, knockdown, and death behavior for each attack type.
{| class="wikitable"
!Command
!Default
!Description
|-
|<code>defense.block.damage.adjust</code>
|<code>0</code>
|Adds a fixed amount to blocked damage after applying <code>defense.block.ratio</code>.
|-
|<code>defense.block.damage.max</code>
|<code>MAX_INT</code>
|Maximum damage taken from a blocked attack after applying the block ratio and adjustment.
|-
|<code>defense.block.damage.min</code>
|<code>MIN_INT</code>
|Minimum damage taken from a blocked attack after applying the block ratio and adjustment.
|-
|<code>defense.block.power</code>
|<code>0</code>
|Works with <code>attack.block.penetrate</code>. When either value is nonzero, block power must be strictly greater than the attack's penetration value for the attack to remain blockable.
|-
|<code>defense.block.ratio</code>
|Special
|Multiplies damage when an attack is blocked. For example, <code>0.25</code> causes a blocked attack to inflict 25% of its raw damage. The internal default is <code>openborconstant("DEFENSE_BLOCKRATIO_COMPATABILITY_DEFAULT")</code>, allowing an explicit value of <code>0.0</code> to be distinguished from an unset property. When the special default remains in place, the engine uses <code>0.25</code> if the legacy global block-ratio option is enabled and <code>0.0</code> otherwise.
|-
|<code>defense.block.threshold</code>
|<code>0</code>
|Added to the entity's [[Blocking#Threshold|thold]] value. In the current implementation, a nonzero combined threshold is compared with the attack's raw damage force; attacks below the threshold cannot be blocked, while attacks meeting or exceeding it pass this eligibility test.
|-
|<code>defense.block.type</code>
|<code>0</code> (Global)
|Selects the resource damaged by a blocked attack:
<code>-1</code> – HP only.
<code>0</code> – Global; use the module's global MP-block setting.
<code>1</code> – MP first, then apply any remainder to HP.
<code>2</code> – MP only; excess damage is discarded when MP reaches 0.
<code>3</code> – Both MP and HP receive the full blocked damage.
|-
|<code>defense.damage.adjust</code>
|<code>0</code>
|Adds a fixed amount to incoming damage after applying <code>defense.factor</code>.
|-
|<code>defense.damage.max</code>
|<code>MAX_INT</code>
|Maximum damage taken after applying the ordinary defense factor and adjustment.
|-
|<code>defense.damage.min</code>
|<code>MIN_INT</code>
|Minimum damage taken after applying the ordinary defense factor and adjustment.
|-
|<code>defense.death.config</code>
|Default death configuration
|Sets death behavior when the entity is killed by the selected attack type. The accepted flags are otherwise identical to model [[Killed and Dead#Death Configuration|death configuration]].
|-
|<code>defense.factor</code>
|<code>1.0</code>
|Multiplies damage from an unblocked attack after the attacker's offense calculation.
|-
|<code>defense.knockdown</code>
|<code>1.0</code>
|Multiplies the attack's knockdown force before it is deducted from the target's knockdown counter. A value of <code>0.0</code> prevents the attack type from accumulating knockdown.
|-
|<code>defense.pain</code>
|<code>0</code>
|Minimum raw attack damage required to trigger pain. A value of <code>0</code> disables this resistance, so ordinary pain behavior is always eligible. This test uses the attack's original damage force, not damage after offense or defense calculations.
|}
This model takes half damage from attack type 5, requires at least 20 raw damage from that type to enter pain, and prevents that type from accumulating knockdown. It takes 150% damage from unblocked burn attacks and 50% of raw damage when a burn attack is blocked.<syntaxhighlight lang="text">
defense.factor normal5 0.5
defense.pain normal5 20
defense.knockdown normal5 0.0

defense.factor burn 1.5
defense.block.ratio burn 0.5
</syntaxhighlight>Under the current block-threshold implementation, the following additionally prevents burn attacks with less than 20 raw damage from being blocked:<syntaxhighlight lang="text">
defense.block.threshold burn 20
</syntaxhighlight>

== Calculation Order ==
For an unblocked hit, OpenBOR calculates damage in this order:

# Begin with <code>attack.damage.force</code>.
# Multiply by <code>offense.damage.factor</code>, then convert the result to an integer by truncating toward zero.
# Add <code>offense.damage.adjust</code>.
# Clamp to <code>offense.damage.min</code> and <code>offense.damage.max</code>.
# Multiply by <code>defense.factor</code>, then convert the result to an integer by truncating toward zero.
# Add <code>defense.damage.adjust</code>.
# Clamp to <code>defense.damage.min</code> and <code>defense.damage.max</code>.

For a blocked hit, OpenBOR first calculates the attacker’s offense-adjusted damage exactly as it would for an unblocked hit. It then applies the defender’s block-specific mitigation in place of the ordinary defense properties:

# Begin with <code>attack.damage.force</code>.
# Multiply by <code>offense.damage.factor</code>, then truncate the result toward zero.
# Add <code>offense.damage.adjust</code>.
# Clamp to <code>offense.damage.min</code> and <code>offense.damage.max</code>.
# Multiply by <code>defense.block.ratio</code>, then truncate the result toward zero.
# Add <code>defense.block.damage.adjust</code>.
# Clamp to <code>defense.block.damage.min</code> and <code>defense.block.damage.max</code>.
# Apply the resulting damage to HP, MP, or both according to <code>defense.block.type</code>.

The ordinary <code>defense.factor</code>, <code>defense.damage.adjust</code>, <code>defense.damage.min</code>, and <code>defense.damage.max</code> properties do not apply to blocked hits.

'''Tip:''' Factors and adjustments accept negative values. A negative final damage value restores hit points, up to the entity's maximum health.

Damage Control - Revision history

Dcurrent: /* Defense */

Dcurrent at 20:25, 22 July 2026

Dcurrent: Added to categories.