Game Folder

EngineForge needs to know which folder is your game project. In most cases it detects this automatically. In multi-folder workspaces you can confirm or change the selection at any time.

Auto-detection

When you open a folder, EngineForge scans for engine marker files:

  • Unity: ProjectSettings/ProjectVersion.txt
  • Godot 4: project.godot

The folder that contains these files becomes the game folder — the root that the bridge, the code index, and all file tools operate from. The active game folder is marked with a violet rocket icon (🚀) in the Explorer sidebar.

Multi-folder workspaces

If your workspace contains more than one folder (e.g. a game project alongside a backend server), EngineForge shows a Choose your game project card on startup so you can confirm the right target. The card lists your workspace roots and, if a nested game project was detected inside one of them, that subfolder too.

Selecting a folder sets it as the game folder for the current workspace. The other folders remain open for editing — only the bridge and code index target changes.

Nested game projects

You can open a parent repository that contains a Unity or Godot project in a subfolder. EngineForge detects the nested engine project automatically and targets it for the bridge and file tools, even though the workspace root is the parent folder.

Example: opening my-repo/ where the Unity project lives at my-repo/Game/ — EngineForge connects the bridge to Game/ automatically.

Changing the game folder

There are three ways to change the active game folder:

  1. Command palette: Press Cmd/Ctrl+Shift+P and run EngineForge: Choose Game Folder. The picker opens regardless of whether you have already dismissed the startup card.
  2. Explorer right-click: Right-click any folder in the Explorer sidebar and choose Set as Game Folder.
  3. Auto-detect: Right-click a folder in the Explorer and choose Reset Game Folder (Auto-detect) to clear any manual override and let EngineForge re-detect automatically.

The Explorer badge

The active game folder is always marked with a violet rocket badge in the Explorer sidebar. Hovering over it shows a tooltip confirming it is the bridge and code index target. If the badge is not visible, the game folder may be a nested subfolder — expand the tree to find it.