use bevy::prelude::*;
use moonshine_kind::prelude::*;

struct Fruit;

impl Kind for Fruit {
    type Filter = (/* ... */);
}

#[derive(Component)]
struct Human;

trait Eat {
    fn eat(&mut self, fruit: Instance<Fruit>);
}

// Humans can eat:
impl Eat for InstanceCommands<'_, Human> {
    fn eat(&mut self, fruit: Instance<Fruit>) {
        // ...
    }
}

fn eat(
    human: Query<Instance<Human>>,
    fruits: Query<Instance<Fruit>>, mut commands: Commands
) {
    let human = human.single();
    if let Some(fruit) = fruits.iter().next() {
        commands.instance(human).eat(fruit);
    }
}

Instance<Any>

在编写泛型代码时，可能需要一个可以是 Any 类型的实例

use moonshine_kind::{prelude::*, Any};

struct Container<T: Kind = Any> {
    items: Vec<Instance<T>>
}

Instance<Any> 在功能上等同于 Entity。

类型转换

如果为 T 实现了 CastInto<U>，则 Instance<T> 可以安全地转换为一个 Instance<U>。

这通过使用 .cast_into() 方法来完成

你可以使用 kind 宏来实现给定的类型对对应的此特性

use bevy::prelude::*;
use moonshine_kind::prelude::*;

#[derive(Component)]
struct Apple;

struct Fruit;

impl Kind for Fruit {
    type Filter = With<Apple>;
}

// An Apple is a Fruit because we said so:
kind!(Apple is Fruit);

fn init_apple(apple: Instance<Apple>, commands: &mut Commands) {
    init_fruit(apple.cast_into(), commands);
    // ...
}

fn init_fruit(fruit: Instance<Fruit>, commands: &mut Commands) {
    // ...
}

示例

有关完整示例，请参阅 examples/fruits.rs

限制

实例失效

此crate不会监控实例以进行失效。

这意味着如果一个实体被修改到不再匹配某些 Kind T（例如移除 Component T），那么任何引用它的 Instance<T> 都将是无效的。

建议避免对那些可能在运行时被移除而不销毁其关联实体的组件使用类型语义。

但是，如果需要，您可以在使用之前检查实例的有效性。

use bevy::prelude::*;
use moonshine_kind::prelude::*;

struct Fruit;

impl Kind for Fruit {
    type Filter = (/* ... */);
}

fn prune_fruits(
    mut fruits: Vec<Instance<Fruit>>,
    query: &Query<(), <Fruit as Kind>::Filter>
) -> Vec<Instance<Fruit>> {
    fruits.retain(|fruit| {
        // Is the Fruit still a Fruit?
        query.get(fruit.entity()).is_ok()
    });
    fruits
}

支持

对于任何错误、问题或建议，请提交一个问题。

您也可以在官方的Bevy Discord服务器上联系我，ID为@Zeenobit。