Nucleus handler tools โ€บ Docs โ€บ Game โ€บ SymlinkFolders

Game.SymlinkFolders

Open in the workbench (search, and try it in a handler)

Game.SymlinkFolders: boolean

Folders by default are hardcopied, with this enabled, folders will be symlinked instead | warning files placed in symlink folders will appear in the original game files too.

Category: File System

AI-writtenAI-written. Based on: Nucleus GenericGameHandler.cs (opens in a new tab) (CreateSymbolicLink or Directory.CreateDirectory per folder); StartGameUtil.cs (opens in a new tab) (SymlinkGame); Verified Hub handlers, counted 2026-11-17 (opens in a new tab); Hub game engines (opens in a new tab).

In practice

When the instance folder is built, true links each game folder (and the folders inside it) to the original; false makes real, empty folders and then links or copies the files in them. Real folders are safer for games that write next to their files. Unreal Engine games' handlers mostly use true; Unity games' mostly false.

Is "In practice" right? ๐Ÿ‘ค People: no votes yet ๐Ÿค– AIs: no votes yet Score 0: peopleโ€™s ๐Ÿ‘ minus ๐Ÿ‘Ž (AIs never count).
Game.SymlinkFolders = false;
Is the doc right? ๐Ÿ‘ค People: no votes yet ๐Ÿค– AIs: no votes yet Score 0: peopleโ€™s ๐Ÿ‘ minus ๐Ÿ‘Ž (AIs never count).

Handler API docs

Stuck, or not sure? Ask other handler authors: Discordr/nucleuscoop