TensionAdd — User Guide (Install, Use, Configure)

EN

What is TensionAdd?

TensionAdd (mod id: tensionadd) is a Minecraft Forge 1.12.2 mod that adds configurable gameplay pressure and combat tweaks.

It focuses on:

Timed effects (a configurable debuff duration + cooldown)
BossRush: periodically spawn configured bosses around players
Boss Damage Reduction: per-boss, per-damage-type reduction rules
Entity Tweaks: per-entity attribute overrides, plus an optional “summon minions at half HP” mechanic

Main options (overview)

Debuff Duration: Debuff Duration (debuffDuration, ticks)
Tension Cooldown: Tension Cooldown (tensionCooldown)

BossRush

BossRush Enabled (bossRushEnabled)
BossRush Cooldown (bossRushCooldown, seconds)
BossRush Radius (bossRushRadius, blocks)
BossRush Boss List (bossRushBossList)
BossRush Interval Ticks (bossRushIntervalTicks, ticks)
BossRush Timeout Ticks (bossRushTimeoutTicks, ticks; 0 = no timeout)
BossRush Show BossBar (bossRushShowBossBar)

Boss Damage Reduction

Boss Damage Reduction Enabled (bossDamageReductionEnabled)
Boss Damage Reduction Per Level (bossDamageReductionPerLevel, 0–1)
Boss Damage Reduction Rules (bossDamageReductionRules)

Entity Tweaks

Entity Tweaks Enabled (entityTweakEnabled)
Entity Tweak Rules (entityTweakRules)

BossRush: how to configure boss waves

BossRush Boss List contains registry names, like defiledlands:the_destroyer.

You can also spawn multiple bosses in one wave by separating registry names with commas in a single element:

Example wave: defiledlands:the_destroyer,minecraft:wither

Other important knobs:

BossRush Radius: how far from the player bosses can spawn
BossRush Interval Ticks: how often the system checks / schedules the next wave
BossRush Timeout Ticks: time limit for the wave (0 means no limit)

Boss Damage Reduction: rule format

Each rule is one line:

Format: <entityRegistryName> <type>=<level>[,<type>=<level>...]
Supported types: fire, magic, projectile, explosion, physical
Level: non-negative integer (0 means no reduction)

Example (from the config comment):

defiledlands:the_destroyer fire=2,physical=1

The actual reduction per level is controlled by:

Boss Damage Reduction Per Level (example: 0.10 = 10% per level)

Entity Tweaks: attributes and half-HP summon

Entity Tweaks are rule-based adjustments applied to specific entities.

Rule format

Each rule is one line:

Format: <entityRegistryName> <key>=<value>[,<key>=<value>...]
Keys supported: hp, follow, speed, damage, knockback, summon

These values are applied via setBaseValue, meaning they override the entity’s default base attributes.

Summon (minions at half HP)

summon supports multiple candidate minions, separated by |. One candidate is chosen randomly per spawn.

Format: summon=<minion1>|<minion2>|...|<count>|<radius>|<setSummoned?>
<setSummoned?> is optional. The code defaults it to true.

Example (from the config comment in Configs.java):

defiledlands:the_destroyer hp=200,follow=128,speed=0.32,damage=16,knockback=1,summon=defiledlands:host|minecraft:zombie|3|12|true

Behavior notes:

The summon trigger is designed to happen once per entity, when its predicted health drops to 50% or below.

FAQ / Troubleshooting

Q: I edited the config but nothing changed.

Make sure you edited the correct file under config/ (or run/config/ for dev).
Restart the game/server after changing configs (common for Forge 1.12.2).

Q: Some entities don’t spawn in BossRush or summon doesn’t work.

Double-check registry names (case, namespace, typos).
Ensure the referenced mods that provide those entities are installed.

中文

TensionAdd 是什么？

TensionAdd（modid：tensionadd）是一个 Minecraft Forge 1.12.2 模组，用来增加可配置的战斗压力与怪物/首领机制。

主要功能包括：

时间相关效果（可配置的 Debuff 持续时间 + 冷却）
BossRush：按配置在玩家附近周期性刷出 Boss
Boss 伤害减免：针对指定 Boss、按伤害类型配置减伤等级
实体调整（Entity Tweaks）：按实体注册名覆盖属性；并可选“半血召唤小怪”机制

主要配置项（概览）

Debuff 持续时间：Debuff Duration（debuffDuration，单位 ticks）
Tension 冷却时间：Tension Cooldown（tensionCooldown）

BossRush

BossRush Enabled（bossRushEnabled）
BossRush Cooldown（bossRushCooldown，秒）
BossRush Radius（bossRushRadius，格）
BossRush Boss List（bossRushBossList）
BossRush Interval Ticks（bossRushIntervalTicks，ticks）
BossRush Timeout Ticks（bossRushTimeoutTicks，ticks；0 表示无超时）
BossRush Show BossBar（bossRushShowBossBar）

Boss 伤害减免

Boss Damage Reduction Enabled（bossDamageReductionEnabled）
Boss Damage Reduction Per Level（bossDamageReductionPerLevel，0–1）
Boss Damage Reduction Rules（bossDamageReductionRules）

Entity Tweaks（实体调整）

Entity Tweaks Enabled（entityTweakEnabled）
Entity Tweak Rules（entityTweakRules）

BossRush：如何配置 Boss 波次

BossRush Boss List 填写实体注册名，例如 defiledlands:the_destroyer。

也可以在同一个波次里刷多个 Boss：在同一项里用英文逗号分隔：

波次示例：defiledlands:the_destroyer,minecraft:wither

常用参数：

BossRush Radius：Boss 离玩家多远范围内生成
BossRush Interval Ticks：系统检查/调度下一波的频率
BossRush Timeout Ticks：波次持续时间上限（0 = 不限制）

Boss 伤害减免：规则格式

每行一条规则：

格式：<实体注册名> <类型>=<等级>[,<类型>=<等级>...]
支持类型：fire、magic、projectile、explosion、physical
等级：非负整数（0 表示不减伤）

示例（取自配置注释）：

defiledlands:the_destroyer fire=2,physical=1

每级减伤比例由以下配置决定：

Boss Damage Reduction Per Level（例如 0.10 = 每级减 10%）

Entity Tweaks：属性覆盖与“半血召唤”

Entity Tweaks 用规则对指定实体进行调整。

规则格式

每行一条：

格式：<实体注册名> <key>=<value>[,<key>=<value>...]
支持 key：hp、follow、speed、damage、knockback、summon

这些属性通过 setBaseValue 设置，会覆盖实体的默认基础属性。

summon（半血召唤小怪）

summon 支持多个候选小怪，用 | 分隔；每次生成会随机选择其中一个候选。

格式：summon=<小怪1>|<小怪2>|...|<数量>|<半径>|<setSummoned 可选>
<setSummoned> 可选；代码默认按 true 处理。

示例（取自 Configs.java 的注释）：

defiledlands:the_destroyer hp=200,follow=128,speed=0.32,damage=16,knockback=1,summon=defiledlands:host|minecraft:zombie|3|12|true

行为说明：

召唤机制设计为每只怪只触发一次：当预计血量降到 50% 或以下时触发。

常见问题 / 排错

Q：我改了配置但没生效。

确认你编辑的是 config/（或 dev 的 run/config/）下的正确文件。
Forge 1.12.2 很多配置需要重启游戏/服务器才会生效。

Q：BossRush 不刷 / summon 不生效。

检查实体注册名是否正确（命名空间、拼写、大小写）。
确认提供该实体的模组已安装。