饰品是每个男孩最好的朋友

饰品是每个男孩最好的朋友

你,灵魂,需要你最好的朋友,各种各样的饰品,来拯救武林和两个世界

饰品是每个男孩最好的朋友(v3.14-shipdefaults)

饰品强化 mod · 中英双语说明 / Bilingual Readme


【中文】


一、这是什么

《影之刃零》(Phantom Blade Zero)饰品强化 mod,基于自制 PBZModLoader 平台(PuerTS 运行时)。核心能力:

  1. 幽灵叠层:装备饰品时自动把该饰品效果叠加多层(默认单次 +5 层,总封顶 10 层),卸下不消失(拦截保魂)。
  2. 全背包轮扫:跨图或装备变化时,把物品栏全部饰品有序重叠一遍(共享工位协议,不依赖空槽位)。
  3. 分类规则:按游戏原生分类(攻击/辅助/生存)分别设定单次叠层数与封顶。当前辅助类 = 叠 1 层、封顶 2 层(辅助类二周目新属性多为杀气增益,叠加会吹爆杀气上限)。
  4. 净化名单(purgeIds):杀气族饰品(AC_Shachi 等 5 件)永不叠加、卸下不保魂,防「杀气上限膨胀→按上限流失」。
  5. 货币/物品差值倍增:心尘、钱币、材料进账按倍率放大(只乘进账,支出原价)。
  6. GE 哨卡:钩住游戏施加 GameplayEffect 的必经之路,按名字记录/收编/拦截(geBlock 名单可直接吞掉指定 GE)。
  7. 暗源反转(实验):侦测暗源消耗后回赠(GE 门牌捕获后生效)。
  8. 热重载:loader 每秒轮询,改完代码不重启游戏即生效。

二、运行环境(Requirements)

  • 《影之刃零》Steam 版(已验证版本:2026-11)
  • 已安装 PBZModLoader(本项目自制加载器,位于 ProjectPBZ/PBZModLoader,依赖游戏内 PuerTS)
  • 安装方式:解压后把 accessory-is-every-boys-best-friend 文件夹拷进 ProjectPBZ/PBZModLoader/mods/ 即可——下次启动游戏时加载器会自动扫描登记,无需任何手工配置。 (想临时停用:在 mods.ini 的 [Mods] 段加一行 accessory-is-every-boys-best-friend=0)

三、配置

配置文件:ProjectPBZ/Saved/PbzAccessoryKeeper-probe.log/config.json (游戏中切图即重读,不用重启)。常用键:

  • layerMultiplier 单次叠层(默认 5)
  • layerCap 总封顶(默认 10)
  • catRules 分类规则,如 {"Support":{"mult":1,"cap":2}}
  • purgeIds 净化名单(杀气族)
  • dustMultiplier / coinMultiplier / itemMultiplier / ultMultiplier
  • shadowGain 暗源反转倍率(0=关)
  • geBlock GE 拦截名单(子串匹配)
  • geRoute GE 系统总开关(疑似崩溃可置 false)

四、已知问题(Known Issues)

  1. 杀气 bug(长局缓慢复发):二周目辅助类饰品疑似带「击杀/命中后杀气上限+X%」的可无限叠加触发效果,层数帽管不了游戏原生触发。正在通过 GE 拦截根治。
  2. 属性直写无效:PuerTS 读 UE 结构体返回副本,写属性(杀气上限钳制/暗源直写)不进游戏本体,所有写入已改走 GE 正门。
  3. 一次 26 分钟后游戏退出的孤例,嫌疑(GE 扫描)已降频加固,未复现,真凶未定。
  4. 日志文件每 session 会被覆写,排查需当场取日志。
  5. 奥义充能 ×10、货币 coin 通道、属性集枚举仍在攻坚。

【English】


1. What it is

A Phantom Blade Zero accessory-boosting mod built on the homebrew PBZModLoader (PuerTS runtime). Features:

  1. Ghost stacking: equipping an accessory applies its effect multiple times (default +5 per equip, hard cap 10); stacks survive unequipping (soul-keeping intercept).
  2. Full-inventory sweep: on map change or gear change, restacks every accessory in the inventory via a shared workbench slot (no free slot required).
  3. Category rules: per-category stack multiplier and cap based on the game's native types (Attack/Support/Survival). Support is currently limited to +1 stack, cap 2, because its NG+ bonus attributes inflate the Shachi (rage) gauge cap.
  4. Purge list (purgeIds): Shachi-family accessories never stack and are not ghost-kept, preventing "inflated cap drains gauge".
  5. Currency/item delta multipliers: dust/coin/material income multiplied (income only, spending untouched).
  6. GE checkpoint: hooks the game's GameplayEffect application path; logs, captures, and optionally blocks (geBlock) effects by name.
  7. Spirit Shadow inversion (experimental): refunds Shadow resource on spend (active once its GE class is captured).
  8. Hot reload: the loader polls every second; code changes apply without restarting the game.

2. Requirements

  • Phantom Blade Zero (Steam build, verified Nov 2026)
  • PBZModLoader installed (ProjectPBZ/PBZModLoader, needs the in-game PuerTS runtime)
  • Install: unzip and drop the accessory-is-every-boys-best-friend folder into ProjectPBZ/PBZModLoader/mods/ — the loader auto-registers it on next game launch. No manual config needed. (To disable temporarily, add to mods.ini under [Mods]: accessory-is-every-boys-best-friend=0)

3. Configuration

Config file: ProjectPBZ/Saved/PbzAccessoryKeeper-probe.log/config.json (reloaded on every map transition). See the Chinese section above for the key list (layerMultiplier, layerCap, catRules, purgeIds, multipliers, shadowGain, geBlock, geRoute).

4. Known issues

  • Long-session Shachi cap creep: an NG+ Support accessory appears to carry an unbounded kill/hit-triggered Shachi-max stack that ignores our layer caps; a GE-level block is in progress.
  • Direct attribute writes do nothing (PuerTS returns struct copies); all writes now go through real GameplayEffects.
  • One unexplained game exit after 26 minutes (GE scanner was throttled/hardened; not reproduced).
  • The log file is overwritten every session.
  • Ultimate-charge x10, coin getter, and attribute-set enumeration are still unsolved.