Skip to content

Hosts ​

A host is a .NET application that starts Godot for your game or its tests. Each host has its own entry point and references your base game project.

You can have several hosts of the same type, each with its own project.

The host is what runs your game...

Illus. Diego Rago: a white anthro dog in a hacker hoodie getting pulled on the leash by their blue robot dog(but no worries, you can be totally in charge!)

Add a Host ​

Run this command from your Godot project directory, which contains project.godot:

bash
dnx 2dog add

When the command asks, choose the hosts. You can also use the flags below. For a new project, use dnx 2dog new MyGame instead.

If you add -y and no host flags, the command adds the generic .NET and Web hosts. See Project Layout for files and MSBuild Configuration for shared settings.

Console ​

HostFlagPurpose
2dog (generic .NET)--generic.NET console application (desktop or headless)
REPL--replInteractive C# inside the running game (opt-in)

Desktop ​

HostFlagPurpose
Avalonia--avaloniaCross-platform desktop UI
Qt Quick--qtQML UI with Qt Bridge for C# (experimental)
WinForms--winformsWindows Forms UI
WinUI 3--winuiWindows App SDK UI

Web ​

HostFlagPurpose
Blazor--blazorGame inside a Blazor page
Web--webWASM / HTML5 browser bundle (e.g. for itch.io)
WebXR--webxrBrowser VR and AR

Mobile ​

HostFlagPurpose
Android--androidAndroid APK (experimental)
iOS--iosiOS app built on a Mac (experimental)
MAUI--mauiWindows, Android and iOS UI with an embedded Godot view

Testing ​

HostFlagPurpose
GdUnit--gdunitGDScript suites through embedded Godot and MTP
NUnit--nunitNUnit tests that use the Godot engine (opt-in)
xUnit--xunitxUnit tests that use the Godot engine (opt-in)

2dog is Free and Libre Open Source under the MIT License.
2dog is not affiliated with or endorsed by the Godot Foundation.
Godot is licensed under the MIT License; the Godot logo is by Andrea Calabró under CC BY 4.0. @icons made by Voxy under the MIT License.
Continuous Integration compute graciously supported by Blacksmith.