Skip to main content

đŸ“Ļ 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​

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.

Resource pack hosting​

CraftEngine builds a resource pack from your content and provides it for players to download. The default configuration uses the built-in HTTP server (self).

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.

For configuration, see Resource Pack Hosting. Build and upload steps are explained in Workflows.

Alternative hosts​

If the default configuration cannot deliver the resource pack, or you want to try another method, consider one of the hosting options below. To understand what went wrong with self hosting, see the Self Hosting page for the detailed configuration guide.

After changing resource-pack.packs or resource-pack.self-host, run /ce reload host to update hosting settings. To also rebuild the pack, use /ce reload all with the default workflow, or run your build workflow with /ce workflow [name].

⚠ī¸ 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.