Skip to content

Conversation

@cart
Copy link
Member

@cart cart commented Jan 9, 2026

Objective

#20838 introduced an EarthlikeAtmosphere resource, which has a pre-prepared scattering medium resource for earthlike atmospheres.

This means that every deployed Bevy app (even apps that don't need an atmosphere, or don't need the default earthlike atmosphere) will initialize the earthlike scattering medium (which processes the asset and writes data to the gpu).

This is not desirable. The UX benefits for atmosphere initializers are not worth the price being paid:

// EarthlikeAtmosphere resource
fn setup(mut commands: Commands, earth_atmosphere: Res<EarthlikeAtmosphere>) {
    commands.spawn((
        Camera3d::default(),
        earth_atmosphere.get(),
    ));
}

// Manual initialization
fn setup(mut commands: Commands, mut scattering_mediums: ResMut<Assets<ScatteringMedium>>,) {
    commands.spawn((
        Camera3d::default(),
        Atmosphere::earthlike(scattering_mediums.add(ScatteringMedium::default())),
    ));
}

The manual approach also puts the Atmosphere component symbol back at the forefront and helps instruct developers on how this all actually works.

Solution

Remove the EarthlikeAtmosphere resource and add a default ScatteringMedium impl to make init slightly easier.

As this feature will be introduced in 0.18, to avoid breaking people down the road we should land this PR in 0.18 as well.

@cart cart added this to the 0.18 milestone Jan 9, 2026
@cart cart requested a review from ecoskey January 9, 2026 22:27
@cart cart added A-Rendering Drawing game state to the screen C-Performance A change motivated by improving speed, memory usage or compile times C-Usability A targeted quality-of-life change that makes Bevy easier to use labels Jan 9, 2026
Copy link
Contributor

@kfc35 kfc35 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

logic lgtm

@hukasu hukasu added S-Ready-For-Final-Review This PR has been approved by the community. It's ready for a maintainer to consider merging it S-Needs-Review Needs reviewer attention (from anyone!) to move forward and removed S-Ready-For-Final-Review This PR has been approved by the community. It's ready for a maintainer to consider merging it labels Jan 9, 2026
Copy link
Contributor

@mate-h mate-h left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me, thanks for the cleanup!

@ecoskey ecoskey added S-Ready-For-Final-Review This PR has been approved by the community. It's ready for a maintainer to consider merging it and removed S-Needs-Review Needs reviewer attention (from anyone!) to move forward labels Jan 9, 2026
@alice-i-cecile alice-i-cecile added this pull request to the merge queue Jan 9, 2026
Merged via the queue into bevyengine:main with commit 4b6a098 Jan 9, 2026
44 checks passed
@github-project-automation github-project-automation bot moved this to Done in Rendering Jan 9, 2026
cart added a commit that referenced this pull request Jan 10, 2026
# Objective

#20838 introduced an `EarthlikeAtmosphere` resource, which has a
pre-prepared scattering medium resource for earthlike atmospheres.

This means that every deployed Bevy app (even apps that don't need an
atmosphere, or don't need the default earthlike atmosphere) will
initialize the earthlike scattering medium (which processes the asset
and writes data to the gpu).

This is not desirable. The UX benefits for atmosphere initializers are
not worth the price being paid:

```rust
// EarthlikeAtmosphere resource
fn setup(mut commands: Commands, earth_atmosphere: Res<EarthlikeAtmosphere>) {
    commands.spawn((
        Camera3d::default(),
        earth_atmosphere.get(),
    ));
}

// Manual initialization
fn setup(mut commands: Commands, mut scattering_mediums: ResMut<Assets<ScatteringMedium>>,) {
    commands.spawn((
        Camera3d::default(),
        Atmosphere::earthlike(scattering_mediums.add(ScatteringMedium::default())),
    ));
}
```

The manual approach also puts the Atmosphere component symbol back at
the forefront and helps instruct developers on how this all actually
works.

## Solution

Remove the EarthlikeAtmosphere resource and add a default
ScatteringMedium impl to make init slightly easier.

As this feature will be introduced in 0.18, to avoid breaking people
down the road we should land this PR in 0.18 as well.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-Rendering Drawing game state to the screen C-Performance A change motivated by improving speed, memory usage or compile times C-Usability A targeted quality-of-life change that makes Bevy easier to use S-Ready-For-Final-Review This PR has been approved by the community. It's ready for a maintainer to consider merging it

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

6 participants