PogMenu

[center][img]https://i.postimg.cc/63rsK1t5/04-Logo-tagline.png[/img][/center]

[center][size=4][color=#5edaff]用于 UE4SS 模组的游戏内配置查看器、配置编辑器和加载错误查看器[/color][/size][/center]

[line]

[img]https://i.postimg.cc/26QpYXrb/sec-01-what.png[/img]

PogMenu 在 Palworld 暂停（ESC）菜单中、“返回标题”按钮的正上方添加了两个按钮：

[list]
[][b]已加载模组状态[/b]：哪些 UE4SS 模组已启动、哪些记录了错误或警告、哪些已安装但未启动。[/]
[][b]模组设置[/b]：将所有模组的配置文件集中在一处，可直接在游戏内修改数字、ON/OFF 开关和按键。[/]
[/list]
再也不用 Alt+Tab 切出去读 UE4SS.log，也不用翻文件夹找对应的配置文件。它适用于[b]任何[/b] UE4SS 模组，因为它读取的是实际安装的内容，而不是按名称识别模组。

[center][img]https://i.postimg.cc/k4QrChqq/01-Pog-Menu-main.png[/img][/center]

[line]

[img]https://i.postimg.cc/4d6CGFs9/sec-02-status.png[/img]

[center][img]https://i.postimg.cc/FRytvnNz/02-Loaded-Mods-Status.png[/img][/center]

PogMenu 中所有地方的状态颜色含义相同：

[center][img]https://i.postimg.cc/Ss604tkn/legend-status.png[/img][/center]

[list]
[]一个带有四张卡片的[b]仪表盘[/b]：错误、警告、正常、未激活。[/]
[]一张有问题的模组表格，附有每个问题的第一条日志行。[/]
[]左侧列表中的每个模组都有自己的状态图标。点击模组即可查看其日志行。[b]仪表盘[/b]按钮（或再次点击该模组）可返回总览。[/]
[][b]复制所有问题[/b]会将模组的日志行复制到剪贴板，方便粘贴到错误报告中。[/]
[][b]在首个问题处打开日志[/b]会在对应行打开 UE4SS.log（如果有 Notepad++ 或 VS Code 则使用它们；否则在记事本中显示带上下文的日志摘录）。[/]
[]已安装但未启动的模组列在[b]未激活[/b]下。[/]
[/list]
[line]

[img]https://i.postimg.cc/B6TW3w4F/sec-03-settings.png[/img]

[center][img]https://i.postimg.cc/3RXMhbYd/05-Mods-Settings-Dashboard.png[/img][/center]

模组设置的第一页是仪表盘：有多少模组拥有可修改的配置、共有多少文件和值，以及是否有两个模组争用同一个按键。

[center][img]https://i.postimg.cc/MT7kwrqX/03-Mods-Settings.png[/img][/center]

[list]
[]数字项目带有[b]-[/b] / [b]+[/b] 按钮。[/]
[]开关设置带有真正的[b]ON / OFF 开关[/b]。[/]
[]按键（例如 [i]ToggleKey = F8[/i]）会在黄色小标签中显示当前按键，并带有[b]重新绑定[/b]按钮：点击它，按下新按键（F1-F12、A-Z 或 0-9）即可设置。按 ESC 或再次点击可取消。如果另一个模组已使用该按键，状态行中会显示b[/b]和该模组的名称。[/]
[]拥有多个配置文件的模组会以可折叠列表显示，一次只展开一个，因此你始终清楚自己在编辑哪个文件。只有一个文件的模组会直接打开。[/]
[]纯文本或过于复杂的值会显示在折叠的[b]只读值[/b]按钮下。[/]
[][b]打开配置[/b]会在记事本中打开该文件，[b]打开位置[/b]会在资源管理器中显示它。[/]
[]只有按下[b]保存[/b]时才会写入更改。[b]重置[/b]会丢弃更改。如果有未保存的更改时按 ESC，会显示更改列表，你可以选择[b]保存并关闭[/b]、[b]丢弃并关闭[/b]或[b]继续编辑[/b]。[/]
[]保存后，模组会被标记为[color=#ffc84d]需要重新启动[/color]：大多数模组只在游戏启动时读取一次配置。[/]
[/list]
[line]

[img]https://i.postimg.cc/PxWGHFTY/sec-04-safe.png[/img]

PogMenu 非常谨慎，因为它会改动他人的文件：
[list]
[]它[b]只修改配置文件单行上的值[/b]。注释、格式以及文件的其他部分保持原样。[/]
[]每次更改都会先检查。如果该行不再符合 PogMenu 的预期（例如文件已更改），则不会写入任何内容。[/]
[]在首次保存文件之前，它会在旁边创建一份名为[b]<file>.pogmenu.bak[/b]的副本。你自己的 .bak 文件永远不会被覆盖。[/]
[]在你按下保存之前不会写入任何内容。PogMenu 自行执行的只有读取操作。[/]
[]无网络访问、无遥测、不修改游戏文件。[/]
[/list]
[b]它在你的机器上运行的内容，且仅当你点击相应按钮时才会运行：[/b]
[list]
[]记事本（打开配置）、资源管理器（打开位置）、Notepad++ 或 VS Code（在问题处打开日志）。[/]
[]一个隐藏的 PowerShell 调用，用于将文本放入剪贴板（复制问题）。文本会通过 PogMenu 文件夹中名为 clipboard.tmp 的小文件传递。[/]
[/list]
PogMenu 在自己文件夹中创建的文件：[i]report.txt[/i]（扫描摘要）、[i]log_excerpt.txt[/i] 和 [i]clipboard.tmp[/i]（当你使用那些按钮时）。

[line]

[img]https://i.postimg.cc/PJTg5z5L/sec-05-install.png[/img]

[b]要求[/b]
[list]
[][url=https://github.com/UE4SS-RE/RE-UE4SS/releases]UE4SS[/url]：请使用[b]最新发布版[/b]。“实验性”构建不是必需的。[/]
[]已在 Palworld 1.10.x（Xbox / Game Pass 版本）上使用 UE4SS 3.0.1 测试。Steam 版本尚未测试；它应该也以相同方式工作，但我无法保证。[/]
[/list]
[b]安装[/b]
[list=1]
[]如果尚未安装，请安装最新版 UE4SS。[/]
[]解压缩归档，使 [b]PogMenu[/b] 文件夹最终位于你的 UE4SS [b]Mods[/b] 文件夹内（例如 [i]...\Pal\Binaries\WinGDK\ue4ss\Mods\PogMenu[/i]）。[/]
[]确认 [i]PogMenu\enabled.txt[/i] 存在（已包含）。[/]
[]启动游戏，按 ESC 打开暂停菜单，寻找[b]模组设置[/b]和[b]已加载模组状态[/b]。[/]
[/list]
[b]卸载[/b]
删除 PogMenu 文件夹。你修改过的配置文件会保留新值；如果希望恢复原始值，可从 .pogmenu.bak 副本还原。

[b]快捷键[/b]
[list]
[][b]CTRL+F9[/b]：再次扫描 Mods 文件夹（重建列表和 report.txt）。[/]
[][b]CTRL+SHIFT+R[/b]：重新加载 PogMenu 自身的窗口代码。适用于你编辑 PogMenu 文件的情况；不会影响其他模组。[/]
[/list]
[line]

[img]https://i.postimg.cc/WzTB161F/sec-06-notes.png[/img]

[list]
[]模组配置中的更改通常需要重启游戏后才会生效。PogMenu 无法替你重新加载其他模组：UE4SS 内置的热重载也会停止 C++ 模组，并可能导致游戏崩溃，因此 PogMenu 不使用它。[/]
[]仅纯值可编辑：true/false、数字和按键名称。文本和复杂表格以只读方式显示。Lua 配置从文件顶部读取（第一个函数之前），超过约 400 行的 JSON 文件会被跳过。[/]
[]重新绑定接受 F1-F12、A-Z 和 0-9。包含修饰键（ALT、CTRL、SHIFT、LeftAlt 等）的设置保留 < > 按钮。[/]
[]直接写在模组代码中的按键绑定无法从游戏中更改；PogMenu 只会列出它们并警告冲突。仅在开发者/调试模式下注册的按键不会被计为冲突。[/]
[]“已启动”和“问题”来自当前会话的 UE4SS.log。不记录任何日志的模组会显示为正常，即使它以其他方式行为异常；某些模组会记录看起来像警告的无害行。[/]
[]窗口复用了游戏自带的 Journals 窗口框架。在大版本游戏更新后，按钮可能不会出现，直到 PogMenu 更新为止。不会出问题，只是你看不到它们。[/]
[]界面目前为英文。[/]
[]与 Pocketpair 或 UE4SS 团队无关联。[/]
[/list]
[line]

[img]https://i.postimg.cc/5ybh2q2Q/sec-07-contact.png[/img]

PogMenu 已适用于任何 UE4SS 模组，但对你关心的模组还能做得更多。如果你希望你的模组（或你使用的模组）在此窗口中有宾至如归的体验，请联系我。这是可行的，我很乐意在你我沟通并商定细节后着手实现。

[b]如果你是模组作者[/b]
[list]
[]我可以[b]让 PogMenu 窗口适配你的模组[/b]：为每个设置提供你自己的描述、更友好的名称、合理的分组、值范围和步进大小，让玩家无需打开文件就能理解每个选项。[/]
[]我可以编写一份[b]完整的、分步的说明[/b]，说明需要在[i]你的[/i]模组中修改什么才能正确接入 PogMenu（添加什么、在哪里添加、如何测试），让你始终完全掌控自己的文件。[/]
[]我也欢迎[b]你对 PogMenu 本身的想法和请求[/b]。如果缺少对你的模组有用的东西，请告诉我，如果有实际需求，我们可以一起构建。[/]
[/list]
[b]如果你是玩家[/b]
[list]
[]如果你使用的模组有难以理解的设置，请告诉我是哪一个。在作者同意的情况下，其选项和配置的描述可以直接显示在模组设置窗口中。[/]
[]也欢迎对这两个页面的功能请求和想法。[/]
[/list]
[b]如何联系我：[/b]最快的方式是通过我的[url=https://discord.gg/EZmfp6AqnV][b]Discord[/b][/url]：加入、打个招呼，我们可以直接交流。你也可以在本页的评论或帖子中留言，或在此处 Nexus Mods 上给我发送私信。请说明你指的是哪个模组以及你希望看到什么，我们从那里开始。未经作者知情，不会向任何人的模组添加任何内容。

[b]错误报告[/b]
请附上你的 UE4SS.log 并说明你使用的游戏版本。[b]复制所有问题[/b]按钮对此很有帮助。

[b]致谢[/b]
[list]
[]UE4SS 团队，感谢 UE4SS。[/]
[]所有测试 PogMenu 并报告问题的人。[/]
[/list]
[center][i]本描述中的图片为带有示例模组名称的示意图。真实游戏内窗口请参阅画廊中的截图。[/i][/center]