快速开始
什么是 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 中使用。 它还涵盖效果、属性与装备、护甲、武器与冷却、实体事件和自定义按键。
- 光影包
- 以数据形式提供的光影包,复制文件夹即可安装。见光影包。
下一步
- 在启动器或服务器上安装 Crafting。
- 编写你的第一个模组,无需打开游戏即可测试。
- 在模组变大之前,读一读组织模组。