快速开始

什么是 Crafting

Crafting 是面向 Minecraft Java 26.3 的模组平台。你可以用它自己的语言 CraftScript,或者用 Kotlin(以及 Java)编写模组,调用的 API 不依赖游戏代码。

核心理念

Crafting 模组从不直接调用 Minecraft,而是调用 Crafting:“把这个物品给玩家”“有人破坏方块时通知我”“创建一个硬度为这么多的方块”。Crafting 知道在当前运行的游戏版本中如何完成每一件事。

Minecraft 推出新版本时,需要更新的是 Crafting。你的模组还是同一个文件,照样正常运行。这一承诺的具体规则见你的模组不会坏。

两种语言,一套 API

适用场景
CraftScript 不懂 Java 也能上手,适合大多数模组:内容、事件、命令、游戏逻辑。纯文本的 .craft 文件,保存即重新加载。模组变大时,有类型、类和模块可用。指南
Kotlin 大型模组,享受静态类型和完整的 IDE;或者需要只有这里才有的功能:后台任务和 Java 库。Java 使用同一套 API。指南

两者可以在同一个游戏中并行运行。你可以先用 CraftScript 起步,只把需要的部分迁移到 Kotlin。

现有功能

版本
0.1.0,开发中。从源码构建。
游戏
Minecraft Java 26.3,客户端与专用服务器。
API
物品、带一个或多个战利品掉落的方块、配方、所有服务器事件、玩家、方块与实体、命令与权限、计时器、任意形状的方块、拥有自己行为和 3D 模型的自定义生物(可自然生成,能被驯服、繁殖和骑乘,会飞、会射击,并使用关键帧动画)、会在世界中生成的矿石、自定义声音与粒子、表单与屏幕元素、世界、玩家、存档数据、基于文件的设置,以及客户端与服务器之间的网络通信。全部都能在 CraftScript 和 Kotlin 中使用。 它还涵盖效果、属性与装备、护甲、武器与冷却、实体事件和自定义按键。
光影包
以数据形式提供的光影包,复制文件夹即可安装。见光影包。

下一步

  1. 在启动器或服务器上安装 Crafting。
  2. 编写你的第一个模组,无需打开游戏即可测试。
  3. 在模组变大之前,读一读组织模组。