## ✨ 新增 / Additions
### Jade 改为客户端必须依赖 / Jade is now a required client dependency
客户端必须安装 Jade 才能启动本模组(用于悬浮提示展示);服务端不需要安装 Jade。
Jade is now a **required client dependency** — the client needs it installed, while dedicated servers do not.
### 适配 Patchouli 手册 / Patchouli guidebook added
新增游戏内 Patchouli 指南手册(中英双语)。
Adds an in-game Patchouli guidebook (English & Chinese).
### 生物属性标记特效 / Elemental attribute mob markings
四种属性的**强化生物**现在会在身上/脚下显示专属视觉标记,便于远距离辨认属性与强化等级,
帮助识别混在敌群里的强化个体。全部为**纯客户端渲染**,不产生任何服务端广播或网络流量,
可在配置中逐项开关。
All four elements now give **enhanced (marked) creatures** a dedicated visual signature so their
attribute and tier can be read at a glance. Rendering is **entirely client-side** — no server
broadcasts and no network traffic — and each element can be toggled independently in the config.
---
## ⚖️ 调整 / Changes
### 配置目录改名 / Config directory renamed
配置目录从 `config/ElementalCraft/` 改名为 **`config/Elemental_Reactions/`**,
其中的 `elementalcraft-*.toml` 同时改名为 `elemental-*.toml`。**启动时自动迁移,旧配置不会丢失**;
若新旧文件同名同时存在,旧文件会被删除并以新文件为准。
Patchouli 手册内的配置文件路径说明已同步更新。
The config directory has been renamed from `config/ElementalCraft/` to **`config/Elemental_Reactions/`**,
with `elementalcraft-*.toml` files renamed to `elemental-*.toml`. Migration runs **automatically at
startup**, so existing settings carry over. If both an old and a new file exist, the old one is
deleted in favour of the new one. The Patchouli guidebook's config path pages were updated to match.
### 潮湿触发药水范围调整 / Wetness potion sources
现在只有**喷溅水瓶**能触发潮湿(此前任意投掷药水都会加潮湿)。同时允许**喷溅型平凡药水**与**喷溅型浓稠药水**也能触发潮湿。
Now only **splash water bottles** can trigger Wetness (previously any thrown potion did). **Splash mundane** and **splash thick** potions also trigger Wetness.
### 雷暴/带电更稳定 / More stable Thunder & electrified water
雷暴与水体带电的追踪改为按实体记录,多人不再互相覆盖或阻塞;实体离开或服务器停止时自动清理。
Thunder & electrified-water tracking is now per-entity, so multiple players no longer overwrite or block each other. Effects are cleaned up when the entity leaves or the server stops.
### 霜冻周期伤害节奏调整 / Frostbite DoT timing rework
霜冻周期伤害改为按实际效果时长计时,每次伤害至少间隔 20 刻,不再被无敌帧吞掉。
Frostbite DoT now follows the actual effect duration and has a 20-tick floor between hits, so it can no longer be swallowed by invulnerability frames.
---
## ⌨️ 命令变更 / Commands
### 根命令最终为 `/elemental` / Final root command: `/elemental`
开发过程中根命令曾短暂从 `/elementalcraft` 改名为 `/element`,**现已改回 `/elemental`**。
下面所有示例请以 `/elemental` 为准。
During development the root command was briefly renamed from `/elementalcraft` to `/element`, but
it has since been changed **back to `/elemental`**. Use `/elemental` in all examples below.
### 权限调整 / Permission changes
- `/elemental` 根命令与 `/elemental debug`:**所有玩家可用**(仅影响执行者自身的调试开关,
且推送日志时只发给"本人 / 该怪当前目标 / 最近攻击者",不会泄露他人战斗信息)。
- `/elemental reload`、`entity`、`item`、`biome`、`blacklist` 等写配置命令:仍需要管理员权限
(LEVEL_GAMEMASTERS)。
- The `/elemental` root command and `/elemental debug` are available to **all players** (they only
toggle the executor's own debug output, and messages are filtered to the executor / the creature's
current target / its recent attacker).
- Write commands such as `/elemental reload`, `entity`, `item`, `biome`, and `blacklist` still
require operator permission (LEVEL_GAMEMASTERS).
---
## 🛠️ 修复 / Fixes
### 赤焰反击定身软锁修复 / Fire Counter soft-lock fix
跨维度、实体卸载后不再永久卡住,伤害减免标记不再残留。
Fixed Fire Counter immobilization soft-lock across dimensions and after entity unload.
### 蒸汽致盲永久失明修复 / Permanent blindness fix
重登后不再永久失明。
Fixed permanent blindness after re-login caused by steam.
### 蒸汽烫伤重复减免修复 / Steam scald double-reduction fix
之前同一跳蒸汽伤害会被附魔减免两次,现在每次蒸汽伤害只正常减免一次(附魔对每一跳蒸汽伤害都持续生效)。
Previously a single steam damage tick could be reduced twice by enchantments; now each steam hit is reduced exactly once (enchantment reduction still applies to every steam tick).
### 雷法术附魔永久丢失修复 / Lost enchantment fix after thunder spells
雷法术命中后,怪物武器附魔被剥离却无法还原的问题已修复。
Fixed ISS caster mobs permanently losing weapon enchantments after being hit by thunder spells.
### 冻结/麻痹叠加 AI 卡死修复 / Frozen-paralysed AI lock fix
冻结与麻痹叠加时生物 AI 恢复错乱、卡住不动的问题已修复。
Fixed mobs staying frozen/permanently no-AI when Freeze and Paralysis overlapped.
### 雷暴麻痹标记残留修复 / Lingering paralysis marker fix
离开风暴范围后麻痹标记不再残留。
Fixed paralysis marker lingering after leaving a thunderstorm.
### 毒爆链式传染稳定性修复 / Toxic blast chain stability fix
增加存活与区块加载校验。
Fixed spore-blast chain infection stability (alive & chunk-load checks).
### 投掷水瓶死锁修复 / Water bottle throw deadlock fix
`wetnessMaxLevel<=0` 配置下不再死锁。
Fixed a deadlock when throwing water bottles with max wetness set to 0.
### 投掷命中误判修复 / Bottle hit-miss misjudgment fix
现在按目标 UUID 记录,不会因为怪物更换目标而误判。
Fixed bottle hit/miss misjudgment by tracking the target UUID.
### 火焰反制减伤上限修复 / Fire Counter reduction cap fix
现在 clamped 到 99%,避免完全无敌。
Fixed Fire Counter reduction now capped at 99%.
### 寒冷生物群系冻结负面等级修复 / Cold-biome freeze amplifier fix
不再出现 amplifier=-1。
Fixed negative freeze amplifier in cold biomes.
### 静电/临时静电抖动修复 / Static flicker fix
伤害路径覆盖导致的抖动问题已修复。
Fixed temporary static flicker caused by overlapping tracking paths.
### `chance_80_100` 配置项生效修复 / chance_80_100 config now works
`chance_80_100` 配置项现在真正生效(默认分布保持不变)。
The `chance_80_100` config option now actually takes effect (default distribution unchanged).
### 命令中文字符串错位修复 / Command translation misalignment fix
`/elemental biome add` 与 `/elemental blacklist` 命令输出不再错位。
Fixed placeholder misalignment in biome & blacklist command messages (Chinese).
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }