Godot Node Tree Shell

An in-game shell terminal for inspecting and manipulating the scene tree at runtime.
Navigate nodes, read/write properties, call methods — all from a terminal overlay.

✨ Features

• Navigate the scene tree — traverse nodes using familiar shell-like commands
• Inspect & modify properties — get and set any property on the current node
• Call methods — invoke functions on nodes with arguments
• Autocomplete — tab-completion for node properties and methods
• Command history — navigate previous commands with the arrow keys
• Tree view — visualize the subtree from any node

Coming soon:

• Signal emission — trigger signals on any node directly from the shell
• Property watching — monitor a property in real time and get notified whenever its value changes
• Property value helpers — context-aware input UI based on property type (e.g. a color picker when editing a Color property)

💾 Installation

Asset Library (Recommended)

1. In Godot, open the AssetLib tab.
2. Search for "Godot Node Tree Shell" and install it.
3. Enable the plugin under Project → Project Settings → Plugins.

Manual

1. Download or clone this repository.
2. Copy the addons/godot-node-tree-shell folder into your project's addons/ directory.
3. Enable the plugin under Project → Project Settings → Plugins.

[!NOTE] Only the addons/godot-node-tree-shell folder is required. Any files or directories outside of addons/ (e.g. demo scenes, assets) can be safely ignored.

The NodeTreeShellCore autoload singleton is registered automatically when the plugin is enabled.

[!NOTE] For more help, see Godot's official documentation on installing plugins.

🚀 Usage

Once the plugin is enabled, press F4 at runtime to toggle the terminal overlay. No extra setup needed.

At runtime, the prompt shows the active node path:

[/root]$ <command>

[!NOTE] The terminal opens as a sub-window. If embed subwindows is enabled in your project settings, a warning banner will appear — you can dismiss it or toggle the setting directly from the banner.

Commands

Keyboard Shortcuts