nightshade_api/

scene.rs

//! Retained scene content: primitives, models, hierarchy, and the [`Object`]
//! descriptor for spawning shape, color, and physics in one call.

use crate::palette::WHITE;
use crate::runner::MATERIAL_PREFIX;
use nightshade::prelude::nalgebra_glm::Mat4;
use nightshade::prelude::*;
use serde::{Deserialize, Serialize};

pub use nightshade::prelude::despawn_recursive_immediate as despawn;
pub use nightshade::prelude::spawn_cone_at as spawn_cone;
pub use nightshade::prelude::spawn_cube_at as spawn_cube;
pub use nightshade::prelude::spawn_cylinder_at as spawn_cylinder;
pub use nightshade::prelude::spawn_plane_at as spawn_plane;
pub use nightshade::prelude::spawn_sphere_at as spawn_sphere;
pub use nightshade::prelude::spawn_torus_at as spawn_torus;

/// The primitive shapes [`spawn_object`] can produce.
#[derive(
    Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize, enum2schema::Schema,
)]
pub enum Shape {
    #[default]
    Cube,
    Sphere,
    Cylinder,
    Cone,
    Torus,
    Plane,
}

/// Physics participation for [`spawn_object`]. Requires the `physics`
/// feature, which is on by default.
///
/// Dynamic cubes, spheres, cylinders, and cones get exact colliders. A
/// dynamic torus gets a convex hull of its mesh, which fills the hole. Static
/// toruses and planes collide against the exact triangle mesh.
#[derive(Debug, Clone, Copy, PartialEq, Default, Serialize, Deserialize, enum2schema::Schema)]
pub enum Body {
    #[default]
    None,
    Static,
    Dynamic {
        mass: f32,
    },
}

/// Everything about one object in a single struct literal.
///
/// ```ignore
/// let ball = spawn_object(world, Object {
///     shape: Shape::Sphere,
///     position: vec3(0.0, 4.0, 0.0),
///     color: RED,
///     body: Body::Dynamic { mass: 2.0 },
///     ..Object::default()
/// });
/// ```
pub struct Object {
    pub shape: Shape,
    pub position: Vec3,
    pub scale: Vec3,
    pub color: [f32; 4],
    pub body: Body,
}

impl Default for Object {
    fn default() -> Self {
        Self {
            shape: Shape::Cube,
            position: Vec3::zeros(),
            scale: Vec3::new(1.0, 1.0, 1.0),
            color: WHITE,
            body: Body::None,
        }
    }
}

/// Spawns an [`Object`]: mesh, color, and optional physics body in one call.
pub fn spawn_object(world: &mut World, object: Object) -> Entity {
    let entity = spawn_mesh_at(
        world,
        mesh_name(object.shape),
        object.position,
        object.scale,
    );
    crate::appearance::set_color(world, entity, object.color);
    match object.body {
        Body::None => {}
        #[cfg(feature = "physics")]
        Body::Static => {
            let collider = static_collider(world, object.shape, object.scale)
                .with_friction(0.8)
                .with_restitution(0.1);
            attach_body(
                world,
                entity,
                RigidBodyComponent::new_static().with_translation(
                    object.position.x,
                    object.position.y,
                    object.position.z,
                ),
                collider,
                false,
            );
        }
        #[cfg(feature = "physics")]
        Body::Dynamic { mass } => {
            let collider = dynamic_collider(world, object.shape, object.scale)
                .with_friction(0.7)
                .with_restitution(0.2);
            attach_body(
                world,
                entity,
                RigidBodyComponent::new_dynamic()
                    .with_translation(object.position.x, object.position.y, object.position.z)
                    .with_mass(mass),
                collider,
                true,
            );
        }
        #[cfg(not(feature = "physics"))]
        Body::Static | Body::Dynamic { .. } => {}
    }
    entity
}

/// Spawns a dynamic capsule physics body at `position`: a `radius` pill with a
/// `half_height` cylindrical section, `mass`, and a linear RGBA `color`. The
/// capsule is the upright character shape. The visual is a cylinder, the
/// collider is the true capsule. Capsule is not a [`Shape`], so it has its own
/// spawn rather than coming through [`spawn_object`].
#[cfg(feature = "physics")]
pub fn spawn_capsule_body(
    world: &mut World,
    position: Vec3,
    half_height: f32,
    radius: f32,
    mass: f32,
    color: [f32; 4],
) -> Entity {
    let scale = Vec3::new(radius * 2.0, (half_height + radius) * 2.0, radius * 2.0);
    let entity = spawn_mesh_at(world, mesh_name(Shape::Cylinder), position, scale);
    crate::appearance::set_color(world, entity, color);
    let collider = ColliderComponent::new_capsule(half_height, radius)
        .with_friction(0.7)
        .with_restitution(0.2);
    attach_body(
        world,
        entity,
        RigidBodyComponent::new_dynamic()
            .with_translation(position.x, position.y, position.z)
            .with_mass(mass),
        collider,
        true,
    );
    entity
}

/// Spawns a static, collidable mesh from raw geometry at `position`: it renders
/// the mesh and gives it an exact triangle collider, so dynamic bodies collide
/// with arbitrary level geometry. Each vertex is a (position, normal, uv) triple
/// and `indices` lists triangle corners three at a time. Heavy, so use it for
/// static level geometry, not movers.
#[cfg(feature = "physics")]
pub fn spawn_custom_mesh_collider(
    world: &mut World,
    name: &str,
    vertices: &[([f32; 3], [f32; 3], [f32; 2])],
    indices: &[u32],
    position: Vec3,
) -> Entity {
    let entity = crate::mesh::spawn_custom_mesh(world, name, vertices, indices, position);
    let positions: Vec<[f32; 3]> = vertices.iter().map(|(point, _, _)| *point).collect();
    let triangles: Vec<[u32; 3]> = indices
        .chunks_exact(3)
        .map(|chunk| [chunk[0], chunk[1], chunk[2]])
        .collect();
    let collider = ColliderComponent {
        shape: nightshade::plugins::physics::components::ColliderShape::TriMesh {
            vertices: positions,
            indices: triangles,
        },
        ..Default::default()
    };
    attach_body(
        world,
        entity,
        RigidBodyComponent::new_static().with_translation(position.x, position.y, position.z),
        collider,
        false,
    );
    entity
}

/// Spawns one [`Object`] at each position, all sharing a single registered
/// material, which is what writing it longhand for a crowd looks like. A
/// thousand entities through this hold one material entry, not a thousand.
pub fn spawn_objects(world: &mut World, object: Object, positions: &[Vec3]) -> Vec<Entity> {
    let mut entities = Vec::with_capacity(positions.len());
    let mut shared_material: Option<String> = None;
    #[cfg(feature = "physics")]
    let mut collider_template: Option<ColliderComponent> = None;

    for &position in positions {
        let entity = spawn_mesh_at(world, mesh_name(object.shape), position, object.scale);
        match shared_material.as_deref() {
            None => {
                crate::appearance::set_color(world, entity, object.color);
                shared_material = world
                    .get::<nightshade::ecs::material::components::MaterialRef>(entity)
                    .map(|material_ref| material_ref.name.clone());
            }
            Some(name) => {
                let name = name.to_string();
                adopt_shared_material(world, entity, &name);
            }
        }

        #[cfg(feature = "physics")]
        match object.body {
            Body::None => {}
            Body::Static => {
                let collider = collider_template
                    .get_or_insert_with(|| {
                        static_collider(world, object.shape, object.scale)
                            .with_friction(0.8)
                            .with_restitution(0.1)
                    })
                    .clone();
                attach_body(
                    world,
                    entity,
                    RigidBodyComponent::new_static()
                        .with_translation(position.x, position.y, position.z),
                    collider,
                    false,
                );
            }
            Body::Dynamic { mass } => {
                let collider = collider_template
                    .get_or_insert_with(|| {
                        dynamic_collider(world, object.shape, object.scale)
                            .with_friction(0.7)
                            .with_restitution(0.2)
                    })
                    .clone();
                attach_body(
                    world,
                    entity,
                    RigidBodyComponent::new_dynamic()
                        .with_translation(position.x, position.y, position.z)
                        .with_mass(mass),
                    collider,
                    true,
                );
            }
        }

        entities.push(entity);
    }
    entities
}

/// Spawns one entity that renders `transforms.len()` copies of the shape in a
/// single draw call, the cheapest way to put thousands of identical things on
/// screen. Per copy control afterward goes through the entity's
/// `InstancedMesh` component.
pub fn spawn_instanced(
    world: &mut World,
    shape: Shape,
    transforms: Vec<InstanceTransform>,
    color: [f32; 4],
) -> Entity {
    let shape_mesh_name = mesh_name(shape);
    ensure_primitive_mesh(world, shape_mesh_name);
    let fallback = format!(
        "api::material::instanced::{:.4}_{:.4}_{:.4}_{:.4}",
        color[0], color[1], color[2], color[3]
    );
    let material_name = nightshade::ecs::material::resources::material_registry_find_or_insert(
        &mut world
            .res_mut::<nightshade::ecs::asset_state::AssetState>()
            .material_registry,
        fallback,
        Material {
            base_color: color,
            ..Default::default()
        },
    );
    spawn_instanced_mesh_with_material(world, shape_mesh_name, transforms, &material_name)
}

/// Spawns an instanced mesh of `shape` that draws every transform in one batch
/// using the registry material named `material`, for large crowds sharing a
/// custom look. Register the material first with
/// [`register_material`](crate::prelude::register_material). Returns the batch
/// entity; restream its transforms with [`set_instances`].
pub fn spawn_instanced_with_material(
    world: &mut World,
    shape: Shape,
    transforms: Vec<InstanceTransform>,
    material: &str,
) -> Entity {
    let shape_mesh_name = mesh_name(shape);
    ensure_primitive_mesh(world, shape_mesh_name);
    spawn_instanced_mesh_with_material(world, shape_mesh_name, transforms, material)
}

/// Replaces an instanced batch's transforms and flags the renderer to reupload
/// its instance buffer, for streaming worlds and animated instance sets that
/// change every frame.
pub fn set_instances(world: &mut World, batch: Entity, transforms: Vec<InstanceTransform>) {
    if let Some(instanced) =
        world.get_mut::<nightshade::ecs::mesh::components::InstancedMesh>(batch)
    {
        instanced.set_instances(transforms);
    }
    world
        .res_mut::<nightshade::render::mesh_state::MeshRenderState>()
        .mark_instanced_meshes_changed();
}

fn adopt_shared_material(world: &mut World, entity: Entity, name: &str) {
    let previous = world
        .get::<nightshade::ecs::material::components::MaterialRef>(entity)
        .map(|material_ref| material_ref.name.clone());
    if let Some(previous_name) = previous
        && let Some((index, _)) = registry_lookup_index(
            &world
                .res::<nightshade::ecs::asset_state::AssetState>()
                .material_registry
                .registry,
            &previous_name,
        )
    {
        registry_remove_reference(
            &mut world
                .res_mut::<nightshade::ecs::asset_state::AssetState>()
                .material_registry
                .registry,
            index,
        );
    }
    if let Some((index, _)) = registry_lookup_index(
        &world
            .res::<nightshade::ecs::asset_state::AssetState>()
            .material_registry
            .registry,
        name,
    ) {
        registry_add_reference(
            &mut world
                .res_mut::<nightshade::ecs::asset_state::AssetState>()
                .material_registry
                .registry,
            index,
        );
    }
    world.set(entity, MaterialRef::new(name.to_string()));
    world
        .res_mut::<nightshade::render::mesh_state::MeshRenderState>()
        .mark_entity_added(render_entity(entity));
}

pub(crate) fn ensure_primitive_mesh(world: &mut World, mesh_name: &str) {
    use nightshade::render::procedural_meshes::{
        create_cone_mesh, create_cube_mesh, create_cylinder_mesh, create_plane_mesh,
        create_sphere_mesh, create_torus_mesh,
    };
    if !world
        .res::<nightshade::ecs::asset_state::AssetState>()
        .mesh_cache
        .registry
        .name_to_index
        .contains_key(mesh_name)
    {
        let mesh = match mesh_name {
            "Cube" => create_cube_mesh(),
            "Sphere" => create_sphere_mesh(1.0, 16),
            "Plane" => create_plane_mesh(2.0),
            "Torus" => create_torus_mesh(1.0, 0.3, 32, 16),
            "Cylinder" => create_cylinder_mesh(0.5, 1.0, 16),
            _ => create_cone_mesh(0.5, 1.0, 16),
        };
        mesh_cache_insert(
            &mut world
                .res_mut::<nightshade::ecs::asset_state::AssetState>()
                .mesh_cache,
            mesh_name.to_string(),
            mesh,
        );
    }
    if let Some((index, _)) = registry_lookup_index(
        &world
            .res::<nightshade::ecs::asset_state::AssetState>()
            .mesh_cache
            .registry,
        mesh_name,
    ) {
        registry_add_reference(
            &mut world
                .res_mut::<nightshade::ecs::asset_state::AssetState>()
                .mesh_cache
                .registry,
            index,
        );
    }
}

/// Spawns a simulated cloth sheet hanging from `position`, pinned along its
/// top row. It drapes, collides with the ground, and responds to the global
/// wind resource (`world.res::<nightshade::render::wind::Wind>()`).
/// Color it like anything else with [`set_color`](crate::prelude::set_color).
pub fn spawn_cloth_sheet(world: &mut World, position: Vec3, width: f32, height: f32) -> Entity {
    spawn_cloth(
        world,
        Cloth {
            width,
            height,
            ..Default::default()
        },
        position,
        "Cloth".to_string(),
    )
}

/// Shows or hides the entity without despawning it.
pub fn set_visible(world: &mut World, entity: Entity, visible: bool) {
    if let Some(visibility) = world.get_mut::<nightshade::ecs::primitives::Visibility>(entity) {
        visibility.visible = visible;
    }
}

/// Spawns a flat ground plane reaching `half_extent` in each direction. With
/// the `physics` feature it carries a static collider so dynamic objects land
/// on it.
pub fn spawn_floor(world: &mut World, half_extent: f32) -> Entity {
    let entity = spawn_mesh_at(
        world,
        "Plane",
        Vec3::zeros(),
        Vec3::new(half_extent, 1.0, half_extent),
    );
    #[cfg(feature = "physics")]
    attach_body(
        world,
        entity,
        RigidBodyComponent::new_static().with_translation(0.0, -0.05, 0.0),
        ColliderComponent::new_cuboid(half_extent, 0.05, half_extent)
            .with_friction(0.8)
            .with_restitution(0.1),
        false,
    );
    entity
}

/// Spawns a glb model with its textures, materials, skins, and animations.
/// Panics with the import error when the bytes are not a valid glb.
pub fn spawn_model(world: &mut World, glb_bytes: &[u8], position: Vec3) -> Entity {
    let mut result =
        import_gltf_from_bytes(glb_bytes).expect("failed to import the glb model bytes");
    nightshade::ecs::loading::queue_gltf_load(world, &mut result);
    let prefab = &result.prefabs[0];
    nightshade::ecs::prefab::commands::spawn_prefab_with_skins(
        world,
        prefab,
        &result.animations,
        &result.skins,
        position,
    )
}

/// Starts playing the model's animation clip at `clip_index`.
pub fn play_animation(world: &mut World, entity: Entity, clip_index: usize) {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
    {
        player.play(clip_index);
    }
}

/// Sets whether the entity's current animation repeats.
pub fn set_animation_looping(world: &mut World, entity: Entity, looping: bool) {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
    {
        player.looping = looping;
    }
}

/// Plays the animation clip named `clip_name`. Returns whether a clip with that
/// name exists on the model.
pub fn play_animation_named(world: &mut World, entity: Entity, clip_name: &str) -> bool {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
        && let Some(index) = player.clips.iter().position(|clip| clip.name == clip_name)
    {
        player.play(index);
        return true;
    }
    false
}

/// Sets the playback speed of the entity's animation. 1.0 is normal, 2.0 doubles
/// it, a negative value plays backward.
pub fn set_animation_speed(world: &mut World, entity: Entity, speed: f32) {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
    {
        player.speed = speed;
    }
}

/// Cross-fades from the current clip to `clip_index` over `seconds`, a smooth
/// transition rather than a hard cut.
pub fn blend_to_animation(world: &mut World, entity: Entity, clip_index: usize, seconds: f32) {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
    {
        player.blend_to(clip_index, seconds);
    }
}

/// Cross-fades to the clip named `clip_name` over `seconds`. Returns whether a
/// clip with that name exists.
pub fn blend_to_animation_named(
    world: &mut World,
    entity: Entity,
    clip_name: &str,
    seconds: f32,
) -> bool {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
        && let Some(index) = player.clips.iter().position(|clip| clip.name == clip_name)
    {
        player.blend_to(index, seconds);
        return true;
    }
    false
}

/// Pauses the entity's animation at the current frame.
pub fn pause_animation(world: &mut World, entity: Entity) {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
    {
        player.pause();
    }
}

/// Resumes a paused animation from where it left off.
pub fn resume_animation(world: &mut World, entity: Entity) {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
    {
        player.resume();
    }
}

/// Stops the entity's animation and resets it to the first frame.
pub fn stop_animation(world: &mut World, entity: Entity) {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
    {
        player.stop();
    }
}

/// The names of the entity's animation clips, in clip-index order.
pub fn animation_clips(world: &World, entity: Entity) -> Vec<String> {
    world
        .get::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
        .map(|player| player.clips.iter().map(|clip| clip.name.clone()).collect())
        .unwrap_or_default()
}

/// Adds a named marker at `time` seconds on the clip at `clip_index`. While that
/// clip plays, crossing the marker publishes an `Event::AnimationEvent` carrying
/// `name`, the cue to spawn a footstep, land a hit, or trigger an effect. Read
/// it with [`drain_events`](crate::prelude::drain_events). Returns false if the
/// entity has no animation player or the clip index is out of range.
pub fn add_animation_event(
    world: &mut World,
    entity: Entity,
    clip_index: usize,
    time: f32,
    name: &str,
) -> bool {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
        && let Some(clip) = player.clips.get_mut(clip_index)
    {
        clip.events
            .push(nightshade::ecs::animation::components::AnimationEvent {
                time,
                name: name.to_string(),
            });
        return true;
    }
    false
}

/// Adds a named marker at `time` seconds on the clip named `clip_name`, the
/// by-name form of [`add_animation_event`].
pub fn add_animation_event_named(
    world: &mut World,
    entity: Entity,
    clip_name: &str,
    time: f32,
    name: &str,
) -> bool {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
        && let Some(clip) = player.clips.iter_mut().find(|clip| clip.name == clip_name)
    {
        clip.events
            .push(nightshade::ecs::animation::components::AnimationEvent {
                time,
                name: name.to_string(),
            });
        return true;
    }
    false
}

/// Plays an extra clip on top of the base animation at `weight` (0.0 to 1.0),
/// blended over the bones the clip targets. Returns the layer's index for
/// [`set_animation_layer_weight`], or `None` if the entity has no animation
/// player. A reload, a hit reaction, anything composited over a walk or idle.
pub fn add_animation_layer(
    world: &mut World,
    entity: Entity,
    clip_index: usize,
    weight: f32,
) -> Option<usize> {
    let player =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)?;
    let index = player.layers.len();
    player.layers.push(
        nightshade::ecs::animation::components::AnimationLayer::new(clip_index).with_weight(weight),
    );
    Some(index)
}

/// Plays an extra clip limited to the named bones, the per-bone mask form of
/// [`add_animation_layer`]. Pass the bone names the layer should drive, like the
/// spine and arms for an upper-body wave over a full-body walk.
pub fn add_animation_layer_masked(
    world: &mut World,
    entity: Entity,
    clip_index: usize,
    weight: f32,
    bones: &[&str],
) -> Option<usize> {
    let player =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)?;
    let index = player.layers.len();
    let mask = bones.iter().map(|bone| bone.to_string()).collect();
    player.layers.push(
        nightshade::ecs::animation::components::AnimationLayer::new(clip_index)
            .with_weight(weight)
            .with_mask(mask),
    );
    Some(index)
}

/// Sets the blend weight of a layer added by [`add_animation_layer`], for fading
/// a composited animation in and out. 0.0 disables it without removing it.
pub fn set_animation_layer_weight(
    world: &mut World,
    entity: Entity,
    layer_index: usize,
    weight: f32,
) {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
        && let Some(layer) = player.layers.get_mut(layer_index)
    {
        layer.weight = weight;
    }
}

/// Removes every animation layer, leaving only the base animation.
pub fn clear_animation_layers(world: &mut World, entity: Entity) {
    if let Some(player) =
        world.get_mut::<nightshade::ecs::animation::components::AnimationPlayer>(entity)
    {
        player.layers.clear();
    }
}

/// Registers `entity` under `name` so it can be looked up by name, including
/// through the `named` map a rhai script reads. Use it to hand specific entities
/// (a HUD label, a player) to scripts that drive them.
pub fn name_entity(world: &mut World, name: &str, entity: Entity) {
    world
        .res_mut::<nightshade::ecs::entity_registry::EntityRegistry>()
        .names
        .insert(name.to_string(), entity);
}

/// Spawns an invisible group at `position` for building hierarchies. Parent
/// things to it and move, rotate, or animate the group to drive them all.
pub fn spawn_group(world: &mut World, position: Vec3) -> Entity {
    let entity = spawn_entities(world, NAME | LOCAL_TRANSFORM | GLOBAL_TRANSFORM, 1)[0];
    world.set(entity, Name("Group".to_string()));
    world.set(
        entity,
        LocalTransform {
            translation: position,
            ..Default::default()
        },
    );
    entity
}

/// Parents `child` to `parent`, or unparents it with `None`, keeping the
/// child exactly where it is in world space.
pub fn set_parent(world: &mut World, child: Entity, parent: Option<Entity>) {
    let child_world = crate::placement::world_matrix(world, child);
    let parent_world = parent
        .map(|parent_entity| crate::placement::world_matrix(world, parent_entity))
        .unwrap_or_else(Mat4::identity);
    let local = nalgebra_glm::inverse(&parent_world) * child_world;

    let translation = nalgebra_glm::vec3(local[(0, 3)], local[(1, 3)], local[(2, 3)]);
    let basis_x = nalgebra_glm::vec3(local[(0, 0)], local[(1, 0)], local[(2, 0)]);
    let basis_y = nalgebra_glm::vec3(local[(0, 1)], local[(1, 1)], local[(2, 1)]);
    let basis_z = nalgebra_glm::vec3(local[(0, 2)], local[(1, 2)], local[(2, 2)]);
    let scale = nalgebra_glm::vec3(
        basis_x.magnitude(),
        basis_y.magnitude(),
        basis_z.magnitude(),
    );
    let rotation_matrix = nalgebra_glm::Mat3::from_columns(&[
        basis_x / scale.x.max(f32::EPSILON),
        basis_y / scale.y.max(f32::EPSILON),
        basis_z / scale.z.max(f32::EPSILON),
    ]);
    let rotation = nalgebra_glm::mat3_to_quat(&rotation_matrix);

    if parent.is_some() {
        world.ecs.worlds[CORE].add_components(child, PARENT);
    }
    update_parent(world, child, parent);
    world.set(
        child,
        LocalTransform {
            translation,
            rotation,
            scale,
        },
    );
}

#[cfg(feature = "picking")]
pub(crate) fn is_reserved(world: &World, entity: Entity) -> bool {
    world
        .get::<nightshade::ecs::primitives::Name>(entity)
        .is_some_and(|name| name.0.starts_with(crate::runner::RESERVED_PREFIX))
}

pub(crate) fn api_material_name(entity: Entity) -> String {
    format!("{MATERIAL_PREFIX}{}", entity.id)
}

fn mesh_name(shape: Shape) -> &'static str {
    match shape {
        Shape::Cube => "Cube",
        Shape::Sphere => "Sphere",
        Shape::Cylinder => "Cylinder",
        Shape::Cone => "Cone",
        Shape::Torus => "Torus",
        Shape::Plane => "Plane",
    }
}

#[cfg(feature = "physics")]
fn dynamic_collider(world: &World, shape: Shape, scale: Vec3) -> ColliderComponent {
    match shape {
        Shape::Cube => ColliderComponent::new_cuboid(scale.x * 0.5, scale.y * 0.5, scale.z * 0.5),
        Shape::Sphere => ColliderComponent::new_ball(scale.x),
        Shape::Cylinder => ColliderComponent::new_cylinder(scale.y * 0.5, scale.x * 0.5),
        Shape::Cone => ColliderComponent::new_cone(scale.y * 0.5, scale.x * 0.5),
        Shape::Torus => ColliderComponent {
            shape: ColliderShape::ConvexMesh {
                vertices: scaled_mesh_points(world, "Torus", scale),
            },
            ..Default::default()
        },
        Shape::Plane => ColliderComponent::new_cuboid(scale.x, 0.05, scale.z),
    }
}

#[cfg(feature = "physics")]
fn static_collider(world: &World, shape: Shape, scale: Vec3) -> ColliderComponent {
    match shape {
        Shape::Torus | Shape::Plane => {
            let shape_mesh_name = mesh_name(shape);
            ColliderComponent {
                shape: ColliderShape::TriMesh {
                    vertices: scaled_mesh_points(world, shape_mesh_name, scale),
                    indices: mesh_triangles(world, shape_mesh_name),
                },
                ..Default::default()
            }
        }
        _ => dynamic_collider(world, shape, scale),
    }
}

#[cfg(feature = "physics")]
fn scaled_mesh_points(world: &World, mesh_name: &str, scale: Vec3) -> Vec<[f32; 3]> {
    registry_entry_by_name(
        &world
            .res::<nightshade::ecs::asset_state::AssetState>()
            .mesh_cache
            .registry,
        mesh_name,
    )
    .map(|mesh| {
        mesh.vertices
            .iter()
            .map(|vertex| {
                [
                    vertex.position[0] * scale.x,
                    vertex.position[1] * scale.y,
                    vertex.position[2] * scale.z,
                ]
            })
            .collect()
    })
    .unwrap_or_default()
}

#[cfg(feature = "physics")]
fn mesh_triangles(world: &World, mesh_name: &str) -> Vec<[u32; 3]> {
    registry_entry_by_name(
        &world
            .res::<nightshade::ecs::asset_state::AssetState>()
            .mesh_cache
            .registry,
        mesh_name,
    )
    .map(|mesh| {
        mesh.indices
            .chunks_exact(3)
            .map(|triangle| [triangle[0], triangle[1], triangle[2]])
            .collect()
    })
    .unwrap_or_default()
}

#[cfg(feature = "physics")]
fn attach_body(
    world: &mut World,
    entity: Entity,
    body: RigidBodyComponent,
    collider: ColliderComponent,
    dynamic: bool,
) {
    let mut flags = RIGID_BODY | COLLIDER;
    if dynamic {
        flags |= COLLISION_LISTENER | PHYSICS_INTERPOLATION;
    }
    world.ecs.worlds[CORE].add_components(entity, flags);
    world.set(entity, body);
    world.set(entity, collider);
    if dynamic {
        reset_physics_interpolation(world, entity);
        if let Some(interpolation) =
            world.get_mut::<nightshade::plugins::physics::components::PhysicsInterpolation>(entity)
        {
            interpolation.enabled = true;
        }
    }
}