DarnUI - 开发资源

DarnUI — 开发资源

这是其他模组依赖的共享代码库，并非独立模组。 只有在你使用的模组将其列为前置需求时才需要安装。它没有任何可供游玩、配置或开启的内容。

DarnUI 是 Darn 系列模组构建游戏内界面的控件工具包——它从 DarnMenu 中分离出来，这样每个 Darn 模组都使用一份经过严格测试、崩溃验证的菜单代码，而不是自带各自的副本。它绘制的所有内容都基于游戏自身的蓝图构建，因此外观与原生界面一致。

我需要这个吗？

• 仅当某个模组需要它时。 如果你是因为 DarnMenu（或其他 Darn 模组）的要求而来到这里，安装即可——只需让它在文件夹中存在。
• 无需配置。 没有菜单、没有设置、没有游戏内开关。
• 仅需一份——整个系列共享同一个副本，这意味着对此处的任何修复都会立即改善所有基于它构建的模组。

模组作者——构建原生外观、崩溃安全的界面

DarnUI 是一个真正的工具包，并附有相应的文档。通过 vendor 目录下的 darn.lua 加载（一次调用即可处理 package.path 和 require），然后使用游戏自身的蓝图进行构建：

• UI.overlay —— 一个安全的注入宿主：它会找到一个菜单，将你的控件添加到 CanvasPanel，轮询该面板，分派点击事件，并集成所有崩溃安全规则（绝不修改原生布局，清理时折叠而非销毁，通过 alive-gated 和 pcall 保护）。
• UI.tilePopup —— 一个“点击 → 选择方块 → 选取”弹出窗口，处理了所有繁琐细节（打开时构建，绝不缓存空内容，点击路由）。
• 原生按钮、样式文本、编辑框、画布布局辅助工具、按键图标以及安全的属性读取。

文档随包附带：DarnUI_API.md（完整参考 + 安全契约）、DarnUI_TUTORIAL.md（10 分钟构建覆盖界面教程）和 DarnUI_overlay_example.lua（可直接复制粘贴）。如果 DarnUI 缺失，仅会影响你的功能——通过 pcall 调用 require 并使用你的默认值即可。

前置需求

• UE4SS（适用于《幻兽帕鲁》）

纯 Lua —— 无 DLL、无 PAK、无 Shell 调用。支持单人游戏和专用服务器（客户端侧，无头模式下自动禁用）。

安装

1. 首先安装适用于《幻兽帕鲁》的 UE4SS（如果尚未安装）。
2. 下载并将此压缩包解压到你的 UE4SS Mods 文件夹中 —— 通常路径为：
   steamapps\common\Palworld\Pal\Binaries\Win64\ue4ss\Mods
3. 确保 DarnUI 已启用（其自带一个 enabled.txt 标记文件）。启动游戏；需要它的模组会自动使用它。

AI 声明

坦诚说明：这些模组是与 AI 助手（Anthropic 的 Claude）协作构建的。我是一名软件工程师——设计和方向由我负责，我会以批判性的眼光审视代码功能、审查并在实际游戏中测试。AI 负责起草代码和大部分文本；这为我节省了大量时间，坦率地说，也使得创建这些模组变得可行。如果你不喜欢 AI 辅助创作的作品，请不要介意——你在订阅前有权知道这一点。