{"id":18850007,"url":"https://github.com/thepat02/behaviourtoolkit","last_synced_at":"2025-10-11T17:19:37.758Z","repository":{"id":205608950,"uuid":"707151216","full_name":"ThePat02/BehaviourToolkit","owner":"ThePat02","description":"A collection of tools for AI Behaviour in the Godot 4 Game Engine!","archived":false,"fork":false,"pushed_at":"2025-09-18T20:50:22.000Z","size":1409,"stargazers_count":554,"open_issues_count":13,"forks_count":20,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-09-18T22:59:43.908Z","etag":null,"topics":["behaviour-tree","finite-state-machine","godot"],"latest_commit_sha":null,"homepage":"","language":"GDScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ThePat02.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"pat02","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"custom":null}},"created_at":"2023-10-19T10:24:26.000Z","updated_at":"2025-09-18T20:48:56.000Z","dependencies_parsed_at":"2024-08-27T22:05:12.522Z","dependency_job_id":"b35c31be-644b-41ac-bfd5-8a8f6f4a58b6","html_url":"https://github.com/ThePat02/BehaviourToolkit","commit_stats":{"total_commits":244,"total_committers":6,"mean_commits":"40.666666666666664","dds":0.05327868852459017,"last_synced_commit":"a9fc86bc6ba3534e309c0f7cf057bddb6e7845f8"},"previous_names":["thepat02/behaviourtoolkit"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/ThePat02/BehaviourToolkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThePat02%2FBehaviourToolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThePat02%2FBehaviourToolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThePat02%2FBehaviourToolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThePat02%2FBehaviourToolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ThePat02","download_url":"https://codeload.github.com/ThePat02/BehaviourToolkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThePat02%2FBehaviourToolkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279008114,"owners_count":26084396,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["behaviour-tree","finite-state-machine","godot"],"created_at":"2024-11-08T03:27:15.625Z","updated_at":"2025-10-11T17:19:37.729Z","avatar_url":"https://github.com/ThePat02.png","language":"GDScript","funding_links":["https://ko-fi.com/pat02"],"categories":[],"sub_categories":[],"readme":"![Thumbnail](docs/thumbnail.svg)\n# BehaviourToolkit for Godot 4\nThis plugin provides a set of tools to create custom and complex behaviour in the Godot 4.x Game Engine.\n\n### Features\n- ![GEAR ICON](addons/behaviour_toolkit/icons/Gear.svg) Behaviour Architectures\n    - ![FMS ICON](addons/behaviour_toolkit/icons/FiniteStateMachine.svg) Finite State Machine\n    - ![BT ICON](addons/behaviour_toolkit/icons/BTRoot.svg) Behaviour Tree with generic utility \n    - ![Integration Icon](addons/behaviour_toolkit/icons/BTCompositeIntegration.svg) Nest Behaviour Trees inside State Machines and vice versa!\n- ![BLACKBOARD ICON](addons/behaviour_toolkit/icons/Blackboard.svg) Blackboard Resource\n- Editor Interface with shortcuts\n- [Templates](docs/documentation.md#using-script-templates) for easy extension and integration\n- Example Scene\n\nWhen a new version is available on GitHub, the plugin will display a notification in the Toolbox! \n\n\n\n## Installation\n- Clone the `main` branch of this repository to your machine\n- Download the latest release from the [Godot Asset Lib](https://godotengine.org/asset-library/asset)\n- Add the `submodule` branch as [Git Submodule](https://git-scm.com/docs/git-submodule) to your own repo\n  - The `submodule` branch is **always** up to date with `main` and will allow you to consistently use the newest version by `pulling`\n  - If you are not confident in your CL skills, you can use a client like GitKraken to set this up\n\n\n\n## Usage\nMake sure the clones the `addons` and `script_templates` directories into your project.\n\n1. Add a `FiniteStateMachine` or `BTRoot` node to your scene.\n2. A toolbox will appear in the editor, allowing you to add behaviour nodes to the scene.\n3. Setup and configure your behaviour nodes in the inspector.\n4. Right-click your `FSMState`/`FSMTransition`/`BTLeaf` and extend the script.\n\nNow you can implement your own behaviour logic using the virtual methods provided by the script templates.\n\n\n\n## Documentation\n- [Documentation](docs/documentation.md)\n  -   [Finite State Machine](docs/documentation.md#finite-state-machine)\n  -   [Behaviour Tree](docs/documentation.md#behaviour-tree)\n  -   [Blackboard](docs/documentation.md#-blackboard)\n  -   [Nesting Behaviours inside Behaviours](docs/documentation.md#nesting-behaviours-inside-behaviours)\n  \n![Screenshot](docs/screenshot-ui.PNG)\n\n\n\n## Notes \nThis is the first time I've ever made a bigger plugin for Godot, so I am happy for any suggestions, feedback and contributions. If you need help or have any questions, feel free to contact me on Discord (`thepat02`) or open an issue on GitHub!\n\nYou can also [buy me a coffee](https://ko-fi.com/pat02) if you like the plugin and feel like supporting me :D\n\nHave fun creating awesome behaviours!\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=ThePat02/BehaviourToolkit\u0026type=Timeline)](https://star-history.com/#ThePat02/BehaviourToolkit\u0026Timeline)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthepat02%2Fbehaviourtoolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthepat02%2Fbehaviourtoolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthepat02%2Fbehaviourtoolkit/lists"}