👋 入门指南
本教程将带你从零开始，使用 CraftEngine 为 Minecraft 服务器添加自定义物品、方块、家具和图片。每学完一章，你都能在游戏中看到自己的成果。
准备
开始前，请准备好：
- 一个运行 Minecraft 1.20+ 的 Paper 系服务端，并已安装 CraftEngine
- 一款支持 YAML 的文本编辑器
- （可选）用于制作模型的 Blockbench
如果尚未安装插件，请先阅读安装与托管。
学习路线
教程会在同一个 tutorial 包中逐步添加内容。建议按顺序阅读并动手操作：
- 安装与托管 —— 安装插件，配置资源包
- 认识项目 —— 目录结构、命名空间、reload
- 第一个物品 —— 从一行 YAML 开始
- 物品模型 —— 给物品换外观
- 第一个方块 —— 能放置的方块
- 第一件家具 —— 能坐的椅子
- 第一张图片 —— PNG 变图标
- 下一步 —— 掌握基础后继续深入
关键命令
教程中会反复用到以下命令：
| 情况 | 命令 |
|---|---|
修改 .yml 配置（物品、方块等） | /ce reload config |
| 修改合成配方 | /ce reload recipe |
| 修改工作流定义、触发条件或步骤 | /ce reload config |
| 修改包 ID 或托管设置 | /ce reload host |
| 修改模型或贴图文件 | /ce reload all |
| 执行指定资源包工作流 | /ce workflow [名称] |
config 只更新工作流定义，不执行工作流。all 还会执行由 reload_pack 触发的工作流，默认的 default 工作流会构建并发送资源包。如果使用其他工作流，请通过 /ce workflow [名称] 显式执行。各重载模式的区别见命令参考。
遇到问题时，请先检查控制台；CraftEngine 会在那里输出大多数错误信息。
准备好后，从安装与托管开始。