📚 模组开发概述¶

⛳ 放在前面¶

Pier 是一个 LeviLamina 模组加载器：装上它以后，你可以用 Rust、Go、Zig 或 C++ 给基岩版服务器写模组，不同语言写的模组之间还能互相调用。

这一部分按「你想做什么」来分页：事件、命令、玩家、实体、世界、物品……每一页挑出做这件事最常用的接口，配上 Rust、Go、Zig 的示例。每个绑定的全部接口在接口参考里，按绑定分开列出。开始看具体的任务之前，先花几分钟看完这一页，后面每一页都会用到这里说的约定。

三种语言的类型系统不一样。同一个概念在各语言里分别对应下面这些类型：

除了上面这些通用类型，Pier 还为游戏里的东西准备了对象类型：

每个接口都按同一个格式来写：

标题：这个接口做什么。
调用形式：三行，依次是 Rust、Go、Zig 的写法。player、entity 这类名字代表你手里的那个对象。
参数：每个参数的名字、类型和含义。标着「可选参数」的可以不传。
返回值 和 返回值类型：调用成功时你拿到什么。
对应槽位：这个接口在 abi.h 函数表里的名字。C++ 直接用它调用；Zig 用 levilamina.slot("名字") 拿到它； Go 用 levilamina.Raw 下的同名方法调用。所以某个接口在你用的语言里还没有封装时，照着槽位名也能调用它。
示例：三种语言各一段代码。

大部分接口只能在服务器主线程上调用。 事件回调、命令回调、生命周期函数本来就在主线程上运行，在它们里面直接调用就行。

在你自己开的线程里（或者 Go 的 goroutine 里），用计划任务把工作交回主线程。

调用失败时，你拿到的是一个错误，里面写着是哪一步、为什么。常见的有三种：

宿主没有这个功能：Pier 版本太旧，或者没编译这个能力包。Go 里是 *levilamina.NotProvidedError，Zig 里是 error.NotProvided。
宿主拒绝了：比如玩家不在线、坐标不合法。
宿主读不出来：比如读一个它不认识的属性。玩家等级真是 0 时你拿到 0；宿主读不出等级时，你拿到的是这个错误。