Component-based framework and project template for Godot

The goal is to have an all-in-one toolkit for 2D games (platformers, shoot-em-ups, RPGs, turn-based strategy or puzzle) where you build scenes by adding components to entities like Lego blocks and tweaking their parameters in the UI. "Entities" are just regular nodes and "components" are also nodes that modify other nodes, so you can mix this framework with any other architecture or programming paradigm, even for 2D scenes in a 3D game!

• Includes a library of components for different types of player movement, combat, collectibles, inventory, interactions, upgrades etc.
• Standard UI controls like a stats HUD, buttons & lists for special skills etc.
• Template scenes for Logo → Main Menu → Options, Input Remapping, Pause Overlay
• Save/Load player preferences via a config file with just Settings.any_name = 69
• Tons of helper functions & debugging tools.
• Commented & documented code.
• Free-to-use 3rd-party assets for quick prototyping.

🌳 An example of a player entity:

⭐️ It lets you do neat tricks like put a GunComponent and MouseRotationComponent on any object and It Just Works:

⭐️ The composition architecture lets you easily change abilities/buffs/debuffs at runtime; just add/remove components in simple event handlers, like this example of swapping between platformer physics and flying/"overhead" movement:

📈 There's even sexy charts for debugging variables in real-time!

(if the videos don't display, view on imgur): 1, 2

🚀 For a quick glance: See the /Templates/Scenes/ folder.

⚙️ To use this framework for your own games:

1. Clone this repository; make a local copy of this entire Godot project and rename it for your game.
2. Drag-&-drop nodes from the /Entities/ and /Components/ folders to build your scenes.
   • The /Templates/ folder contains example scenes and Entities with preset groups of Components to use as a quick starting point for various types of gameplay.
   • The /Scripts/ folder contains code for simple non-Entity nodes.
   • The /UI/ folder contains common UI elements such as a stats HUD, special action buttons, lists for choosing upgrades etc.

🎳 Whenever your game needs an "actor" like the player character or a monster, or an object with "behaviors" that could be reused for other objects, like interactive items or collectible powerups:

Use the included custom dock plugin (the Comedock :) or perform these steps manually:

1. Create a new Entity node: a Node2D/Sprite2D/CharacterBody2D etc. with the Entity.gd script attached.
2. Add Component child nodes to the entity. A component is also a Node/Area2D etc. with a script that extends the Component.gd class.
3. Modify component parameters in the Godot Editor's Inspector.
4. Save the entity components tree as a standalone scene file to organize it separately from the main "world" scene and quickly create copies of it anywhere.

Comedot ©? MMXXIV ShinryakuTako@GitHub • Syntaks.io@Discord

🤍 THANKS:

• Tilesets: https://kenney.nl/assets/1-bit-pack
• Font: Jayvee Enaguas (HarvettFox96) https://www.dafont.com/pixel-operator.font