UniPal用户界面

统一Palworld模组用户界面

由 Michael "Spirit Shard" Stanich 创建并维护
Discord - 故障的聊天框 - https://discord.gg/h3vB7S4FEw
网站 - https://www.michaelpstanich.com/
v (捐赠支持！=^-^=) v
订阅之星（R18+ 警告！）- https://subscribestar.adult/michaelpstanich

UniPalUI 是什么？

统一Palworld模组用户界面（简称UniPalUI）是一款带有自定义输入处理程序和多项UI功能的模组菜单模组，其他模组可通过简单API和回调系统使用这些功能。UniPalUI让模组能轻松实现按键绑定和/或模组菜单，无需构建自己独特的系统或自行管理冲突。UniPalUI采用自定义UI和输入处理程序构建，因此可以与游戏并行运行，并拥有自己的模组注册系统。UniPalUI的系统设计高度灵活，将绝大部分逻辑交给模组开发者决定，这使得UniPalUI不仅适用于配置设置，还能设置与游戏玩法相关的菜单，如选项选择、为自由视角设置自定义控制、添加带有交互组件的游戏元素（如自定义制作台），以及模组开发者可能需要菜单的任何其他功能。

< - > 自我推广 < - >

UniPalUI的诞生是由The Broken Chatbox社区以及我在SubscribeStar上的支持者们共同决定的！虽然我不太清楚该如何接续这句话，但我想人们在推广自己的支持平台时都会这么说吧？总之，如果你喜欢我的作品并希望看到更多内容，同时也有机会为我未来的项目提供建议，可以考虑加入Discord或通过我的SubscribeStar订阅/捐赠！- https://subscribestar.adult/michaelpstanich（UniPalUI始终100%免费且永不设付费墙，但订阅者将在Discord获得专属身份组及其他项目相关福利！）如果经济上无法支持我的工作也没关系！无论是提供反馈和错误报告，还是仅仅发送一条友好的消息，任何形式的帮助我都心怀感激！

注意 - 开发中的模组

UniPalUI仍处于早期开发阶段，您可能会遇到问题或未定义行为！如果发现问题或有关于添加内容及改进UniPalUI的建议，请告知我；鉴于这是一个框架式模组，我需要了解其他模组制作者希望看到/使用的功能！（提交建议和报告错误的最佳地点是我们的Discord——The Broken Chatbox——https://discord.gg/h3vB7S4FEw）

已知关键问题

• 有时在游戏菜单间切换时，菜单可能会"卡住"且鼠标不可见，此时多次按ESC键可关闭UniPalUI的菜单弹窗，之后就能正常重新打开。
• 损坏的模组如果未能正确处理输入状态，可能会导致UniPalUI进入锁定状态。
  这并非UniPalUI本身的问题，但值得一提。
  UniPalUI具有极高的灵活性，这也意味着模组制作者需合理使用这些工具，以确保为用户提供良好的体验！

打开菜单并进行交互

打开/关闭菜单键位绑定：Shift+Y

当UniPalUI安装后，按住Shift键并按下Y（Shift+Y）即可打开UniPalUI的初始模组菜单选择界面。
随后，您可以通过鼠标操作与菜单交互（未来版本计划加入手柄和键盘导航作为可选功能）。
要关闭菜单，您可以使用"退出菜单"按钮或再次按下Shift+Y，即可返回游戏。
UniPalUI设计为在游戏过程中灵活使用，这意味着即使UniPalUI处于打开状态，您仍然可以移动、瞄准、射击和进行交互！

功能列表

自定义用户界面

UniPalUI 添加了其自行构建的用户界面，该界面大致遵循基础游戏的UI主题和色彩，同时保持自身独特的外观以便易于识别。此界面完全不依赖基础游戏资源，从而确保UniPalUI不受游戏版本影响。模组制作者可通过API使用一系列可用的菜单按钮选项来添加自己的菜单和功能。（未来版本将开发更多类型的选项框）

通知显示

UniPalUI的API中有一个选项可以在屏幕左上角显示通知。这不仅对模组制作者快速设置屏幕上显示的调试消息非常有用，还可以为玩家显示有用信息，例如显示事件的快速信息、显示当前交互信息，或者只是在启动时显示一个"已安装"消息，让用户知道你的模组运行正常！（Altermatic使用了这个功能！）

自定义输入处理器

UniPalUI拥有独立的自定义输入处理器，与游戏并行运行，为模组制作者提供最灵活的输入选项。模组开发者可通过API添加输入指令，并监听这些输入被按下/长按/释放时的回调（可配置延迟时间）。UniPalUI还会自动处理按键冲突，当检测到其他模组已占用某个键位时会反馈提示。（按键重绑定与更完善的冲突处理机制将在未来版本中实现）

模组开发者API与SDK

UniPalUI专为在虚幻引擎编辑器中使用而设计，并拥有自己公开可用的SDK。该SDK包含虚拟资产和一些示例，帮助模组制作者利用API创建他们精彩的菜单！不过，偏爱Lua的模组制作者仍可通过附带的Metadata.txt文档访问API，该文档列出了所有函数和功能。

独立系统

为确保UniPalUI与游戏版本兼容，UniPalUI内的所有系统均为完全自定义设计，重点确保更新时功能或特性不易被破坏。内部系统的设计还使得模组制作者无需更新SDK即可利用新功能，且旧版本（在合理范围内）应能在新版本上运行。

如何安装UniPalUI

1. 解压存档文件，并从您对应平台的文件夹中，将 'LogicMods' 文件夹复制到 "[Palworld安装目录]/Pal/Content/Paks"
2. 安装正确版本的UE4SS（适用于Palworld的最新更新版）- https://github.com/UE4SS-RE/RE-UE4SS
   • 确保在UE4SS安装目录内，打开"mods"文件夹中的"mod.txt"文件，确认"BPModLoaderMod"设置为1
   • 如果安装UE4SS后游戏开始崩溃，请打开UE4SS安装目录中的UE4SS-settings.ini文件，将"bUseObjectArrayCache"设置为false

给模组制作者的注意事项

UniPalUI功能相当强大且几乎没有内置限制措施。这使得UniPalUI使用起来略显复杂（类似于《上古卷轴》中的MCM模组配置菜单），但在系统使用方式上提供了极大的灵活性。这也意味着如果操作过于随意，你可能会"破坏"某些功能！请避免长时间停留在非预期的输入状态切换中，使用后务必退出输入状态来结束交互，游戏过程中若非必要尽量减少菜单弹窗出现频率，尽量将其限制在玩家主动触发的输入范围内，对于游戏过程中非时效性操作（如与静态物体交互或打开菜单），建议使用组合键（这也有助于防止按键冲突）。另外需要注意游戏内原有按键绑定，UniPalUI允许按键绑定与游戏内置键位重合（以备特殊使用场景），但这意味着你需要自行处理与游戏原生键位设置的冲突问题。

UniPalUI最初是为我自己的使用场景而创建的，旨在提供一个通用的UI解决方案，而不是为每个模组单独创建解决方案（如果不解决这个问题，很快就会变得非常麻烦）。作为一名模组开发者，UniPalUI使我的菜单和输入处理系统更加简洁明了，同时也加快了实现速度。如果你有兴趣在自己的模组中使用UniPalUI，请查看UniPalUI下载包中包含的"UniPalUI - Metadata.txt"，了解更多关于API功能的信息，并查看SDK以获取在Unreal Engine中使用蓝图工作的起点！（如果你在任何时候需要帮助，可以加入我们友好且乐于助人的Discord社区The Broken Chatbox - https://discord.gg/h3vB7S4FEw 提出你的任何问题！）

常见问题解答 (FAQ)

在撰写本文时，UniPalUI的SDK和正式发布版本尚未公开，因此我确实没有内容可以放入FAQ！如果您有任何问题，请考虑在我们的Discord频道"The Broken Chatbox"中提问 - https://discord.gg/h3vB7S4FEw，我们可能会找到一些内容添加到这里！

拥有超赞模组却需要菜单帮助？需要UniPalUI技术支持？随时联系我或加入我们的Discord社区！（https://discord.gg/h3vB7S4FEw）我们是个充满创意的社群，非常乐意提供帮助！