# HierarchicalFiniteStateMachine

**Repository Path**: lxd_sun_admin/HierarchicalFiniteStateMachine

## Basic Information

- **Project Name**: HierarchicalFiniteStateMachine
- **Description**: A powerful and easy-to-use Godot plugin for Hierarchical Finite State Machine with visual editing.
- **Primary Language**: C#
- **License**: LGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-09-22
- **Last Updated**: 2025-09-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Hierarchical Finite State Machine - v 1.3

​		As we all know, state machine is a very common design pattern. Here provide a powerful and easy-to-use Godot plugin for Hierarchical Finite State Machine with visual editing.

# Features

1. Perfect visual editor
2. Supports hierarchical nesting and can be used in complex situations
3. Diversified transition plans 
4. Two development modes: signal callback and attached state script
5. Develop base GDscript, compatible with Godot basic version and mono version
6. **Allows `C#`script to attached as state script.**
7. **Suppoets `GDscript` and `C#` script to implement the logic of transition( full version only).**
8. **Has ability of working with animaions( Can be an Animation State Mechine)( New).**


# Full version links:
  1. https://afdian.net/@Daylily-Zeleen
  2. https://godotmarketplace.com/?post_type=product&p=37138   

# HFSM structure:

![](DOCUMENT.assets/strusture.png)

# Installation

​		Clone this repo and copy "addons" folder in your project,then Activate this plugin in Project Settings -> Plugins.

> NOTE:
>
> ​		Please obey the license(read LICENSE.md for more) when you using this plugin.
>
> + The full version is under a custom license.
> + The trial version is under the GNU Lesser General Public License v3.0.
>
# Tutorial

​	Demos are in `res://addons/hierarchical_finite_state_machine/demo/`.

> Note:
>
> 1. If you using standard version Godot, you can't run C# script's demo( may lost dependencies of `.tscn`).
>
>  	2. Only full version have follow demos:
>           	1. `new_corss_language_scriptint_2d_platiform_player`
>           	2. `new_feature_csharp_script_condition_transition_2d_platiform_player`
>           	3. `new_feature_gd_script_condition_transiton_2d_platform_player`

​		**Read [document](Document_en.md) for more.**



​	Demo 位于 `res://addons/hierarchical_finite_state_machine/demo/`

> 注意:
>
>  	1. 如果你使用的是标准版Godot, 你将不能运行含有 C#脚本的demo（打开`.tscn`有可能丢失依赖关系）
>  	2. 只有完整版才会附带以下Demo:
>  	 1. `new_corss_language_scriptint_2d_platiform_player`
>  	 2. `new_feature_csharp_script_condition_transition_2d_platiform_player`
>  	 3. `new_feature_gd_script_condition_transiton_2d_platform_player`

​		**[中文文档](Document_cn.md)请点击这里**