From e3701326d2ff05499a1420d084fc5a9a82ea825d Mon Sep 17 00:00:00 2001 From: TrialDragon Date: Thu, 25 Sep 2025 17:09:47 -0700 Subject: [PATCH 1/2] Add warning about examples issue to quick start guide --- content/learn/quick-start/getting-started/_index.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/content/learn/quick-start/getting-started/_index.md b/content/learn/quick-start/getting-started/_index.md index 402b1d01b7..7b89349ed1 100644 --- a/content/learn/quick-start/getting-started/_index.md +++ b/content/learn/quick-start/getting-started/_index.md @@ -49,6 +49,14 @@ You can also speed up compile times by following the ["fast compiles"] section. cargo run --example breakout ``` +{% callout(type="warning") %} +Since Rust `1.89+` and when you use Bevy `0.16.x` and earlier versions the examples will not run and instead error. For more info on *why* see the issue: [bevyengine/bevy#20475 "0.16 fails to build breakout example due to bevy_mikktspace not compiling on Rust 1.89"]() + +Some workarounds: +- Use Rust 1.88 or earlier using this command: `rustup default 1.88.0` +- Use Rust 1.88 *only* in your Bevy Engine directory using this command: `rustup override set 1.88` (See https://rust-lang.github.io/rustup/overrides.html#directory-overrides for more on this) +{% end %} + ### Add Bevy as a Dependency Bevy is [available as a library on crates.io](https://crates.io/crates/bevy). From 496b2f2270702c5006cbdc448470901dd9738547 Mon Sep 17 00:00:00 2001 From: TrialDragon <31419708+TrialDragon@users.noreply.github.com> Date: Thu, 25 Sep 2025 17:19:16 -0700 Subject: [PATCH 2/2] Update content/learn/quick-start/getting-started/_index.md --- content/learn/quick-start/getting-started/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/learn/quick-start/getting-started/_index.md b/content/learn/quick-start/getting-started/_index.md index 7b89349ed1..efadbd23de 100644 --- a/content/learn/quick-start/getting-started/_index.md +++ b/content/learn/quick-start/getting-started/_index.md @@ -50,7 +50,7 @@ You can also speed up compile times by following the ["fast compiles"] section. ``` {% callout(type="warning") %} -Since Rust `1.89+` and when you use Bevy `0.16.x` and earlier versions the examples will not run and instead error. For more info on *why* see the issue: [bevyengine/bevy#20475 "0.16 fails to build breakout example due to bevy_mikktspace not compiling on Rust 1.89"]() +When using Rust `1.89+` and Bevy `0.16.x or earlier` the examples will not run and instead error. For more info on *why* see the issue: [bevyengine/bevy#20475 "0.16 fails to build breakout example due to bevy_mikktspace not compiling on Rust 1.89"]() Some workarounds: - Use Rust 1.88 or earlier using this command: `rustup default 1.88.0`