📦 Installation & Hosting

Get the plugin running so the resource pack can reach your players.

Requirements

CraftEngine runs on Paper-based servers. Verified and supported:

Paper forks — Paper, Purpur, Pufferfish, Leaf, Leaves, UniverseSpigot

Folia forks — Folia, Canvas, Luminol

info

• Java: JDK 21 or later
• Minecraft: 1.20 or later

Get the plugin

• Community Edition — Modrinth
• Premium Edition — VoxelShop, BuiltByBit

Install

Drop the .jar into plugins/ and start the server. First boot generates:

CraftEngine

generated

libs

resources

translations

commands.yml

config.yml

Run /ce in-game. The item browser opens — you're good.

⚠️ Nothing happened? Check the console. Common causes: wrong JDK version, not a Paper fork (Spigot won't work), Minecraft version too old.

Resource pack hosting

CraftEngine compiles your resources/ into a resource pack and serves it over HTTP to players.

Try it now: run /ce reload all in-game. If the pack downloads successfully with no purple-black textures, hosting is working. The default config uses self mode — the server includes a built-in HTTP server, no extra setup needed.

If the download fails, keep reading.

Default: self hosting

# config.yml — the default. You don't need to change anything.
resource-pack:
  delivery:
    hosting:
      - type: "self"
        ip: "auto"
        port: "auto"

type: "self" starts a built-in HTTP server on your Minecraft server. ip: "auto" and port: "auto" detect your address automatically. Works out of the box in most cases.

Alternative hosts

If self hosting doesn't work, try one of these:

📤 LobfileFree file host, zero setup

☁️ S3 / Object StorageCloudflare R2, Tencent COS, and more

🖥️ Self HostingFree, served from your own server

🔗 ExternalPoint at an existing pack URL

📋 OpenListServe via an OpenList instance

📁 OneDriveHost on OneDrive

🦊 GitlabUse a GitLab repository

📦 DropboxHost on Dropbox

🚫 NoneGenerate the zip, don't upload

Quick pick

Your situation	Recommendation
Solo development / testing	Lobfile or self hosting
Public server	S3 (Cloudflare R2 is free)
Distributing via Velocity / BungeeCord	None

⚠️ After changing the host config, run /ce reload all. config alone won't rebuild the pack.

⚠️ For hosts requiring API keys, pass secrets via environment variables — don't write them directly in config.yml. Never share a config file containing real keys.

Expected behavior

With hosting working, /ce reload all should: regenerate the pack → online players get a download prompt → they accept and it applies → no purple-black textures. Players receive the pack prompt automatically when they join.