levilamina-rs用 Rust 编写 LeviLamina 模组

安全的句柄模型 · 完整的 API 参考 · 服务端与客户端双目标

快速开始 →

API 参考

高级开发

🚀 初级开发

装加载器、写出第一个模组、事件 / 命令 / 世界 / 调度四大主题。全部示例可直接复制编译。

📖 API 参考

按代码里的 pub fn 逐条对齐 —— 列出来的都能编译，能编译的都列出来了。

🔬 高级开发

四层架构、ABI 契约与演进规则、内存安全与句柄设计、扩展桥接的完整流程、设计取舍记录。

句柄不会悬垂

Player 是选择器，Actor 是 id，Block 是坐标 —— 每次调用现解析。目标没了返回 Err，不是崩服。

诚实的线程模型

所有回调在游戏线程，唯一例外是包拦截器，而它的签名会逼你做对。schedule 是后台线程回来的唯一通道。

跨模组通信

总线负责广播「发生了什么」，服务注册负责回答「一个问题」。句柄由加载器持有，卸载模组不会留下野指针。

这一版文档修了什么

上一版列的是「目标设计」，里面有相当一部分方法从来没有实现过 —— player.connection_request()、player.start_using_item()、player.current_active_shield() 之类，照着写会直接编译不过。Ability 那张索引表也是错的（AttackMobs 和 AttackPlayers 反了，VerticalFlySpeed 写成 15 实际是 19），而 FFI 边界上是个裸 f64，设错槽不会报错，只是不生效。

这一版按代码逐条核对重写，并补上了此前完全没有文档的几块：

自定义维度 —— 注册新维度、地皮世界生成器、按维度的行为规则（gamerule 做不到的那种）
跨模组总线与服务注册
模拟玩家 —— carpet 风格的假人
客户端 API —— 本地玩家、按键绑定

常见的第一个问题

拿到 Player 之后怎么读位置和血量？

它们在 Actor 那一层（原生继承链 Player : Mob : Actor），转过去：

rust

let actor = player.get_actor()?;
let (x, y, z) = actor.pos()?;
let hp = actor.health()?;

Actor 是 Entity 的别名，同一个类型两个名字 —— 原生叫 Actor，本 crate 早期叫 Entity。详见 Actor / Entity。