Zifeng Skill Tree

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

【版本 Version】v1.4.4

--------------------------------------------------
English Version:
--------------------------------------------------
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
v1.4.4  ·  2026-09-30  ·  1.20.1 Forge + 1.21.1 NeoForge
MAJOR FIX RELEASE + SKILL MERGE — container item loss, command namespace, Loot Big Bang
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔴  CRITICAL FIXES

1) Relocation Art destroyed items at random inside modded containers
   Sophisticated Storage / Backpacks containers could lose items when the Relocation
   Art moved things into them. The slot API hands out the live ItemStack object
   instead of a copy, and inserting into an empty slot stores that very same object,
   so the source and the target ended up sharing one stack; writing the leftover
   amount back then overwrote the real count. Hauling now works on a copy and removes
   exactly the amount that was actually moved, using the container's own removal path.
   Million-sized stacks are moved in batches and nothing is lost any more.
   Storing into Sophisticated containers was never broken — only hauling reads and
   clears the source slot, which is why the old "do not store into itself" guard
   never really fixed the root cause.

2) Modded spawn eggs never dropped
   The Spawn Egg skill used the vanilla static lookup table, but Forge/NeoForge spawn
   egg items register their entity type lazily (as a supplier), so that table holds a
   null key for them and the lookup failed — silently and always. Productive Bees and
   any mod using the deferred spawn egg item were affected.
   The skill now falls back to scanning the item registry and caches the result.
   The species is preserved too: killing an Iron Bee drops an Iron Bee egg instead of
   a generic one.

3) /skilltree clashed with Passive Skill Tree
   Both mods registered /skilltree with identical sub-command paths, so Brigadier
   merged the nodes and only the first registrant ran — using Passive Skill Tree's own
   commands was adding points to this mod instead. The root command is now
   /zifengskilltree. /hmd and /delhmd are unchanged.

✨  NEW AND CHANGED

4) Loot Big Bang — two loot skills merged into one
   Loot Bomb and Soul Harvest did nearly the same thing, so they are now a single
   skill: Loot Big Bang. Level cap raised from 100 to 1000, the multiplier is simply
   1 + level (never reduced), and the old "only mobs affected by Looting" restriction
   is gone — every mob counts, bosses included. Levels already invested in the removed
   skill are refunded in full and cleared automatically on login.
   Drops are multiplied by count and split into full stacks, so a single drop becomes
   16 full stacks at max level instead of a thousand single-item entities.

5) Four drop modes (second hotkey inside the skill tree)
   1) All drops (default)  2) Stackables only  3) Non-stackables only
   4) Custom blacklist — matching items do not drop at all.
   The tile shows the multiplier and the current mode, and switching modes prints a
   chat message so you can tell that it worked.

6) Blacklist commands (no permission needed)
   /zifengskilltree lootblacklist — list the current blacklist
   /zifengskilltree lootblacklist add <item id or #tag>
        the suggestion list offers the held item's id and ALL of its tags, including
        common ones such as #forge:...
   /zifengskilltree lootblacklist remove <item id or #tag>

7) Command help
   /zifengskilltree (or /zifengskilltree help) lists every command of this mod in your
   game language. The join message now points to it.

8) Spawn Egg skill is now guaranteed at max level
   It used to be 10% per level, so even at level 5 it was only 50%. It is now 20% per
   level — level 5 is a guaranteed drop.

🔧  FIXES AND HARDENING

9) Drop mode switching did nothing and gave no feedback
   The client changed the mode locally, but the server packet whitelist only accepted
   the aura targeting and haul skills, so the packet was thrown away — no save, no
   message. The skill tree showed the new mode while the server kept the old one.
   Loot Big Bang is now accepted and the switch reports the new mode.

10) Blacklisted items still dropped one copy
    The blacklist only excluded items from the multiplier, not from the drop itself, so
    the vanilla drop stayed behind and it looked as if the mode did nothing.
    Matching items are now removed from the drop list entirely.

11) Sub-screens could not use the real screen size
    The rule is "keep at least 25% of the panel on screen", but the screen size was
    converted twice, so in smaller windows a panel could hang mostly off the edge.
    It is now enforced against the real screen size.

12) /zifengskilltree lootblacklist add #forge:tools was rejected
    The argument type only allowed letters, digits and a few symbols, so ":" and "#"
    were illegal characters — even minecraft:stone was rejected. It now accepts any
    text, with prefix filtering in the suggestion list.

✅  COMPATIBILITY
   ✅ Old saves and configs are fully compatible. Points invested in the merged skill
      are refunded automatically — nothing to do on your side.
   ✅ Both platforms identical in features and version: 140 skills + 1 stick-tool
      placeholder / 10 columns.
   ✅ Mod integrations (Goety, Ars Nouveau, Iron's Spells 'n Spellbooks, AE2,
      Productive Bees) are all optional — hidden and silent when absent. No hard
      dependency, works standalone.

Requirements: Forge 47.3.0+ (1.20.1, Java 17) / NeoForge 21.1.248+ (1.21.1, Java 21). No required dependencies.
Need an energy-generating mod to use the Skill Point Converter (1 skill point = 100,000,000 FE).

--------------------------------------------------
中文版：
--------------------------------------------------
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
v1.4.4  ·  2026-09-30  ·  1.20.1 Forge + 1.21.1 NeoForge
重要修复 + 技能整合版 · 精妙容器搬运丢物品 / 指令命名空间 / 战利品大爆发
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔴  严重修复

① 搬运术往精妙容器搬物品会随机销毁物品（历史遗留）
   子枫的搬运术把物品搬进 Sophisticated（精妙存储／精妙背包）容器时会随机丢东西。
   槽位 API 返回的是槽里那个 ItemStack 本体而不是副本，而插入到空槽时存入的正是
   同一个对象 —— 源槽与目标槽共享同一份数据，随后把「剩余量」写回源槽，
   数量就互相覆盖了。现在改为用副本插入，并按【实际搬走量】走容器自己的取出流程
   精确扣除，百万级的巨量堆也分批搬运，不再丢物。
   往精妙容器【存储】本来就是好的 —— 只有搬运术会「读源槽 + 清空源槽」，
   这也正是旧版「不能存进自己」的守卫治标不治本的原因。

② 模组刷怪蛋一个都不掉
   刷怪蛋技能用的是原版静态查表，而 Forge／NeoForge 的刷怪蛋物品是【延迟注册】
   （构造时实体类型还是空的），于是那张表里根本没有对应的键，
   查询永远失败且无任何报错。资源蜜蜂（Productive Bees）以及所有使用
   延迟注册刷怪蛋的模组都受影响。现在查不到时会回退扫描物品注册表并缓存结果。
   品种也补回来了：杀铁蜜蜂掉的是铁蜜蜂蛋，而不是通用蛋。

③ 指令 /skilltree 与 Passive Skill Tree 冲突
   两个模组都注册了 /skilltree，且子命令路径逐字相同，同名节点会被合并、
   只有先注册者生效 —— 于是用 Passive Skill Tree 自己的指令加点，
   加的是本模组的技能点。根指令现已改为 /zifengskilltree。
   /hmd、/delhmd 无冲突，保持原样。

✨  新增与变更

④ 战利品大爆发 —— 两个掉落技能合并为一个
   财源滚滚与猎魂丰收功能高度重复，现合并为单一技能【战利品大爆发】。
   等级上限 100 → 1000 级，倍率 = 1 + 等级（不再缩小），
   并去掉「仅对可受抢夺影响的生物生效」的限制 —— 全生物生效（含 Boss）。
   旧存档里已投入该技能的点数【全额退还】并自动清除，登录即完成，无需手动操作。
   掉落按数量放大并拆成满堆：满级 1 个掉落 = 16 个满堆，而不是上千个单件实体。

⑤ 4 种掉落模式（技能树内第二快捷键循环）
   ① 全掉落（默认） ② 仅堆叠物 ③ 仅不堆叠物
   ④ 自定义黑名单 —— 命中的物品【完全不掉落】。
   贴片显示倍率与当前模式；切换模式会在聊天栏提示，方便确认是否生效。

⑥ 掉落黑名单指令（无需权限）
   /zifengskilltree lootblacklist —— 查看当前黑名单
   /zifengskilltree lootblacklist add <物品id 或 #标签>
        候选框会自动列出【手持物品的 id 与它的全部标签】，
        包含 #forge:... 这类通用标签
   /zifengskilltree lootblacklist remove <物品id 或 #标签>

⑦ 指令帮助
   /zifengskilltree（或 /zifengskilltree help）列出本模组全部指令与用法，
   跟随游戏语言显示中／英文。进服欢迎提示也追加了这条指引。

⑧ 刷怪蛋满级必掉
   原为每级 10%，满 5 级也只有 50%；现改为每级 20% —— 满 5 级必定掉落。

🔧  修复与加固

⑨ 掉落模式切换没反应也没提示
   客户端本地先改了模式，但服务端模式包的允许清单只认光环与搬运术，
   包裹被直接丢弃 —— 既不存档也不提示，界面看着切了、服务端其实没变。
   现已放行战利品大爆发，切换后会提示新模式。

⑩ 黑名单里的物品仍会掉 1 个
   原实现只是把命中者排除出「放大」范围，并没有从掉落本身移除，
   原版掉落的那一份还在，看起来就像模式没生效。现已从掉落列表直接移除。

⑪ 子界面可移动范围没按屏幕自适应
   规则是「至少有 25% 留在屏幕内」，但屏幕尺寸被换算了两遍，
   窗口较小时面板会大半个移出屏幕。现改为按真实屏幕尺寸计算。

⑫ /zifengskilltree lootblacklist add #forge:tools 会报错
   参数类型只允许字母数字和少数符号，【:】与【#】都是非法字符 ——
   连 minecraft:stone 也会被拒。现已改为接受任意文本，并给候选框加前缀过滤。

✅  兼容性
   ✅ 旧存档与旧配置完全兼容。被合并技能中已投入的点数会自动退还，无需手动操作。
   ✅ 双平台功能与版本号完全一致：140 技能 + 1 木棍工具占位 / 10 列。
   ✅ Goety、新生魔艺、铁魔法、AE2、资源蜜蜂等均为可选联动 ——
      未安装时功能隐藏且无报错，无任何硬依赖，可独立使用。

环境要求：Forge 47.3.0+（1.20.1，Java 17）/ NeoForge 21.1.248+（1.21.1，Java 21）。无必需依赖。
使用星能转换机需要配合一个可以发电的模组（1 技能点 = 1 亿 FE）。