地图获取指南

地图获取指南

Read-only map source chapters, nearby bells and acquisition markers, plus a searchable collection checklist. Chinese/English UI (0.4.1 preview). 地图来源章节、附近铃铛、获取标记与可搜索收集清单;只读游戏数据,不修改存档。

[size=5][b]地图获取指引 / Map Acquisition Guide[/b][/size]

[b]0.4.1 预览版 / Preview[/b]
PC Steam 只读地图指引与收集清单。核心地图交互已在开发中实机验证;0.4.1 自动语言选择与长英文布局已通过自动测试,仍待实机视觉验收。
Read-only map hints and a searchable collection checklist for PC Steam. The core map interactions were tested during development. Automatic language selection and long English text in 0.4.1 have automated tests and still need in-game visual verification.

[size=4][b]功能 / Features[/b][/size]
[list]
[]悬浮或点击原生地图点位,简短显示名称、来源地区章节及附近铃铛,详情按需展开。
Hover or click a native map point for its item name, source region chapter and nearby bell. Expand details only when needed.[/
]
[]原生地图点选不跳图、不移动视野;收集清单点选可定位已解锁地区的来源,未解锁地区保持当前地图。
Native map clicks keep your region and view. Checklist clicks locate a source on unlocked maps; locked regions remain closed.[/
]
[]青色来源标记在点空白处后保留,缩放时保持稳定。
Cyan source markers persist on empty-space clicks and stay stable while zooming.[/
]
[]支持名称、拼音、首字母、原生编号搜索,以及类别、地区、进度筛选与分页。
Search by name, pinyin, initials or native ID; filter by category, region and collection status.[/
]
[]跟随游戏文字语言:中文显示简体中文,英文及其他语言默认英文;读取失败默认英文。更改游戏语言后关闭并重开地图生效。
Chinese game text language uses Simplified Chinese Mod text; English and other languages use English. If detection fails, English is used. Close and reopen the map after changing the game language.[/
]
[]原生名称沿用游戏本地化;不使用社区攻略,不修改存档、背包、任务或成就。
Native item, region, bell and quest names keep the game's own localization. No community walkthrough is included. Saves, inventory, quests and achievements are not modified.[/
]
[/list]

[size=4][b]必需前置 / Requirements[/b][/size]
[list]
[]PC Steam 版游戏 / PC Steam version。[/]
[][url=https://github.com/PowerShell/PowerShell/releases]PowerShell 7[/url]。安装入口不使用 Windows PowerShell 5.1 / The installer does not use Windows PowerShell 5.1。[/]
[][url=https://github.com/KintaroModding/ue4ss/releases/tag/v3.0.1-1188-gf885e8d2]该游戏专用的 UE4SS v3.0.1-1188-gf885e8d2 / Game-specific UE4SS v3.0.1-1188-gf885e8d2[/url]。下载 [b]phantombladezero_ue4ss_v3.0.1-1188-gf885e8d2.zip[/b],不选 Source code。本 Mod 不捆绑加载器。
Download [b]phantombladezero_ue4ss_v3.0.1-1188-gf885e8d2.zip[/b], not Source code. Loader files are not bundled.[/
]
[/list]

[size=4][b]安装 / Installation[/b][/size]
[list=1]
[]退出游戏,通过 Steam“管理 → 浏览本地文件”找到实际游戏目录。
Exit the game. In Steam, use Manage → Browse local files to find the actual game folder.[/
]
[]将前置包中的 dwmapi.dll 与 ue4ss 目录放入 platform/steam/,与 PBZ.exe 同级。
Extract the prerequisite's [b]dwmapi.dll[/b] and [b]ue4ss[/b] folder into [b]platform/steam/[/b], next to the large PBZ.exe.[/
]
[]完整解压本 Mod 包,保持各文件相对位置,运行 INSTALL.cmd 自动定位 PowerShell 7 和 Steam 游戏目录。
Extract the entire Mod ZIP, keeping manifest.json, payload, tools and installers together. Run [b]INSTALL.cmd[/b]. It locates PowerShell 7 and the Steam installation.[/
]
[]正常通过 Steam 启动,进入存档后打开原生地图使用,无需额外游戏启动器或 pak 覆盖。
Launch normally through Steam, enter your save and open the native map. No separate game launcher or pak override is required.[/
]
[/list]

[code]PBZ/
platform/steam/
PBZ.exe                      游戏原有文件 / Original game
dwmapi.dll                    前置 / UE4SS prerequisite
ue4ss/
UE4SS.dll                  前置 / UE4SS prerequisite
Mods/
mods.txt                  启用行 / Mod enable line
PBZMapGuide/
Scripts/main.lua        正式入口 / Mod entry
Scripts/lib/            模块 / Mod modules
.pbz-map-guide-install.json
ProjectPBZ/Content/Paks/        不改写 / Original game data[/code]

手动指定实际游戏目录示例 / For a custom path:
[code]pwsh -NoProfile -File .\install.ps1 -GameRoot 'D:\SteamLibrary\steamapps\common\PBZ' -NoPause[/code]

[size=4][b]升级与卸载 / Upgrade and uninstall[/b][/size]
退出游戏后运行新版 INSTALL.cmd 升级。安装器按清单及哈希核验并备份。运行 UNINSTALL.cmd 卸载,仅移除匹配的自有文件和启用行,保留其他 Mod、偏好和共享 UE4SS;自行修改的脚本不会被直接删除。
Exit the game and run the new package's INSTALL.cmd to upgrade. The installer verifies ownership and hashes and backs up replaced files. Run UNINSTALL.cmd to remove hash-matching Mod files and its enable line; it preserves other Mods, user preferences and shared UE4SS files. Modified Mod scripts stop automatic removal.

独立核验 / Verify installation:
[code]pwsh -NoProfile -File .\install.ps1 -Action Verify -NoPause[/code]

[size=4][b]限制与兼容 / Limits and compatibility[/b][/size]
[list]
[]来源地区章节不等于最早可取章节;附近铃铛按直线距离选取,不代表可走路线。
Source region chapter is not a verified earliest obtainable chapter. Nearby bells use straight-line distance, not a verified walkable route.[/
]
[]清单包含 12 类、530 条地图记录,不等于唯一物品数或全游戏覆盖。物品获取与地点完成分别处理。
The catalog contains 530 map records across 12 categories. This is not a unique-item count or complete game coverage. Item acquisition and location completion are distinct.[/
]
[]完整前置、自动路线和面板拖动暂缓;未知条件保持待核实,不含独立地图预览。
Full prerequisites, automatic routes and panel dragging are deferred; unknown conditions remain unverified. The separate map preview is not included.[/
]
[]开发验证基线为上述 UE4SS 与 Steam Build 26266538;后续补丁需重新核验。手柄与真实 UAC 提权尚未完整验收。
Development baseline: Steam Build 26266538 with the UE4SS build linked above. Future game updates may require compatibility checks. Controller operation and actual UAC elevation are not fully verified.[/
]
[]截图展示开发中的中文核心界面,不代表 0.4.1 英文界面的实机验收。
Screenshots show the Chinese core interface from development, not visual acceptance of the 0.4.1 English interface.[/
]
[/list]

[size=4][b]源码与致谢 / Source and credits[/b][/size]
[url=https://github.com/boyl/phantom-blade-zero-map-guide]源码仓库 / GitHub repository[/url]。可读的 Lua 源码亦包含于 payload/PBZMapGuide/Scripts/lib/。
Mod 自有代码使用 MIT 许可证,拼音数据保留原版权声明。游戏与 UE4SS 权利归各自权利人。
Mod-owned code is MIT licensed. Pinyin search data derives from [url=https://github.com/mozillazg/pinyin-data/tree/v0.15.0]mozillazg/pinyin-data[/url] with its original MIT notice retained. Game and UE4SS rights belong to their respective owners.
开发使用了 AI 生成代码与发布文案 / AI-generated code and release text were used in development。