Skip to main content

👋 Getting Started

Build custom items, blocks, furniture, and images for your Minecraft server — step by step, with something to see in-game at the end of every chapter.

Prerequisites

  • A Paper-based Minecraft server (1.20+) with the CraftEngine plugin installed
  • A text editor that can edit YAML files
  • (Optional) BlockBench for making 3D models

If you haven't installed the plugin yet, start with Installation & Hosting.

What you'll build

Each chapter builds on the previous one using a single tutorial pack. Read in order and follow along:

  1. Installation & Hosting — get the plugin running, serve the pack
  2. Project Structure — folders, namespaces, and /ce reload
  3. Your First Item — start from a single YAML line
  4. Item Models — give your item a custom look
  5. Your First Block — a block you can place in the world
  6. Your First Furniture — a chair you can sit on
  7. Your First Image — turn a PNG into an in-game icon
  8. Next Steps — where to go from here

Key commands

You'll use these throughout the tutorial:

When you…Run
Edit .yml configs (items, blocks, etc.)/ce reload config
Edit recipes/ce reload recipe
Edit workflow definitions, triggers, or steps/ce reload config
Edit pack IDs or hosting settings/ce reload host
Edit models or textures/ce reload all
Run a specific resource pack workflow/ce workflow [name]

config updates workflow definitions without running them. all also runs workflows triggered by reload_pack; the default default workflow builds and sends the pack. If you use a different workflow, run it explicitly with /ce workflow [name]. See the command reference for each reload mode.

Stuck? Most errors are printed to the server console. Check there first.

Ready? Start with Installation & Hosting.