Configuration

Set 2dog properties in your host project's .csproj.

Properties

Property	Default	Purpose
GodotProjectDir	None	Directory containing project.godot; enables automatic resource import and is embedded for Engine.ResolveProjectDir()
TwoDogVariant	release	Native desktop variant: release, debug, or editor
TwoDogRemoveDuplicateGodotAnalyzers	false	Removes duplicate analyzers from a host that also references a Godot.NET.Sdk game project

The standard nested-host setup is:

<PropertyGroup>
  <GodotProjectDir>..</GodotProjectDir>
  <TwoDogVariant Condition="'$(Configuration)' == 'Debug'">debug</TwoDogVariant>
  <TwoDogVariant Condition="'$(Configuration)' == 'Editor'">editor</TwoDogVariant>
  <TwoDogRemoveDuplicateGodotAnalyzers>true</TwoDogRemoveDuplicateGodotAnalyzers>
</PropertyGroup>

GodotProjectDir is resolved relative to the project file and embedded as an absolute path. The game project itself must keep its Godot source generator; only the host should remove duplicate analyzers.

See Selecting a Variant for the variant mapping and Resource Import for import properties.

Packages and Versions

Reference 2dog.engine from generic hosts:

<PackageReference Include="2dog.engine" Version="4.7.1.*"/>

Package versions begin with the embedded Godot version. Pin manual references to your project's Godot line, as above, so NuGet does not silently select a newer engine line. Projects scaffolded by 2dog configure package versions for you.

2dog.engine selects the platform meta package for the current OS: 2dog.win-x64, 2dog.linux-x64, or 2dog.osx-arm64. Each meta package pins the release, debug, and editor native packages. The selected native is copied as libgodot-<variant>.dll, .so, or .dylib and loaded by that name.

For xUnit, reference 2dog.xunit; it brings in 2dog.engine. Browser hosts also reference 2dog.browser-wasm; see Web / Browser for web-specific properties and packaging.

GodotSharp Directory

At build time, GODOTSHARP_DIR can select a source directory containing GodotPlugins.dll. At runtime, Engine.Start() points it at the copied output layout. See Miscellaneous Advanced Notes for source-checkout layouts.

Editor runtime limitations

TwoDogVariant=editor provides editor types and [Tool] support, but embedded libgodot does not initialize editor runtime singletons. Asset import runs in a separate helper process; see Resource Import.