Lightyear：Bevy 多人游戏网络库

快速开始

README 给出的起步方式非常直接。以 Bevy 0.20（要求 Rust 1.97.1 或更高版本）为例，在 Cargo.toml 中加入依赖：

[dependencies]
lightyear = "0.31"

随后可以按以下顺序上手：

• 先浏览仓库中的 examples，了解不同拓扑和功能的最小可运行样例；
• 跟着教程从头复刻 simple_box 示例，理解客户端与服务端的职责划分；
• 遇到细节问题时查阅仍在完善中的官方 book。

需要注意，具体 API 能力与兼容的版本组合应以官方文档为准，README 中的版本号会随迭代变化。

仓库结构

Lightyear 采用 Cargo workspace 组织代码，各 crate 的源码位于 crates/ 下并按职责分组；目录名省略了 lightyear_ 前缀，但 Cargo 包名保留该前缀。README 列出的分组如下：

• crates/io：底层 IO 链路与后端，包括 aeronet、link、udp、crossbeam、websocket、webtransport；
• crates/connection：连接抽象与适配层，如 connection、raw_connection、netcode、steam；
• crates/core：顶层 lightyear crate，以及共享核心、同步、工具与帧插值相关 crate；
• crates/inputs：输入相关 crate，如 inputs、inputs_native、input_bei、inputs_leafwing；
• crates/replication：复制、预测与插值相关 crate；
• crates/transport：序列化、传输与消息相关 crate；
• crates/integration：Bevy 生态集成，例如 Avian；
• crates/platform、crates/deterministic、crates/tools、crates/tests：平台支持、确定性复制、工具与测试辅助。

这种拆分方式让使用者既可以直接依赖顶层的 lightyear，也可以在需要时只挑选某个子模块。

相关项目与游戏

README 提到了若干周边与使用案例，可作为参考：

• lightyear-template：一个带主观取舍的 Bevy + Lightyear 起步模板；
• Lumina：使用该库的游戏项目；
• cycles.io：为 Bevy Jam 5 制作，可在线试玩。

Bevy 版本兼容

README 提供了一张对照表，说明 Lightyear 各版本对应的 Bevy 版本：

升级 Bevy 版本时，应同步选择对应的 Lightyear 版本，避免 API 不匹配。

学习建议

Lightyear 涉及网络同步中的多个高门槛概念：服务器权威模型、客户端预测与回滚、快照插值与延迟补偿。建议按如下路径推进：

• 先用 simple_box 级别的示例跑通「连接—输入—复制」的最小闭环；
• 再分别打开预测、插值、带宽管理等开关，观察行为差异；
• 最后根据游戏类型（例如 FPS 更依赖延迟补偿）选择需要的特性组合，而不是一次性全部启用。

由于配套书籍仍在编写中，遇到不确定的行为时，直接阅读示例代码与官方文档通常比猜测更可靠。