
纹理包管理器
使用有序优先级、逐纹理回退和原生管理员菜单来管理兼容的纹理包模组。
查看大图Texture Pack Manager
从统一的 Hytale 原生菜单管理兼容的纹理包模组。启用你想要的包,安排它们的优先级,然后应用结果,无需手动合并纹理文件。
仅为管理器——不包含任何纹理包。
Texture Pack Manager 提供一个集中位置来启用、排序并应用兼容的纹理包模组。要更改纹理,请安装兼容的纹理包模组,或使用下方文档中提供的开发者 API 创建你自己的纹理包。
我为 Texture Pack Manager 制作的第一个纹理包即将推出。
服务器范围纹理
借助 Hytale 的服务器托管资源模型,此管理器当前的包选择是服务器范围的。服务器管理员选择激活的包及其优先级,该服务器上的所有玩家都会收到相同的最终纹理集。单个玩家目前无法通过此管理器选择自己独立的纹理包。
优先级如何工作
打开 /texturepacks,启用你的包,使用 Up / Down 对它们排序,然后选择 Apply / Reload。提供某纹理的最上方已启用包赢得该路径。较低的包填充缺失的纹理;未被覆盖的路径保留其捕获的原始内容。
例如,一个仅含草的包位于一个含草/泥土/石头的包之上时,由前者提供草,而较低的包提供泥土和石头。重新排列这两个包,共享的草纹理获胜者就会改变。模组专属的风格补丁也可以替换另一个已安装模组的现有纹理路径。

原生英文界面。展示开发者测试包以演示排序;这些诊断包不包含在此下载中。
特性
- 同时启用多个兼容的包,并使用 Up / Down 重新排序。
- 按纹理路径解决重叠,并在不再选择替换时恢复捕获的基线。
- 跨重启保存所需的激活/顺序;编辑设置后按 Apply。
- 为已连接的玩家提交原生资源重新加载。已测试代表性方块、工具、NPC、盔甲、水/岩浆及部分效果;某些使用方可能仍需要重新发送或重新加入。
- 通过提供的 Java API 从包模组自身的 JAR 注册纹理,保持 Hytale 的原生 Common 目录结构。
- 支持对现有模组拥有的 PNG 路径打补丁,需安装源内容模组。
- 为管理器 UI 选择 Auto / Deutsch / English,按玩家保存。


上方完整截图的细节裁剪,为便于阅读而放大。
安装与首次使用
- 将 texture-pack-manager-0.3.1.jar 安装到服务器的 mods/ 文件夹中。对于本地世界,请通过 Hytale 的模组/世界工作流安装并启用该插件。
- 安装专门为此 Manager API 构建的纹理包模组。它们自身所需的依赖也必须安装。普通资源包不会自动向管理器注册。
- 启动/重启服务器。通过你的权限系统授予管理员 vitja.texturepacks.admin。
- 运行 /texturepacks,启用已注册的包,选择其顺序,然后按 Apply / Reload。新的包 ID 初始为禁用状态;现有 ID 的已保存设置会保留。
在兼容的包注册之前,菜单可能为空。加入的玩家会收到服务器的有效原生资源;他们不需要服务器的 Java 插件 JAR。普通的浏览器下载不会自动安装缺失的依赖。
支持的清单范围: Hytale 0.7.x(>=0.7.0 <0.8.0)。已测试: Hytale 0.7.7。该管理器没有额外的第三方模组依赖。已测试专用服务器行为;本地世界安装路径仅为用户描述,并不声称有单独的单人启动验收测试。
命令
所有控制都需要 vitja.texturepacks.admin。
| 命令 | 操作 |
|---|---|
/texturepacks |
打开管理员菜单。 |
/tpm |
列出已注册的包 ID 和所需状态。 |
/tpm enable <id> / /tpm disable <id> |
保存激活更改。 |
/tpm raise <id> / /tpm lower <id> |
将包上移或下移一行。 |
/tpm apply |
应用已保存的选择/顺序。 |
/tpm reset |
禁用已注册的包并应用基线恢复。 |
菜单中的 Disable all (then Apply) 按钮保存禁用状态;之后选择 Apply。更新时保留管理器的数据目录;不要删除现有设置来替换 JAR。
面向纹理包作者
包模组提供 PNG 资源,并在设置期间注册一次,然后在关闭时注销。参考包插件不需要 tick 循环、轮询、私有网络或后台线程。包资源可以直接镜像 Common/…,在 API 中使用相对于 Common 的目标。
将 Vitja:TexturePackManager 声明为必需的运行时清单依赖,并使用 IncludesAssetPack: false,以便管理器控制选择。针对此管理器 JAR 编译,不要嵌入其 API/类。在 CurseForge 上,每个包发布文件还必须额外将 Manager 项目列为 Required Dependency;内容模组补丁还需要其目标模组。在承诺自动安装之前,请验证预期安装器的依赖行为。
完整的 Developer API Guide 和可构建的 Texture Pack Starter 可在下方链接的专用文档网站和公共示例仓库中获取。Starter 是一个单独的诊断示例;此 Manager 下载中不捆绑任何纹理包。
当前范围与限制
版本 0.3.1 是首个公共基础版本,带有实验性的原生定义适配器。PNG 覆盖针对现有已注册路径。选定的原生测试并不意味着每个视觉资源或多玩家设置都经过认证。
- 原始官方角色服装、头发和化妆品,以及所有音频替换,均不在预期包范围内。直接标识的化妆品 PNG 目标会被拒绝。盔甲仍在范围内。
- 未实现模型/动画文件、任意自定义着色器以及通用光照/相机编辑 API。
- 可选的原生 JSON 适配器替换整个定义,而非合并单个视觉字段。它们是实验性的,并非仅视觉的沙盒;请使用经过审查的兼容定义。
- 图像尺寸、UV、图集、alpha 模式和原生材质规则仍然重要。某些缩放的工具纹理被拒绝;请以原生尺寸为起点。
- 注册会验证所有已安装的包资源,并保留即使已禁用包的编码 PNG 字节。许多大型包会增加服务器启动/RAM;大型激活纹理会增加客户端/GPU/重建成本。不保证无限包或零成本。
- 捕获的基线可能包含来自另一个模组的先前覆盖。无关的实时资源写入者不会被集中协调。
- Apply 提交不是客户端渲染确认。一次只能运行一个 Apply;加入的玩家在 Apply 期间可能需要等待/重试。完整的并发多玩家和广泛渲染器认证仍待完成。
管理器不添加物品、可放置方块或配方,因此不需要自己的 Creative/工作台类别。
Developer API Guide 与示例
阅读完整的 API 指南 — API v1、原生 Common 路径、注册、支持的视觉内容、限制、优先级/回退以及 CurseForge 依赖。
- 下载示例源代码 ZIP 以构建并改编你自己的包。
- 下载编译好的 Starter 演示 以试用其三种原始诊断石头纹理。
- 打开仓库和 README 了解设置、Linux/macOS/Windows 构建命令以及明确的示例重用许可。
独立构建需要 JDK 25+、Python 3.9+、你的 HytaleServer.jar 以及单独的 Manager JAR。该演示不包含任何 Manager/SDK 类,也不添加任何玩法或后台任务。它在设置期间注册,并在关闭时注销。其诊断图像与我即将推出的完整纹理包相互独立。Manager 实现仍为专有。
反馈与建议
欢迎反馈、建议和错误报告!请在下方留言,或通过我的 CurseForge 个人资料给我发送私信。请包含你的 Hytale、管理器和包版本、确切的目标路径/包 ID、激活顺序以及复现步骤。
许可证与自定义版本
Copyright © 2026 Vitja. All rights reserved.
本模组为专有。其源代码不公开。未经我事先书面许可,不允许复制、修改、再分发或发布衍生版本,除非适用法律或平台条款另有允许。在适用平台条款下,允许下载和使用官方发布版本。
如需自定义版本或单独许可请求,请通过我的 CurseForge 个人资料或项目页面联系我。
支持我的模组
如果你喜欢我的模组并希望支持它们的持续开发和维护,可以留下捐赠。你的支持帮助我持续改进、更新和维护我的模组。谢谢!
正在加载版本记录…


正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。