Zifeng Skill Tree

==================================================
Zifeng Skill Tree — CurseForge 更新报告（双语精简版）
Zifeng Skill Tree — CurseForge Changelog (Bilingual)
Minecraft 1.20.1 Forge + 1.21.1 NeoForge · v1.5.2
==================================================

【版本 Version】v1.5.2
【日期 Date】2026-10-11
【平台 Platform】1.20.1 Forge 47.3.0+ / 1.21.1 NeoForge 21.1.248+
【下载 Downloads】
  zifeng_s_custom_skill_tree-1.20.1-Forge-1.5.2.jar   (698 KB)
  zifeng_s_custom_skill_tree-1.21.1-NeoForge-1.5.2.jar (671 KB)
【前置 Dependencies】TaCZ（可选，枪械列）/ Just Enough Characters（可选，拼音搜索）

--------------------------------------------------
English Version:
--------------------------------------------------
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
v1.5.2  ·  2026-10-11  ·  1.20.1 Forge + 1.21.1 NeoForge
FEATURE RELEASE — Treasure Hunter modes, Block Scanner, Block Protection, pinyin search and Traditional Chinese
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯  TREASURE HUNTER

1) The mode key now cycles 4 highlight categories: all / loot containers only / archaeology
   brush spots only / spawners only. Applied at render time, so switching is instant.
2) The trigger key now toggles an "opened container filter": containers you already opened
   this session stop glowing. The toggle is stored server-side (it survives skill resets);
   the "already opened" record is client-side and lasts for the session. Double chests hide
   both halves, and a chest is removed from the highlight the moment it is opened.

🧩  NEW SKILL — BLOCK SCANNER  (Special column, one-time 100 points)

3) Mark a block with sneak + right-click while holding a stick, then press the trigger key to
   scan once: every block with a marked id within 64 blocks lights up. Mining or replacing a
   block clears its highlight within half a second. Any shape merges seamlessly (the outline
   is computed per plane), so irregular ore veins read cleanly instead of turning into one
   giant bounding box. The outline is drawn in two layers — purple hugging the block faces
   plus a gold copy pushed 0.15 blocks outward inside the plane — so it stays readable in dim
   caves and under shaders. The anti-z-fighting push is now driven by a recorded normal axis
   rather than guessing from equal coordinates (the guess was wrong for +Y/-Y vertical edges
   and both +Z/-Z edge kinds, which made those lines overlap the block face and render
   dim/patchy).

🛡️  NEW SKILL — BLOCK PROTECTION  (Aura column, one-time unlock)

4) Box-select a zone with the stick's Block Protection mode. Inside it, blocks cannot be mined
   or blown up BY ANYONE on the server — including TNT and creepers — and the mining progress
   bar never appears, because mining is rejected before it starts.

🔫  GUNS — the column grew from 4 skills to 12  (1.20.1 ONLY, TaCZ compatibility)

5) Seven property skills with prerequisites: Firearm Damage, Ballistic Penetration, Precision
   Shooting, Recoil Suppression, Quick ADS, Quick Swap and Gunrunner.
6) Killing Barrage — one cross-column skill replacing the damage-type rounds. Needs
   Slaughter Domain level 1 and carries that aura's damage on gun hits, together with the
   aura's two upgrades: Slaughter Domain+ adds a chaos portion and switches the whole bullet
   to a chaos damage source (shield break / crystal shield / boss tag), and Void Annihilation
   turns the hit into an absolute kill.
   NOTE: Chaos Rounds / Magic Rounds / True Damage Rounds were REMOVED — points spent on them
   are refunded IN FULL the first time the save loads.
   TaCZ stays an OPTIONAL dependency: without it the skills are visible but inert, and nothing
   crashes. NOTE: TaCZ only publishes 1.20.1, so this column cannot exist on 1.21.1.

⌨️  PINYIN SEARCH IN THE SKILL SEARCH BOX

7) With Just Enough Characters installed, the search box matches pinyin in addition to hanzi,
   English names and skill ids. JEC is optional — without it search simply falls back to plain
   substring matching. We ship no pinyin table of our own: JEC already handles full pinyin,
   initials, tones, zhuyin and shuangpin and follows the player's own JEC configuration.

🈶  TRADITIONAL CHINESE

8) Added zh_tw and zh_hk language files. Minecraft treats Traditional Chinese as TWO separate
   languages, so shipping only one of them would have made the whole mod fall back to English
   for the other's players.

🔧  FIXES

9)  Reload speed, magazine capacity and ADS time appeared to do nothing — TaCZ computes those
    values on the client too, and our level lookup returned 0 for anything that was not a
    server player, so the client kept overwriting the bonus with base values.
10) Reload speed did nothing on 24 of TaCZ's 54 default guns, because those route reloading
    through a Lua script and never call the default implementation.
11) Recoil Suppression and Quick Swap were completely dead: both annotations omitted the
    "method" attribute, which Mixin rejects outright, dropping the whole injection silently.
12) Fixed a crash on startup when JEC was installed — Forge requires a versionRange on every
    dependency entry, and omitting it produces an empty range that matches nothing.
13) The stick tool's mode limit is now derived instead of hard-coded, which fixes mode
    switching getting stuck; the stick HUD also shows the mode's item icon.

🛡️  BLOCK PROTECTION — unlimited zones

14) Block Protection used to allow only ONE zone per player, so securing a second warehouse
    or machine room meant re-selecting and losing the first. It now keeps its own list and
    you can box-select as many zones as you want.
    - Selecting adds a zone instead of replacing the old one; sneak + left-click deletes
      ONLY the zone you are looking at; the scroll-wheel adjust works per zone.
    - A zone saved by an older version is migrated into the new list when the save loads, so
      upgrading never makes a selection disappear.
    - The side-length limit still applies (each side <= 512 blocks) — that is a per-zone
      SIZE limit, not a count limit. The 10-zone cap on Aura's "Sanctuary Field" is a
      different feature and is unchanged.

--------------------------------------------------
中文版：
--------------------------------------------------
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
v1.5.2  ·  2026-10-11  ·  1.20.1 Forge + 1.21.1 NeoForge
功能版 — 寻宝大师模式、方块扫描、方块保护、拼音搜索与繁体中文
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯  寻宝大师

1) 模式键改为循环 4 种高亮类别：全部 / 仅战利品容器 / 仅考古刷扫点 / 仅刷怪笼。
   渲染时分流，切换即时生效。
2) 触发键改为切换「已开容器过滤」：本次会话已打开过的容器不再高亮。
   开关存服务端（重洗技能不清空）；「已开」记录在客户端、会话级。双箱子两半一起隐藏，
   开箱瞬间即从高亮中移除。

🧩  新增【方块扫描】（特殊列，一次性 100 点）

3) 手持木棍潜行右键标记方块，再按触发键扫描一次：半径 64 格内同 id 方块全部高亮。
   方块被挖掉或替换后 0.5 秒内自动消除高亮。任何形状都能无缝合并（按平面分批求轮廓），
   不规则矿脉不会变成一个巨大的包围盒。
   轮廓画【两层】：紫色紧贴方块面，金色是同一份轮廓在【面内】朝外推 0.15 格
   （沿面法线推只会前后重叠成一根线）—— 昏暗矿洞与光影下同样清晰。
   防 z-fighting 的沿法线外推改为按【记录下来的法线轴】加，不再靠「哪两个坐标相等」去猜；
   猜法对 +Y/-Y 的竖边与 +Z/-Z 的两种边都会猜错，偏移被加到面内 → 线框与方块面重合、发暗发虚。

🛡️  新增【方块保护】（光环列，一次性）

4) 木棍「方块保护」模式框选区域。区内方块【全服】免挖免炸 —— TNT 与苦力怕也炸不坏；
   而且连挖掘进度条都不会出现，因为挖掘在开始之前就被拒绝。

🔫  枪械列从 4 技能扩到 12 技能（仅 1.20.1，TaCZ 兼容）

5) 七项属性强化，各带前置：枪械伤害提升、弹道穿透强化、精准射击、后坐力抑制、
   快速开镜、快速切枪、持枪疾行。
6) 改为【杀戮弹幕】一条跨列联动（前置：杀戮光环 1 级）：命中附带光环伤害，
   并自动带上光环的两个强化态 —— 修罗杀域（附加混沌伤害 + 整发子弹换混沌伤害源
   → 破盾 / 破守卫水晶 / 挂 Boss 判定）、虚空诛灭（命中绝对秒杀）。
   注意：原「混沌弹 / 魔法弹 / 真伤弹」已删除，投入的点数首次读档【100% 全额】退还。
   TaCZ 仍为【可选依赖】：未安装时技能照常显示但无效果，不会崩。
   注意：TaCZ 只发布 1.20.1，所以该列无法存在于 1.21.1。

⌨️  技能搜索框支持拼音

7) 装了 Just Enough Characters 后，搜索框除汉字 / 英文名 / 技能 ID 之外还能按拼音匹配。
   JEC 为可选依赖 —— 未装时退化为普通子串匹配，一切照常。我们不自带拼音表：
   JEC 已支持全拼 / 声母 / 声调 / 注音 / 双拼，并跟随玩家自己的 JEC 配置。

🈶  繁体中文

8) 新增 zh_tw 与 zh_hk 语言文件。Minecraft 把繁体中文当作【两个独立语言】，
   只做其中一份会让另一份语言的玩家看到整个模组回落成英文。

🔧  修复

9)  换弹速度 / 弹匣容量 / 开镜耗时「看似无效」—— TaCZ 在客户端也会计算这些值，
    而我们的等级查询对非服务端玩家返回 0，导致客户端一直用基础值覆盖掉加成。
10) 换弹速度对 TaCZ 默认 54 把枪里的 24 把无效 —— 那些枪走 Lua 脚本，从不调用默认实现。
11) 「后坐力抑制」与「快速切枪」完全失效 —— 两处注解漏写 method 属性，Mixin 会直接丢弃整块注入，
    而且是静默的（不崩溃、也不打日志）。
12) 修复装了 JEC 时的启动崩溃 —— Forge 要求依赖块必须写 versionRange，漏写会得到空范围。
13) 木棍工具模式上限改为推导得出（不再硬编码），修掉「模式切换卡住」；HUD 模式名前显示物品图标。

🛡️  方块保护 — 选区不再限数量

14) 方块保护原先【每人只能框一块】，想再护住一个仓库 / 机器房就得重框、前一块作废。
    现在它有自己的选区列表，可以随便框多少块。
    · 框选是【新增】一块，不再覆盖上一块；潜行+左键只删【你正对着的】那一块；
      滚轮微调与金框显示都按块独立生效。
    · 旧版本已存的选区会在存档加载时自动迁移进新列表，所以升级不会「选区凭空消失」。
    · 单边长度限制仍在（每边 ≤ 512 格）—— 那是【单块的尺寸】限制，不是数量限制。
    · 「庇护领域」那个最多 10 块的上限是另一个技能，未做改动。