非官方的 rustc codegen 后端:把目标 crate 的 Rust 代码编译成原神千星奇域的节点图资产文件 .gia。
目前仅支持服务器节点图。
📖 完整文档:https://mzverse.github.io/rust2genshin/
Note
本文档正在迁往文档站。下面残留的章节(兼容性、关于节点图等)会逐步移走,迁移期间以文档站为准。
#[event_listener]
pub fn on_tab_selected(event: TabSelectedEvent) {
log(event.guid); // 打印Guid
event.entity.delete(); // 删除本实体
}#[unsafe(no_mangle)] // 导出此函数为复合节点
pub fn solve(a: f32, b: f32, c: f32) -> f32 {
(- b + delta(a, b, c).sqrt()) / (2. * a)
}
fn delta(a: f32, b: f32, c: f32) -> f32 {
b * b - 4. * a * c
}需要 rustup、cargo 和 protoc。nightly 工具链由 rust-toolchain.toml 钉死,rustup 首次运行时会连同三个组件一起装好。
git clone https://github.com/mzverse/rust2genshin
cd rust2genshin
cargo run -p build-demo --bin beyond-server产物是 target/genshin-unknown-beyond-server/release/rust2genshin_demo.gia。
节点图写在 demo/src/lib.rs(demo 只是示例目标 crate)。改包名、换成自己的 crate 等步骤见入门。
写法细节(导出、事件、内置事件清单)见文档站:
- 兼容性与限制 —— 运算溢出、整数除法、扁平化局部变量、内部可变性、可变借用
- 不被支持的特性 —— 整数/浮点宽度、
#[repr(u32)]、递归调用、dyn、Box的写 - 待办 —— 还没做的语言特性、类型、节点、事件
节点图的语义(数据流、循环、控制流、变量修改事件)是「为什么代码会编译成这样」的那一层,已迁入架构栏: