PWProjection - 蓝图投影（Litematica风格）

PWProjection — Blueprint Projection for Palworld

将你的基地采集为蓝图，在任意存档中以半透明蓝色全息投影显示出来，然后一件一件重建 —— 你放下建筑的瞬间，每一件都会自动吸附到其全息投影位置，而已放置的部件会立即从全息投影中消失。

功能特性

• 采集 — 站在基地内按 Y；建筑将保存为纯 JSON 蓝图，可备份、编辑或分享。
• 投影 — 按 J 加载蓝图，按 K 放置 / 隐藏蓝色全息投影。
• 建造吸附 — 无需额外按键。正常放置建筑即可精确落在对应的全息投影位置（位置、旋转和高度）。
• 高度自适应 — 在水面或不平整地形上，投影会自动移动到游戏实际允许的高度，并按每个站点校准一次，因此地基可以叠加。
• 分层视图 — 按 L 逐层查看蓝图（方便处理室内和屋顶）。
• 已建造部件自动隐藏 — 你已经放置的部件会自动从全息投影中移除，拆除后会重新出现。
• 放置记忆 — 模组会按蓝图记住每个投影的放置位置及建造进度；在该站点附近重新打开蓝图即可从上次中断处继续。
• 游戏内设置页（可选）— 按键绑定、采集半径、微调步长、旋转步长和层间距可在 Esc → Mod Options 中修改（需 Mod Options Framework）。

前置要求

• UE4SS（RE-UE4SS / UE4SS Experimental）— 这是一个 Lua 脚本模组，没有它无法加载。
• Palworld 1.0.x（Steam）。多人模式未经测试。
• 可选：Mod Options Framework — 提供游戏内设置页。不安装的话，一切仍可通过 Scripts\pwpr_config.json 正常工作。

安装（手动）

1. 安装 UE4SS。
2. 将压缩包中的 PWProjection 文件夹解压到 <Palworld>\Mods\NativeMods\UE4SS\Mods\PWProjection — 该文件夹必须包含 Scripts\main.lua。
3. 将以下行添加到 <Palworld>\Mods\NativeMods\UE4SS\Mods\mods.txt → PWProjection : 1
4. 重启游戏，进入世界并按一次 N（能力探测 — 首次必须执行）。

创意工坊 / Vortex 用户： 订阅（或让 Vortex 安装），然后在游戏自带的 Mod Management 菜单中启用即可 — 无需手动复制文件。

按键

• 始终可用：N 探测 · Y 采集 · J 加载蓝图 · K 投影开/关 · L 分层。
• 默认未绑定（可在游戏内设置页绑定）：H 重新居中投影，U 切换放置站点，F9 方向键模式，F7 帮助/状态，F8 重载配置。
• 小键盘 8/2/4/6/9/3 微调，+/- 旋转，5 复位，0 更改步长 — 可选别名。

已知限制（设计如此）

• 建造时全息投影不会跟随你 — 它会停留在你放置的位置（按 H 将其重新居中到你脚下）。
• 拆除的部件会自动重新出现在全息投影中，但在某些情况下它们不会自动从建造进度记录中移除 — 重新打开投影以重新同步。
• 对于组装结构（发电机、生产机器），仅绘制主体。
• 用于整个基地的蓝图采集模式尚未完成；请使用普通采集。
• 多人模式未经测试。

故障排查

• 按键无反应 — 可能未绑定：在 Esc → Mod Options → PWProjection 中绑定（N 默认已绑定；H/U/F7/F9 未绑定）。重新绑定后保存一次，如果按键停止响应则重启游戏。
• 放置不吸附 — 检查 Scripts\pwpr.log 中的 [bsnap] 行；它们会说明原因（距离太远 / 类型不匹配 / 被游戏拒绝）。最常见原因：投影本身放置错误 ⇒ 按 H。
• 保存设置后投影消失 — 保存会重新加载模组；请再次按 J + K。该站点的建造进度会自动恢复。
• 完整诊断信息写入 Scripts\pwpr.log（每行都带有时间戳，中英文混合）。报告 bug 时请附上该文件。

已知问题

• 重新绑定按键后请勿连续保存。 每次保存都会重新加载此模组，而重新绑定可能导致设置框架进入重载循环（实测每轮约 0.44 秒），几十轮后可能导致游戏卡死。保存一次，等待其生效，再编辑下一项。未做更改时保存无害（不会触发重载）。如果卡死，结束进程并重新启动 — 你的配置、按键绑定和建造进度永远不会丢失。
• 要完全避免此问题，请将 "options_apply_mode": "game_restart" 添加到 Scripts\pwpr_config.json — 保存将不再重新加载模组，而是直接提示你重启游戏。
• 已观察到罕见的崩溃（转储文件写入 Mods\NativeMods\UE4SS\crash_*.dmp）。如果你遇到，请附上该转储文件以及 Scripts\pwpr.log 进行报告。

致谢

• UE4SS — 此模组运行的 Lua 运行时（未捆绑）。
• Mod Options Framework，作者 Elvlin（MIT）— 游戏内设置页；两个 SDK 文件根据其 MIT 许可证重新分发（见压缩包中的 third_party 文件夹）。
• 架构参考了 Simple Building Blueprints (SBB) — 仅作只读参考，未复用任何代码或字符串。

视频

• 演示（中文，哔哩哔哩）：【幻兽帕鲁】建筑投影模组（PWProjection）功能演示

源码与许可

• 作者：CitrusDR（哔哩哔哩：柑橘味快乐水）— 源码：github.com/CitrusDR/PWProjection
• 许可：MIT — 可自由使用、修改和再分发，保留署名即可。

---

PWProjection —— 建筑投影（Litematica 风格）中文说明

把基地采集成蓝图，在任何存档里以半透明蓝色全息投影显示出来，然后一件一件重建 —— 你放下建筑的那一刻，它会自动吸附到投影对应的位置；已经放好的那一件会立刻从投影里消失。

功能

• 采集 → 蓝图：站进基地按 Y，把建筑存成纯 JSON 蓝图，可备份、可编辑、可分享。
• 投影：按 J 加载蓝图，按 K 放下 / 收起蓝色投影。
• 建造吸附：不需要额外按键。正常放置就行，位置 / 朝向 / 高度都会对到投影上。
• 高度自适应：水面或特殊地形上，投影会自动挪到游戏允许的高度，并按"处"校准一次，所以叠在地基上的建筑也放得下去。
• 分层显示：按 L 一层一层看蓝图（做室内、屋顶很方便）。
• 已放好的不再画：已经建好的部分自动从投影里去掉；拆掉它会自动恢复显示。
• 位置与进度记忆：按蓝图记住"上次投影放在哪、已经建到哪"；在附近重新打开蓝图会自动接着上次的进度。
• 游戏内设置页（可选，需 Mod Options Framework）：改键、采集半径、微调步长、旋转步长、分层间距都能在 Esc → 模组选项 里改。

前置要求

• UE4SS（RE-UE4SS / UE4SS Experimental）—— 本模组是 Lua 脚本，没有它不会加载。
• 幻兽帕鲁 1.0.x（Steam 版）。联机未验证。
• 可选：Mod Options Framework —— 提供游戏内设置页；没装也能用，改 Scripts\pwpr_config.json 即可。

安装（手动）

1. 先装好 UE4SS。
2. 把压缩包里的 PWProjection 文件夹放到 <帕鲁目录>\Mods\NativeMods\UE4SS\Mods\PWProjection（里面要有 Scripts\main.lua）。
3. 在 <帕鲁目录>\Mods\NativeMods\UE4SS\Mods\mods.txt 里加一行：PWProjection : 1
4. 重启游戏 → 进世界 → 按一次 N（渲染能力探测，第一次必须跑）。

创意工坊 / Vortex 用户：订阅（或让 Vortex 装）之后，在游戏自带的模组管理里启用即可，不用手动拷文件。

按键

• 始终可用：N 探测 · Y 采集 · J 加载蓝图 · K 投影开/关 · L 分层。
• 默认不绑定（想用就在设置页里设）：H 重新定位到脚下 · U 换一处放置记录 · F9 方向键模式 · F7 帮助/状态 · F8 重载配置。
• 小键盘 8/2/4/6/9/3 微调、+/- 旋转、5 复位、0 换步长 —— 可选别名，没有小键盘也不影响。

已知限制（设计如此）

• 投影不会跟随玩家 —— 放在哪就在哪（按 H 重新定位到脚下）。
• 拼装类建筑（发电机、生产设备等）只画主体。
• blueprint 模式（整体基地一键采集）尚未完成，请用普通采集。
• 联机未验证（以单机为主）。
• 偶发崩溃仍在排查；遇到请带上 Mods\NativeMods\UE4SS\crash_*.dmp 与 Scripts\pwpr.log 反馈。

排错

• 按键没反应：可能没绑定（Esc → 模组选项 → PWProjection 里设；N 默认绑定，H/U/F7/F9 默认不绑）；改键后建议重启一次游戏。
• 吸附没生效：看 Scripts\pwpr.log 里 [bsnap] 那几行给的原因（太远 / 类型不匹配 / 游戏拒绝）；最常见是投影本身放歪了 ⇒ 按 H。
• 保存设置后投影没了：保存会重载本模组，重新按 J + K 即可；同一处的建造进度会自动接上。
• 完整日志在 Scripts\pwpr.log（每行带时间戳），反馈时请一并提供。

已知问题

• 改键之后不要快速连点"保存"：每次保存都会重载本模组，而改键这条路会让设置框架反复重载（实测约 0.44 秒一轮），几十轮后游戏可能卡死。改完点一次保存、等它生效再改下一项；不改内容时随便点（不会重载）。万一卡住：结束进程重开即可 —— 配置、键位、建造进度都不会丢。
• 想彻底避开：在 Scripts\pwpr_config.json 里加 "options_apply_mode": "game_restart" —— 保存不再重载，只提示"请重启游戏"。
• 偶发崩溃：如果游戏崩了，请把 Mods\NativeMods\UE4SS\crash_*.dmp 和 Scripts\pwpr.log 一起反馈，仍在排查。

致谢

• UE4SS —— 本模组运行的 Lua 运行时（未随包分发）。
• Mod Options Framework（作者 Elvlin，MIT）—— 提供游戏内设置页；按它的 MIT 许可，包内 third_party 文件夹里转发了两个 SDK 文件。
• 架构参考了 Simple Building Blueprints (SBB) —— 只读参考，没有复用任何代码或字符串。

视频演示

• bilibili：【幻兽帕鲁】建筑投影模组（PWProjection）功能演示

源码与许可

• 作者：CitrusDR（bilibili：柑橘味快乐水）— 源码：github.com/CitrusDR/PWProjection
• 许可：MIT —— 可自由使用、修改、转载，保留署名即可。