快速开始

安装

在你的电脑上，Crafting 只是官方启动器里多出的一个启动配置。在服务器上，它是一个带启动脚本的文件夹。你需要 Minecraft Java 26.3 和 Java 25（启动器已自带 Java；服务器上需要自行安装）。

构建 Crafting

目前还没有发布可下载的版本：需要从源码构建。

终端

git clone <crafting-repository> crafting && cd crafting
./gradlew :crafting-cli:installDist

可执行文件位于 crafting-cli/build/install/crafting/bin/crafting。把该文件夹加入 PATH；文档的其余部分直接称它为 crafting。

在你的电脑上

先用官方启动器打开一次 Minecraft 26.3，让它下载游戏。
运行安装程序：
终端
```
crafting install --mc 26.3
crafting install --mc 26.3 --dir "/path/to/.minecraft"   # 其他游戏文件夹
```
它会自动找到游戏文件夹：Windows（%APPDATA%\.minecraft）、macOS（~/Library/Application Support/minecraft）和 Linux（~/.minecraft）。如果你的在别处，使用 --dir。
启动器中会出现 Crafting 26.3 配置。选中它，开始游戏。

安装程序会把 Crafting 的库加入游戏文件夹，创建一个继承官方版本的 crafting-0.1.0-26.3 版本，添加启动配置（会先备份 launcher_profiles.json），并创建 mods/、plugins/ 和 config/ 文件夹。每次更新 Crafting 后都要重新运行它。

在服务器上

终端

crafting install --mc 26.3 --server ./server
cd server && cp ~/Downloads/server.jar . && ./start-crafting.sh

安装程序会把 Crafting 复制到 crafting/libs/，并创建 start-crafting.sh（Linux、macOS）和 start-crafting.bat（Windows）。把官方 26.3 的 server.jar 放进该文件夹，用脚本启动即可。只要服务器上只有插件，玩家就能用未安装模组的 Minecraft 加入；如果有添加方块或物品的模组，玩家需要安装 Crafting 和这些模组（见配置与网络）。

模组放在哪里

文件夹	放什么
`mods/`	CraftScript 模组（一个 `.craft` 文件，或包含 `main.craft` 的文件夹）和 `.jar` 模组。
`plugins/`	服务器插件。
`config/`	模组生成的设置（`<mod>.toml`）和权限（`config/crafting/permissions.json`）。

以 .disabled 结尾或以 . 开头的文件会被忽略：这样就能在不删除的情况下禁用模组。

模组界面

主菜单和暂停菜单中有一个模组按钮。它列出游戏中的所有模组及其版本、作者和描述，并告诉你每个模组是否完全正常、哪些功能被禁用，或者为什么无法加载。文字根据游戏语言显示为西班牙语或英语。/crafting mods 会在聊天栏或控制台中给出同样的列表。

启动选项

Java 属性	效果
`-Dcrafting.dev=true`	开发模式：脚本和插件保存后自动重新加载。
`-Dcrafting.profile=true`	从启动起统计每个模组在其事件中花费的时间。
`-Dcrafting.debug=true`	详细日志，包含完整的堆栈跟踪。