2dog new

Creates a new Godot project with 2dog hosts. Without host flags it asks which hosts to create. Host flags skip that wizard; a missing workload (wasm-tools, android) can still be offered on terminals. -y runs unattended.

2dog new [Name] [dir] [hosts] [options]

Argument	Meaning
Name	Project name, used for folders, assemblies and namespaces; letters, digits, . and _ survive, - becomes _, C# keywords get a _ prefix, an adjustment is announced
dir	Directory to create; defaults to the sanitized name

Hosts

--repl [folder] adds an opt-in C# REPL host with syntax highlighting, completion and live access to the running game.

Any host flag, repeatable. Unattended without one: generic and browser, minus the --no-<host> ones. Add tests explicitly with --xunit or --nunit.

Options

Option	Effect
-n, --name <name>	Project name; same as Name
-o, --output <dir>	Directory; same as dir
--dry-run	Print the plan; change nothing
--force	Overwrite scaffolded files that exist; never deletes
--no-restore	Skip the final dotnet restore
--install-wasm-tools	Install missing wasm-tools for browser hosts without an installation prompt
--install-android-workload	Install the missing android workload for Android hosts without an installation prompt

Plus the global and output options.

--no-restore skips the workload offers; the install flags request installation explicitly. --dry-run never checks or installs workloads.

Workload offers apply to newly selected hosts. Browser and Android hosts are excluded from plain solution builds; desktop/test work needs neither workload. A failed restore returns exit code 2 and keeps the created files. Fix the reported cause and run dotnet restore again.

Examples

Install the .NET 10 SDK, then create and run a project with a generic .NET host:

dnx 2dog new MyGame --generic
cd MyGame
dotnet run --project MyGame.2dog

Open project.godot in the Godot .NET editor to edit scenes and scripts. See Project Layout for the generated files and Hosts for host types.

Choose hosts interactively, or supply host flags:

2dog new MyGame                            # interactive host choice
2dog new MyGame --generic --xunit          # unattended
2dog new "My Game" -o games/mine --no-web  # name adjusted to MyGame

For an existing project, use 2dog add.

Use the .NET Template

The same template is available through dotnet new:

dotnet new install 2dog
dotnet new 2dog -n MyGame --web false

This creates a generic .NET host. Omit --web false to include Web; install wasm-tools when you want to build or publish that host.

Test hosts are opt-in. Pass --xunit true or --nunit true to dotnet new 2dog, or use 2dog new MyGame --xunit or --nunit.

Debugging the Godot project in VS Code

New projects include .vscode/launch.json, tasks.json, and a recommendation for Microsoft's C# extension. Open the project root folder, install that extension, select Godot: Play (C#) in Run and Debug, and press F5. The build task builds only the root Godot project in Debug configuration.

Set the GODOT4 environment variable to the main .NET-enabled Godot executable and restart VS Code, or replace program in launch.json with its absolute path. On Windows, use the mono executable, not the _console.exe wrapper. Godot Tools' editor path setting alone does not configure the C# debugger.

The Godot SDK root is a library loaded by Godot, so it needs this external executable launch. The .2dog host is a regular .NET executable and supports the usual .NET launch workflow. Godot: Attach (C#) can attach to an already running .NET Godot game or editor; select the process that loads your scripts.