Skip to content

FootClanSoldier/SystemExplorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

66 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

System Explorer Logo

System Explorer

Godot C# Version License

Architecture-focused navigation plugin for Godot C# projects.


System Explorer Overview

About

System Explorer is a Godot C# editor plugin that provides an architecture-focused view of your project.

Instead of navigating large projects through the FileSystem dock, you can organize scripts into custom systems and folders that reflect the architecture of your game—without changing your physical project structure.


Why?

Large C# projects often end up with deep folder structures:

Game
└── Gameplay
    └── Entities
        └── Player
            └── Modules

System Explorer lets you navigate your project from a higher-level architectural perspective instead:

Core
GameFlow
Sound
Player
UI

Organize your code according to how your game is structured, not simply where files happen to live on disk.


Features

Organization

Systems

  • Create systems and folders
  • Create new scripts or add existing ones
  • Rename and remove items
  • Drag & drop organization
  • Virtual organization that doesn't modify your project structure

Navigation

  • Architecture-focused project navigation
  • Filter scripts across every system
  • Open scripts with a single click
  • Open File Path
  • Expansion state persistence

Scene Integration

Connect your architecture directly to the scenes that use those scripts.

  • Link scripts to scenes
  • Single-click opens the script
  • Double-click opens both the script and its linked scene
  • Unlink scene associations
  • Automatic recovery if linked scenes are moved or deleted

Scene links are stored in systems.json and persist between editor sessions.


Workflow

Several quality-of-life features help speed up common workflows:

  • Press Enter to confirm dialogs and create new systems
  • Click the + button inside the System Name field to create a system
  • Context menus for common actions
  • Script templates
  • Script tooltips
  • Shift + Click expands or collapses entire branches
  • ctrl+ Delete opens the delete dialog
  • Expansion state is automatically preserved between common operations

Installation

  1. Copy the addon into:
addons/system_explorer/
  1. Open the project in Godot.

  2. Make sure the project contains a C# solution/project file.

If the project has not been initialized for C#, create one via:

Project
→ Tools
→ C#
→ Create C# Solution
  1. Build the C# project.

  2. Enable the plugin:

Project
→ Project Settings
→ Plugins
  1. Enable System Explorer.

Note: System Explorer is designed for C# projects. A valid Godot C# solution/project file must exist before the plugin can be compiled and used.


Script Templates

New scripts are generated using:

addons/system_explorer/script_template.txt

You can customize this template to match your coding style, namespaces, project structure, or preferred class layout.

The placeholder:

{{CLASS_NAME}}

is automatically replaced with the script file name.

Example:

using Godot;

namespace MyNamespace
{
	public sealed class {{CLASS_NAME}}
	{

	}
}

If no template file is found, System Explorer falls back to a built-in default template.


Data Storage

System Explorer stores its configuration in:

addons/system_explorer/systems.json

This file can safely be committed to source control.


Known Issues

Godot Editor Cache Warnings

When deleting scripts from the filesystem through the plugin, Godot may occasionally display warnings related to scripts that no longer exist.

These warnings originate from Godot's internal editor cache and do not affect plugin functionality.

They typically disappear after rebuilding or reopening the project.


Future Ideas

  • Multiple architecture views
  • Namespace refactoring
  • Custom icons
  • Beautify systems
  • Beautify folders
  • Beautify scripts

Feedback

Feedback, suggestions, bug reports, and feature requests are always welcome.

Future development will primarily be driven by real-world usage and community feedback.

About

Architecture-focused navigation plugin for Godot C# projects. Organize scripts into systems and folders that reflect your game's architecture instead of relying solely on the FileSystem dock.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages