骑马与砍杀2 XML预览 - Gauntlet UI工具

骑马与砍杀2 XML预览 - Gauntlet UI工具

无需启动游戏即可预览和检查Bannerlord Gauntlet XML预制体。在独立的Windows工具中浏览控件树、编辑示例数据、测试分辨率并对比参考图像。

无需启动游戏即可预览《骑马与砍杀2:霸主》UI XML

正在制作菜单、面板或其他 Gauntlet UI?Bannerlord XML Preview 让你可以在独立的 Windows 应用程序中打开预制件、检查其控件树,并尝试不同的文本、列表项、状态和分辨率。

在你惯用的编辑器中编辑 XML,重新加载预览,在进入游戏验证结果之前排查布局或缺失资源的问题。

功能

  • 借助 CLI 渲染的预览图像和结构化诊断信息,与 AI 编码代理一起创建和完善 UI。
  • 从《霸主》或已安装的模组中打开 Gauntlet XML 预制件。
  • 检查控件树和诊断信息,以调查布局、资源、绑定和引用。
  • 直接从已安装的 TPAC 包中读取纹理,无需手动导出 DDS 文件。
  • 更改预览宽度和高度,以调查不同分辨率下的布局。
  • 通过绑定和模拟提供示例文本、值、可见性标志和列表项。
  • 保存包含你的数据、控件状态和分辨率的命名预览场景。
  • XML 更改后重新加载。如果加载失败,上一次成功的预览将保持可见,并明确标记为已过时。
  • 使用并排、叠加和差异视图将预览与参考图像进行比较。

系统要求

  • Windows x64。
  • 本地安装的《骑马与砍杀2:霸主》。游戏资源从你的安装目录加载,不包含在下载内容中。
  • 依赖框架的下载版本还需要 .NET 10 Desktop Runtime x64。选择自包含下载版本即可获得包含的运行时。
  • 要预览模组的 UI,你还需要安装该模组相关的预制件和资源。

安装与首次预览

  1. 下载自包含 ZIP,或者如果你已拥有所需运行时,选择较小的依赖框架 ZIP。
  2. 将整个 ZIP 解压到单独的文件夹并运行 Bannerlord.XmlPreview.exe。请保持包含的文件在一起。
  3. 在 Bannerlord 字段中选择你的游戏安装文件夹,然后单击 Apply。
  4. 单击 Open Prefab,从游戏或模组中选择一个 Gauntlet XML 预制件。
  5. 浏览控件树,检查诊断信息,并调整预览分辨率或示例数据。

作为第一个示例,请打开《霸主》安装目录中的 Modules\Native\GUI\Prefabs\Standard\Standard.Window.xml。

这是一个独立的创作工具。直接运行即可;它不需要启动器条目或加载顺序位置。请使用手动下载和解压。

填充屏幕

Gauntlet 预制件通常从游戏接收数据。使用绑定提供共享值,使用模拟向发现的模板列表添加条目。例如,用名称、排名和胜利次数填充排行榜,或用不同的按钮标签测试菜单。

创建或选择一个场景,编辑值,单击已编辑字段外部以应用,然后单击保存以保留你的设置。切换场景前请先保存。场景存储在 %LOCALAPPDATA%\Bannerlord.XmlPreview\Scenarios。示例数据仅影响预览,不会读取或更改你的存档。

在你常用的编辑器中编辑预制件 XML。已加载的依赖项会被监视更改;使用重新加载请求新的预览。

使用 AI 创建《霸主》UI

让你的 AI 编码代理能够看到它正在构建的 UI。描述你想要的屏幕,分享草图或参考图像,让代理编写 Gauntlet XML、渲染预览、检查图像并改进布局,而无需为每次修订启动《霸主》。

描述你的想法 → 生成 XML → 渲染预览 → 检查 → 完善

例如,要求一个带可滚动列表、详情面板和升级按钮的工坊管理屏幕。代理可以用示例数据填充它,检查长名称和空列表,渲染不同分辨率,并修正裁剪、间距或对齐问题。在其工作时查看图像并引导下一次修订:“把详情面板加宽”或“将升级费用移到按钮上方”。

两个下载包都包含 Bannerlord.XmlPreview.VisualRegression.Cli.exe、示例场景和用户指南。能够访问本地文件、Windows 终端和图像查看功能的代理可以使用 CLI 生成预览 PNG 并读取结构化诊断信息。选择包含运行时的下载版本即可开始,无需单独安装 .NET;不需要 SDK 或源代码构建。

开始使用:与你的 AI 代理一起创建 UI

该指南包含设置说明、捕获命令以及可复制到代理中的提示词。你的代理生成并修订代码;此工具提供视觉反馈。请在《霸主》中验证完成的屏幕、真实游戏数据和按钮操作。

当前限制

预览仅作为开发辅助工具。请务必在游戏中验证完成的 UI。

  • 不保证与《霸主》像素级一致。字体、布局、文本和值可能存在差异。
  • 模组特定的可执行代码控件显示为带标签的占位符。其代码不会被执行。
  • 肖像、旗帜、场景背景以及其他需要实时游戏状态的图像可能不可用。运行时图像需要显式的场景输入,且可能保持为部分状态。
  • 缺失的资源和引用会显示在诊断信息中。当预览不完整时,请检查你的安装路径和相关模组资源。
  • 成功的结构比较并不证明游戏内像素保真度。参考比较的默认值未经校准。

示例图像使用示例预览数据。游戏内参考可能具有不同的取景、分辨率和数据;它们展示的是当前结果,而非像素级完全匹配。

支持与源代码

源代码和文档 报告问题

请附上你的工具版本、游戏和模组版本、预制件路径、预览场景、诊断信息以及预期结果的描述或截图。分享文件或日志前请移除个人信息。

致谢与许可

作者 DasNeo。原始项目代码和文档在 MIT 许可证下提供。第三方组件以及游戏或模组内容保留其自身的权利和许可条款;请参阅包含的 LICENSE、THIRD-PARTY-NOTICES.md 和 licenses 文件夹。

TPAC 纹理读取器改编自 szszss/TpacTool 的工作。其他组件的致谢和声明随下载内容提供。Agriculture Estate 示例致谢 Agriculture Estate Updated,由 DasNeo (DasNeoxx) 维护,延续原模组,原模组致谢 LL Muse,由 kz14365 上传。

AI 披露

在 AI 编码工具的协助下开发。维护者对已发布的代码、测试和版本负责。