seldom_state

seldom_state 是Bevy的组件化状态机插件。适用于AI、玩家状态以及其他处于各种状态的实体。它允许在实体之间更高效地复用状态逻辑，相比直接在系统中管理互斥组件。

状态是附加到实体的组件，定义其实际行为，如 Jumping 或 Stunned。触发器是一个系统，它检查世界中的实体信息，如 near_position 或 health_below_threshold。转换将两个状态连接起来：一个要转换的，一个要转换到的；一旦发生给定的触发器。状态机是附加到实体的组件，用于跟踪实体的转换，并根据这些转换自动更改实体的状态。

状态机的创建方式如下

commands.spawn((
    // ... (other inserts)
    MyInitialState::new(),
    StateMachine::default()
        .trans::<MyInitialState, _>(my_trigger_1, my_state_2)
        .trans::<AnyState, _>(my_trigger_3, my_state_4)
        .trans_builder(my_trigger_5, |my_state_6: &MyState6, trigger_data| {
            make_state_7(my_state_6, trigger_data)
        })
        .on_enter::<MyState7>(move |entity| entity.insert(my_bundle.clone()))
        .on_exit::<MyState7>(|entity| entity.remove::<MyBundle>())
        // etc.
));

有关更完整的示例，请参阅 examples 目录。示例 chase.rs 写作指南风格，因此非常适合学习。如果您需要帮助，请随时在 Bevy Discord服务器 上联系我（@Seldom）！如果您有任何改进意见，请随时提交问题或pr！

功能

• 具有用户定义状态和触发器的状态机组件
• 30个内置触发器
  • always：始终触发
  • NotTrigger、AndTrigger 和 OrTrigger：使用布尔逻辑组合触发器
  • done：当将 Done 组件添加到实体时触发
  • 由leafwing_input特性启用的24个更多触发器：action_data、axis_pair、axis_pair_length_bounds、axis_pair_max_length、axis_pair_min_length、axis_pair_rotation_bounds、axis_pair_unbounded、clamped_axis_pair、clamped_axis_pair_length_bounds、clamped_axis_pair_max_length、clamped_axis_pair_min_length、clamped_axis_pair_rotation_bounds、clamped_axis_pair_unbounded、clamped_value、clamped_value_max、clamped_value_min、clamped_value_unbounded、just_pressed、just_released、pressed、value、value_max、value_min以及value_unbounded
  • on_event：读取指定类型的事件时触发
  • Bevy的内置运行条件也用作触发器
• AnyState状态，可用于类型参数来表示任何状态
• 允许从输出状态和触发器到输入状态的转换的转换构建器(StateMachine::trans_builder)
• 在进入或退出状态时自动执行行为(StateMachine::on_enter、StateMachine::on_exit、StateMachine::command_on_enter和StateMachine::command_on_exit)

# Replace * with your desired version

[dependencies]
seldom_state = "*"