非官方 Bevy 作弊书00-01

为向官方 Bevy 项目做出贡献而创建的 GitHub Forks 和 Pull 请求具有以下许可例外：只要工作等待上游审核（Pull 请求打开），即可免除 CC BY-NC-SA 4.0 的归属要求）。如果上游拒绝您的贡献，您将有 1 个月的时间来遵守 CC BY-NC-SA 4.0 许可证的完整条款或删除您的作品。如果上游接受您的贡献，则适用 MIT-0 许可证。

贡献

本书的开发托管在GitHub上。

请向 GitHub 提交问题以获取任何错误/令人困惑/误导性的信息，以及您想要添加到书中的新内容的建议。

贡献被接受，但有一些限制。

有关所有详细信息，请参阅贡献部分。

稳定性警告

Bevy 仍然是一个新的实验性游戏引擎！2020年8月才公开！

虽然改进正在以令人难以置信的速度发生，而且开发也很活跃，但 Bevy 还没有时间成熟。

没有稳定性保证，并且经常发生重大变化！

通常，适应新版本的变化并不难，但您已被警告！

Chapter Overview - Unofficial Bevy Cheat Book

章节概述

Bevy内置页面是一份简洁的备忘单，其中包含有关 Bevy 提供的类型和功能的有用信息。

Bevy教程章节提供了您可以从头到尾遵循的教程/指南。

Bevy Cookbook提供更多独立/范围狭窄的示例，教您如何解决特定问题。

本书的其余部分旨在作为参考，涵盖与 Bevy 合作的不同方面。请随意浏览本书，了解您感兴趣的任何主题。在本书的每一页上，每当提到其他主题时，都会链接到相关页面或官方 API 文档。

如果您想要引导式体验，或按相对难度（从初级到高级）浏览本书，请尝试引导式教程页面。它以逻辑顺序推荐学习主题。

本书有以下一般章节：

Bevy 设置提示：项目设置建议、工具和插件推荐
常见陷阱：社区遇到的常见问题的解决方案
Bevy on Different Platforms：有关使用特定平台/操作系统的信息

要了解如何在 Bevy 中编程，请参阅以下章节：

Bevy核心编程框架：ECS+App框架，一切的基础
编程模式：固执己见的建议、模式、习语
Bevy Render (GPU) Framework：使用 GPU 和 Bevy 渲染

以下章节涵盖了 Bevy 的各个功能领域：

List of Bevy Builtins - Unofficial Bevy Cheat Book

非官方 Bevy 作弊书

Bevy 内置列表

此页面是 Bevy 提供的所有重要内容的快速浓缩列表。

系统参数

这些都是可以用作系统参数的特殊类型。

（API文档中列出）

在常规系统中：

Commands ：使用命令操作ECS
Query<T, F = ()>（最多可包含 15 种类型的元组）：访问实体和组件
Res<T>：对资源的共享访问
ResMut<T>：对资源的独占（可变）访问
Option<Res<T>>：共享访问可能不存在的资源
Option<ResMut<T>>：对可能不存在的资源的独占（可变）访问
Local<T>：系统本地数据
EventReader<T>：接收事件
EventWriter<T>：发送事件
&World：只读直接访问ECS World
ParamSet<...>（最多 8 个参数）：解决不兼容的系统参数之间的冲突
Deferred<T>：自定义“延迟突变”，类似于Commands，但用于你自己的东西
RemovedComponents<T>：去除检测
Gizmos：一种在屏幕上绘制线条和形状以用于调试和开发目的的方法
Diagnostics：一种向 Bevy报告测量/调试数据以进行跟踪和可视化的方法
SystemName：系统的名称（字符串），可能对调试有用
ParallelCommandsCommands：当您自己进行并行处理时可以使用抽象
WorldId：系统运行所在世界的世界ID
ComponentIdFor<T>：获取给ComponentId定组件类型的
Entities：低级 ECS 元数据：所有实体
Components：低级 ECS 元数据：所有组件
Bundles：低级 ECS 元数据：所有捆绑包
Archetypes：低级 ECS 元数据：所有原型
SystemChangeTick：低级 ECS 元数据：用于更改检测的勾选
NonSend<T>：对非Send（仅限主线程）数据的共享访问
NonSendMut<T>：对非Send（仅限主线程）数据的独占访问
Option<NonSend<T>>：共享访问可能不存在的非（仅限主线程）数据Send
Option<NonSendMut<T>>：独占访问可能不存在的非（仅限主线程）数据Send
StaticSystemParam：通用系统抽象的帮助器，以避免生命周期注释
包含任何这些类型的元组，最多 16 个成员

在专有系统中：

&mut World：完全直接访问ECS世界
Local<T>：系统本地数据
SystemState<P>：模拟常规系统，让您轻松访问世界数据。 P是系统参数。
QueryState<Q, F = ()>：允许您对世界执行查询，类似于Query 常规系统。

您的函数最多可以有 16 个参数。如果您需要更多，请将它们分组到元组中以解决限制。元组最多可以包含 16 个成员，但可以无限嵌套。

在提取计划期间运行的系统还可以使用 Extract<T>, 来访问来自主世界而不是渲染世界的数据。T可以是任何只读系统参数类型。

资产

（有关使用资产的更多信息）

这些是 Bevy 默认注册的资产类型。

Image：像素数据，用作2D和3D渲染的纹理；还包含SamplerDescriptor纹理过滤设置
TextureAtlas：2D“Sprite Sheet”定义单个较大图像中的子图像
Mesh：3D 网格（几何数据），包含顶点属性（如位置、UV、法线）
Shader：GPU 着色器代码，采用受支持的语言之一 (WGSL/SPIR-V/GLSL)
ColorMaterial：基本“2D 材质”：包含颜色，可选图像
StandardMaterial：支持基于物理的渲染的“3D 材质”
AnimationClip：单个动画序列的数据，可与AnimationPlayer
Font：用于文本渲染的字体数据
Scene：由要实例化的文字 ECS 实体组成的场景
DynamicScene：由动态类型和反射组成的场景
Gltf: GLTF Master Asset : GLTF 文件全部内容的索引
GltfNode：场景中的逻辑 GLTF 对象
GltfMesh：逻辑GLTF 3D模型，由多个GltfPrimitives组成
GltfPrimitive：要渲染的单个单元，包含要使用的网格和材质
AudioSource：音频数据bevy_audio
FontAtlasSet:(内部用于文本渲染)
SkinnedMeshInverseBindposes：（骨骼动画内部使用）

文件格式

这些是 Bevy 支持的资产文件格式（资产加载器）。可以使用货物功能 cargo features可以使用货物功能启用/禁用对每一项的支持。有些是默认启用的，有些则不是。

图像格式（作为资产加载Image）：

格式	Cargo特征	默认？	文件扩展名
PNG	`"png"`	是的	`.png`
HDR 高动态范围	`"hdr"`	是的	`.hdr`
KTX2	`"ktx2"`	是的	`.ktx2`
KTX2+zstd	`"ktx2", "zstd"`	是的	`.ktx2`
JPEG	`"jpeg"`	不	`.jpg`,`.jpeg`
WebP	`"webp"`	不	`.webp`
OpenEXR	`"exr"`	不	`.exr`
TGA	`"tga"`	不	`.tga`
PNM	`"pnm"`	不	`.pam`, `.pbm`, `.pgm`,`.ppm`
BMP	`"bmp"`	不	`.bmp`
DDS	`"dds"`	不	`.dds`
KTX2+zlib	`"ktx2", "zlib"`	不	`.ktx2`
Basis	`"basis-universal"`	不	`.basis`