Installing Godot
What is Godot?
Godot is free software for creating games. It supports both 2D and 3D game development.
It serves a similar role to Unity, but Godot has a small file size and can be used immediately without an installer.
OpenForge works with Godot as well, letting you manipulate game scenes and objects using the power of AI.
Godot is open-source software that is completely free to use, including for commercial purposes. No account creation is required.
Step 1: Download Godot
- Open
https://godotengine.org/download/in your browser. - Download buttons for your OS (Windows or macOS) are displayed.
[Screenshot: Godot official download page]
- Click the download button.
The download page may show two options: "Godot Engine" and "Godot Engine - .NET".
- Godot Engine (standard): Uses GDScript, a language made specifically for Godot. Recommended for beginners.
- Godot Engine - .NET: A version that supports the C# language. Useful if you have C# experience or are migrating from Unity.
If unsure, choose the standard version (Godot Engine).
- A
.zipfile is downloaded.
Step 2: Extract (unzip) Godot
Unlike other software, Godot does not have an installer. Just extract (unzip) the downloaded ZIP file and it is ready to use.
Windows
- Find the downloaded
.zipfile (usually in your "Downloads" folder). - Right-click the
.zipfile. - Click "Extract All...".
[Screenshot: Right-clicking a ZIP file and selecting "Extract All"]
- A dialog appears asking where to extract. It is recommended to choose a convenient location, for example:
C:\Godot
- Click the "Extract" button.
[Screenshot: Extraction destination selection screen]
- When extraction finishes, the folder opens. Inside you will find a file like
Godot_v4.x-stable_win64.exe. This is the Godot executable.
[Screenshot: Extracted folder showing the Godot executable]
Right-click the Godot executable, then select "Show more options" > "Send to" > "Desktop (create shortcut)". This creates a desktop shortcut so you can launch Godot with a double-click next time.
Mac
- Double-click the downloaded
.zipfile. It is extracted automatically. - Drag and drop the extracted
Godot.appfile into the "Applications" folder.
[Screenshot: Dragging Godot.app into the Applications folder]
- Open the "Applications" folder and double-click "Godot" to launch it.
- If a warning says "This application was downloaded from the Internet", click "Open".
Step 3: Launch Godot
Windows
- Double-click
Godot_v4.x-stable_win64.exein the extracted folder.- If "Windows protected your PC" appears, click "More info" and then click "Run anyway".
[Screenshot: Windows SmartScreen warning with "More info" click location indicated]
Mac
- Double-click "Godot" in the "Applications" folder.
Project Manager screen
When Godot starts, the "Project Manager" screen appears. This is where you create and manage projects.
[Screenshot: Godot Project Manager screen]
Step 4: Create your first project
- Click the "New Project" button on the Project Manager screen.
[Screenshot: Arrow pointing to the New Project button]
- Configure the following:
- Project Name: Enter a name for the project, for example "TestProject".
- Project Path: Specify where to save the project. Click the "Browse" button to choose a convenient location.
- Renderer: Select the rendering method. If unsure, leave it as "Forward+".
[Screenshot: Project creation screen with fields filled in]
- Click the "Create & Edit" button.
- The Godot editor opens.
Step 5: Understand the editor layout
When the Godot editor opens, the screen is divided into several areas.
[Screenshot: Full Godot editor screen with labels on each area]
Viewport (center of the screen)
The main area displaying 3D space (or 2D space). This is where you view and edit the game world. Tabs labeled "2D", "3D", "Script", and "AssetLib" appear at the top for switching views.
Scene panel (upper left)
Shows a list of nodes (objects) in the current scene (game level). In Godot, all objects are called "nodes" and are organized in a tree structure (parent-child relationships).
Inspector (right side)
Displays and lets you edit the properties (settings) of the selected node, such as position, size, and color.
FileSystem panel (lower left)
Shows the files and folders in the project. Images, audio files, scripts, and other resources all appear here.
Output panel / Debugger (bottom of the screen)
Displays game execution results and error messages. Switch between the "Output" and "Debugger" tabs as needed.
Step 6: Check the plugin installation location
When using the OpenForge Godot plugin, plugins are placed in the addons folder inside the project folder.
- Check the "FileSystem" panel in the lower left of the Godot editor.
- Create an
addonsfolder at the root of the project.- Right-click
res://in the FileSystem panel. - Click "New Folder...".
- Enter
addonsas the folder name and click "OK".
- Right-click
[Screenshot: Right-clicking in the FileSystem panel and selecting New Folder]
- When installing a plugin, place the plugin folder inside
res://addons/.
res:// is a special path representing the root (top level) of the Godot project folder. For example, res://addons/ means the addons folder inside the project folder. The actual location on your computer's file system depends on where you saved the project.
- After placing a plugin, you need to enable it in the Godot editor under "Project" menu > "Project Settings..." > "Plugins" tab.
[Screenshot: Project Settings Plugins tab]
Come back here when the OpenForge setup instructions require it.
Common errors and solutions
Error 1: "Windows protected your PC" appears
Since Godot does not use an installer, the Windows security feature (SmartScreen) may show a warning.
- Click the "More info" text.
- A "Run anyway" button appears -- click it.
This does not mean Godot is dangerous. Windows is simply warning about an unfamiliar program. Godot is safe as long as it was downloaded from the official site.
[Screenshot: SmartScreen warning with the "Run anyway" button after clicking "More info"]
Error 2: Godot does not launch (Mac)
This may be caused by macOS security settings.
- Open "System Settings" > "Privacy & Security".
- Near the bottom, you should see a message that says "Godot was blocked because it is from an unidentified developer".
- Click "Open Anyway".
Error 3: Text is too small on screen
On high-resolution displays, text may appear very small.
- Open "Editor" menu > "Editor Settings...".
- Select "Interface" > "Editor" from the list on the left.
- Increase the "Display Scale" value (e.g., 150% or 200%).
- Restart Godot for the change to take effect.
Summary
You have now completed the following:
- Downloading and extracting (unzipping) Godot
- Launching Godot and creating a project
- Understanding the editor layout
- Locating the plugin installation folder (
res://addons/)
You are now ready to start working with Godot.