文档首页 / 运维 / 资源包 / 模型链路
Content Pipeline

资源包 / 模型链路

模型、纹理、资源包 ZIP 与在线下发流程。 — TreeCore / TreeMC 官方技术文档,面向 Minecraft 服务端运维与开发。

运维 6 分钟

资源包 / 模型链路

这条链路是 TreeCore 当前比较完整的一部分:

  • 模型上传
  • 纹理上传
  • 本地资源包 ZIP 上传
  • 重载资源包 SHA-1
  • 在线玩家远程下发资源包

模型与纹理

Web 面板中的 模型管理 当前支持:

  • 上传模型文件
  • 上传纹理文件
  • 查看模型列表
  • 删除模型

通常适合和资源包流程一起使用:

  1. 上传模型 / 纹理
  2. 处理资源包
  3. 下发给在线玩家

资源包页面当前流程

当前资源包页支持:

  • 拖拽上传本地 ZIP
  • 点击上传 ZIP
  • 重载资源包(刷新 SHA-1)
  • 远程下发在线玩家
  • 本地托管 / 外部 URL 并存配置
  • CraftEngine 同步桥

推荐流程

方式 A:使用本地 ZIP

  1. 打开 Web 面板 → 资源包
  2. 把本地 .zip 拖进上传区
  3. 点击 重载资源包
  4. 点击 远程下发在线玩家

方式 B:使用外部 URL

  1. 在配置里填写 resourcePackUrl
  2. 填写对应 resourcePackHash
  3. 在资源包页执行远程下发

关键配置

{
  "resourcePackUrl": "",
  "resourcePackHash": "",
  "forceResourcePack": false,
  "resourcePackPrompt": "",
  "useLocalResourcePack": false,
  "localResourcePackName": "pack.zip"
}

字段说明

  • resourcePackUrl:外部资源包地址
  • resourcePackHash:SHA-1 哈希
  • forceResourcePack:是否强制下载
  • resourcePackPrompt:客户端提示文本
  • useLocalResourcePack:是否启用本地托管
  • localResourcePackName:本地 ZIP 文件名

常见问题

上传 ZIP 后为什么玩家没收到?

因为上传只是把文件放到服务端,还需要继续:

  1. 重载资源包
  2. 下发给在线玩家

本地托管和外部 URL 能同时存在吗?

配置上可以共存,但实际使用时应明确当前要推送哪种来源,避免混淆。

资源包页面和模型页面是什么关系?

模型 / 纹理是资源内容来源,资源包页面是最终打包与下发入口。


相关页面