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 不生效。

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