QualifierQuery::Exact 允许我们拒绝更通用的限定符。

例如，为了模拟以下语句

Add 50% of the character's magic damage to physical damage.

查询 (Magic, Damage)，其中包含 ((), Damage)，并添加到 (Physical, Damage) 将导致重复。

因此查询应该是

QualifierQuery::Exact {
    any_of: None,
    all_of: Magic,
}

• 你的意思是什么？我的 DarkFire 和 Fire 完全不同，应该是独立的。

创建一个新的限定符 DarkFire 而不是 Dark|Fire。

入门指南

将标记组件 StatEntity 添加到 Entity。如果您需要缓存，还可以添加 StatCache。但是，当状态改变时，您需要手动清除缓存。

• 实现 IntrinsicStream 使实体的组件可查询。
• 实现 ExternalStream 使子实体的组件可查询。

例如，我们可以将 BaseStatMap 添加到 Entity 作为基础统计数据，如果我们将其包含在 querier! 宏的 intrinsic 部分中。

查询器

StatQuerier 是查询统计信息的 SystemParam，手动定义它相当困难，因此推荐的方法是使用 querier! 宏定义一个 类型。此外，我们还可以使用带有 World 访问的 StatExtension 来实现类似的功能。

示例

querier!(pub UnitStatQuerier {
    qualifier: MyQualifier,
    intrinsic: {
        Allegiance,
        Position
    },
    external: {
        Weapon,
        Ability,
        Effect,
        Potion,
    }
});

无序统计流

bevy_stat_query 使用无序操作来构建统计数据。这包括 add、multiply、min、max 和 or。这确保在查询统计数据时不需要显式的排序。

每个统计数据都有其 StatValue 组件形式，例如 (12 * 4).min(99).max(0)，以及其评估形式，例如 48。您可以通过实现自己的 StatValue 来实现自定义行为。StatOperation 存储可以写入 StatValue 的单个操作。

统计数据关系

我们可以使用组件形式或评估形式创建不同统计数据之间的关系。StatStream 允许查询其他统计数据或其他实体。由于统计数据操作是无序的，无法解决依赖循环。如果检测到循环，将抛出错误。

实体关系

IntrinsicStream 可以用来提供双实体关系，例如 distance 或 allegiance。这可以用来模拟基于范围的影响。

您可能会在实现这些时发现 StatOnce(types::StatOnce) 有用。

注意

• StatQuerier 需要读取统计数据系统中的所有组件，因此当我们将其作为参数时不能进行任何修改。在这种情况下，使用系统管道或某种类型的延迟命令队列进行修改可能更合适。

• 该软件包在底层大量使用动态分发，因此不是完全反射兼容的。支持的序列化方法是通过 bevy-serde-project 软件包，有关更多信息，请查看该软件包。

• 如果 StatValue::Bounds 是浮点数，它们的默认值可能是 -inf 和 inf，这在 json 中不是有效值。这意味着 serde_json 将它们序列化为 null 并在反序列化时失败。如果使用 FullStatMap，请选择不同的格式。

版本

许可证

根据以下任一项许可

• Apache License，版本 2.0 (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)
• MIT 许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

任选其一。

贡献

除非您明确说明，否则您根据 Apache-2.0 许可证定义的任何有意提交以包含在作品中的贡献，将根据上述方式双许可，不附加任何额外的条款或条件。