
骑马与砍杀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,你还需要安装该模组相关的预制件和资源。
安装与首次预览
- 下载自包含 ZIP,或者如果你已拥有所需运行时,选择较小的依赖框架 ZIP。
- 将整个 ZIP 解压到单独的文件夹并运行 Bannerlord.XmlPreview.exe。请保持包含的文件在一起。
- 在 Bannerlord 字段中选择你的游戏安装文件夹,然后单击 Apply。
- 单击 Open Prefab,从游戏或模组中选择一个 Gauntlet XML 预制件。
- 浏览控件树,检查诊断信息,并调整预览分辨率或示例数据。
作为第一个示例,请打开《霸主》安装目录中的 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 或源代码构建。
该指南包含设置说明、捕获命令以及可复制到代理中的提示词。你的代理生成并修订代码;此工具提供视觉反馈。请在《霸主》中验证完成的屏幕、真实游戏数据和按钮操作。
当前限制
预览仅作为开发辅助工具。请务必在游戏中验证完成的 UI。
- 不保证与《霸主》像素级一致。字体、布局、文本和值可能存在差异。
- 模组特定的可执行代码控件显示为带标签的占位符。其代码不会被执行。
- 肖像、旗帜、场景背景以及其他需要实时游戏状态的图像可能不可用。运行时图像需要显式的场景输入,且可能保持为部分状态。
- 缺失的资源和引用会显示在诊断信息中。当预览不完整时,请检查你的安装路径和相关模组资源。
- 成功的结构比较并不证明游戏内像素保真度。参考比较的默认值未经校准。
示例图像使用示例预览数据。游戏内参考可能具有不同的取景、分辨率和数据;它们展示的是当前结果,而非像素级完全匹配。
支持与源代码
请附上你的工具版本、游戏和模组版本、预制件路径、预览场景、诊断信息以及预期结果的描述或截图。分享文件或日志前请移除个人信息。
致谢与许可
作者 DasNeo。原始项目代码和文档在 MIT 许可证下提供。第三方组件以及游戏或模组内容保留其自身的权利和许可条款;请参阅包含的 LICENSE、THIRD-PARTY-NOTICES.md 和 licenses 文件夹。
TPAC 纹理读取器改编自 szszss/TpacTool 的工作。其他组件的致谢和声明随下载内容提供。Agriculture Estate 示例致谢 Agriculture Estate Updated,由 DasNeo (DasNeoxx) 维护,延续原模组,原模组致谢 LL Muse,由 kz14365 上传。
AI 披露
在 AI 编码工具的协助下开发。维护者对已发布的代码、测试和版本负责。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。