跳到主要内容

📦 安装与托管

把插件跑起来，让资源包能发给玩家。

要求​

  • Paper 系服务端，已验证以下：

Paper 及其下游：Paper、Purpur、Pufferfish、Leaf、Leaves、UniverseSpigot

Folia 及其下游：Folia、Canvas、Luminol

信息
  • Java： JDK 21 或更高
  • Minecraft： 1.20 或更高

获取插件​

安装​

把 .jar 放进 plugins/，启动服务器。首次启动会生成：

CraftEngine
generated
libs
resources
translations
commands.yml
config.yml

进游戏打 /ce，弹出物品浏览器说明安装成功。

⚠️ 没弹出来？看控制台有没有报错。最常见的原因：JDK 版本不够、用了非 Paper 分支（Spigot 不行）、Minecraft 版本太老。

资源包托管​

CraftEngine 把你 resources/ 下的内容生成成一个资源包，通过 HTTP 发给玩家。

现在先试试能不能用：进游戏打 /ce reload all。如果资源包下载成功、没有紫黑贴图——说明托管已经生效。这是因为默认配置就是 self 模式，服务器自带 HTTP 分发功能，不需要额外设置。

如果下载失败，看下一节。

默认：自托管​

# config.yml 默认配置，不需要改
resource-pack:
  delivery:
    hosting:
      - type: "self"
        ip: "auto"
        port: "auto"

type: "self" = 服务器自己开一个 HTTP 服务。ip: "auto" 和 port: "auto" = 自动检测地址和端口。大多数情况直接就能用。

换托管方式​

默认 self 不行的话，试试这些：

快速选型​

你在干嘛推荐
一个人开发测试Lobfile 或自托管
公开服务器S3（Cloudflare R2 免费）
在 Velocity / BungeeCord 上分发资源包None

⚠️ 改完 config.yml 的托管配置后，跑 /ce reload all。单跑 config 不会重建资源包。

⚠️ 需要 API 密钥的托管（如 S3），用环境变量传密钥，不要把密钥直接写在 config.yml 里。不要把含密钥的配置文件发给你不信任的人。

预期表现​

托管生效后，/ce reload all 应该：包重新生成 → 在线玩家弹出下载提示 → 接受后正常应用 → 没有紫黑方块。新玩家进服自动弹提示。