Window in Godot – Complete Guide

Welcome to the exciting world of game development with Godot 4! As we dive into this tutorial, we’ll unlock the potentials of the Window class—a versatile and powerful feature that grants us the ability to create and control windows, dialogues, and popups in our games and applications. Understanding how to manipulate window properties and behaviors is crucial for optimizing user experience and interactivity in your projects. Whether you’re just starting out or looking to add another layer of polish to your skills, mastering the Window class can give your projects that professional touch.

What is the Window Class?

The Window class in Godot 4 serves as the base class for all types of windows, dialogs, and popups. It’s a part of the visual interface that developers can use to create both system-native windows and custom ones that are embedded within the game environment. For those coming from web development or software engineering backgrounds, you can liken the Window class to handling browser window events or operating system window management.

What is it for?

Windows are the canvases for our gameplay and user interface. They allow us to present information, gather player input, and create compelling navigational structures. A well-designed window can help players understand game controls, keep track of their progress, and immerse themselves in the game world.

Why Should I Learn It?

Understanding the Window class is essential for anyone wanting to create polished and user-friendly games or applications with Godot 4. It is a gateway to:

– Designing responsive and attractive game interfaces.
– Creating multiple layers of interaction within your game.
– Improving usability by managing how and when windows appear or behave.
– Integrating advanced features like handling DPI changes or system file drops.

By mastering the Window class, developers of all levels can take their projects to new heights, offering users not merely a game but a fully-fledged experience. Let’s begin by exploring how to implement some of the basic functionalities of the Window class in Godot 4.

CTA Small Image

Creating Basic Windows with the Window Class

Let’s start by creating a simple window which can be opened and closed within your game. This functionality is crucial when you want to introduce settings, pause menus, or secondary information panels.

var window =
window.window_title = "My Game Window"
window.rect_min_size = Vector2(400, 300)

The code above creates a new window, sets a minimum size, and adds a title. Remember that window sizes are managed through the ‘rect_min_size’ property to ensure content visibility.

Next, we can let the users control the window by opening and closing it with a button press.

func _on_OpenWindowButton_pressed():
    window.popup_centered(Vector2(400, 300)) # Open in the center with the specified size
func _on_CloseWindowButton_pressed():
    window.hide() # Hide the window

Here we introduced functions that respond to button presses to open and close our window. Note the use of `popup_centered` to display the window neatly in the center of the screen.

Customizing Window Behavior

Godot’s Window class allows for deep customization. For instance, you may want to ensure that your window always stays on top of all the other UI elements. For that, you can set the ‘always_on_top’ property.

window.always_on_top = true

But what if you wanted to keep the game running even when a window is open? By default, Godot pauses the game when a modal window is opened. To change that, we can modify the ‘pause_mode’ property:

window.pause_mode = Window.PAUSE_MODE_PROCESS

This code snippet ensures that the game continues to run in the background even when our window is active and visible.

To handle resizing and moving events, connecting to window signals can be extremely useful.

window.connect("resized", self, '_on_Window_resized')
window.connect("moved", self, '_on_Window_moved')

func _on_Window_resized():
    print("The window was resized!")

func _on_Window_moved():
    print("The window was moved!")

Now, every time the window is resized or moved, our functions will be called, allowing us to perform certain actions in response, such as adjusting layout components or saving the new position.

The code examples provided here establish the foundation for working with windows in Godot 4. As we continue in this tutorial, we’ll delve into advanced customization and utilize these windows in practical game development scenarios. Stay tuned for the third installment where we’ll explore dialog creation and management!Great! Now let’s delve deeper into dialog creation within the Godot 4 Window class. With the basics of window management under our belt, it’s time to customize our windows to create interactive and dynamic dialogs that engage the player.

One of the most common forms of dialogs in games is the confirmation dialog. For example, you might want to confirm a player’s action such as quitting a game or deleting saved data.

var confirm_dialog =
confirm_dialog.window_title = "Confirm Action"
confirm_dialog.dialog_text = "Are you sure you want to quit?"

var ok_button =
ok_button.text = "Yes"
ok_button.connect("pressed", self, "_on_ConfirmationDialog_confirmed")

var cancel_button =
cancel_button.text = "No"
cancel_button.connect("pressed", self, "_on_ConfirmationDialog_canceled")

func _on_ConfirmationDialog_confirmed():

func _on_ConfirmationDialog_canceled():

Here, we created a new `WindowDialog` object, which is a specialized version of the Window class for yes/no and similar questions. We also added “Yes” and “No” buttons and connected them to their respective functions.

Now let’s suppose we want to create a pop-up window to display information such as a narrative text or instructions to the player.

var info_dialog =
info_dialog.window_title = "Story"
info_dialog.dialog_text = "Your adventure begins..."

func _on_OpenInfoButton_pressed():
    info_dialog.popup_centered_clamped(Vector2(400, 300), 0.75)

The `popup_centered_clamped` function opens the dialog in the center of the screen, but uses an additional parameter to ensure that it doesn’t exceed a certain proportion of the screen size, in this case, 75%.

Moving forward, what about creating a custom dialog that allows the player to choose from multiple options? We can achieve this by populating our dialog with a collection of buttons or a dropdown.

var choice_dialog =
choice_dialog.window_title = "Choose Your Character"

var character_options =

character_options.connect("item_selected", self, "_on_CharacterChosen")

func _on_CharacterChosen(index):
    print("Player chose character: ", character_options.get_item_text(index))

This script makes use of the `AcceptDialog` class, which like `WindowDialog`, is a subclass of `Window`. The `OptionButton` is used for the selection, and we connect the `item_selected` signal to a function that handles the choice.

Now imagine a scenario where the player needs to enter text, such as naming their character. An input dialog can be utilized in this instance.

var input_dialog =
input_dialog.window_title = "Name Your Character"

var name_input =
name_input.placeholder_text = "Enter your character's name"

var submit_button =
submit_button.text = "Done"
submit_button.connect("pressed", self, "_on_NameSubmitted")

func _on_NameSubmitted():
    var player_name = name_input.text
    print("Player's character is named: ", player_name)

In the code above, `LineEdit` is being used for text input, and we connect our button to a function that records the entered name and hides the dialog once the name has been submitted.

These examples demonstrate just a fraction of the functionality and flexibility afforded by the Godot 4 Window class. With these tools in hand, you’re well on your way to creating engaging and interactive experiences for your players. Enjoy crafting your game’s interfaces and dialogs, and remember to test different window properties and settings to deliver the most intuitive and accessible design for your audience!Expanding on our dialog creation, let’s consider a settings window that offers different configuration options for the player to adjust. These settings might include audio volume, graphics quality, and control settings – common customization that enhances the user experience.

First, let’s lay out the basic window for our settings.

var settings_window =
settings_window.window_title = "Settings"

Now, for audio settings, we might include a slider for volume control:

var volume_slider =
volume_slider.min_value = 0
volume_slider.max_value = 100
volume_slider.step = 1
volume_slider.value = 80 # Assume the default volume is set to 80%
volume_slider.connect("value_changed", self, "_on_VolumeSlider_value_changed")

func _on_VolumeSlider_value_changed(value):
    print("Volume changed to: ", value)

Next, we add a dropdown for selecting graphics quality, which could change the rendering quality or enable features like anti-aliasing.

var graphics_dropdown =
graphics_dropdown.connect("item_selected", self, "_on_GraphicsQuality_selected")

func _on_GraphicsQuality_selected(index):
    print("Graphics quality set to: ", graphics_dropdown.get_item_text(index))

For control settings, let’s provide an option for the player to choose between different control schemes or input devices.

var control_scheme_picker =
control_scheme_picker.connect("item_selected", self, "_on_ControlScheme_selected")

func _on_ControlScheme_selected(index):
    print("Control scheme chosen: ", control_scheme_picker.get_item_text(index))

If players need to revert to default settings easily, a button for resetting all settings comes in handy:

var reset_button =
reset_button.text = "Reset to Defaults"
reset_button.connect("pressed", self, "_on_ResetButton_pressed")

func _on_ResetButton_pressed():
    volume_slider.value = 80 # Assuming 'Medium' is the default # Assuming 'Keyboard' is the default
    print("Settings have been reset to defaults.")

Lastly, it’s also important to give players the option to save their preferences. A save button would not only update the relevant properties but could also interact with a configuration file or a database.

var save_button =
save_button.text = "Save Changes"
save_button.connect("pressed", self, "_on_SaveButton_pressed")

func _on_SaveButton_pressed():
    # Save the settings (to be implemented)
    print("Settings saved!")

In this section, we’ve demonstrated how to create a versatile settings dialog that includes various types of interactive control elements. These components like sliders for volume adjustment, dropdowns for graphics options, and buttons for action management are essential in crafting a user-friendly environment.

This approach for scripting settings and preferences not only illustrates the Window class’s capability for intricate UI elements but also highlights the benefit of learning signal connections in Godot. By tapping into this knowledge, you can create an intuitive and player-centric interface within your games and applications.

Continuing Your Game Development Journey with Godot 4

We hope you’ve found this tutorial insightful and that it has sparked a deeper interest in game development using the Godot 4 engine. The Window class is just the beginning—there’s a vast playground waiting for you to explore and create within. If you’re eager to keep learning and expand your skills, we have just the right resources to help you on your journey.

For a more comprehensive learning experience, consider checking out our Godot Game Development Mini-Degree. This collection of courses will take you through the intricacies of the Godot 4 engine, covering topics from 2D and 3D asset creation to gameplay mechanics and UI design. Whether you’re just starting or looking to refine your expertise, our mini-degree is structured to accommodate your learning pace and advance your knowledge.

If you’re searching for a broader spectrum of Godot tutorials, you can find a full selection in our Godot courses. At Zenva, we’re dedicated to helping you achieve your goals, from your very first steps in programming to creating intricate game worlds that delight and challenge players. Embrace your game development aspirations with Zenva, and let’s code something extraordinary together!


As you’ve journeyed through the ins and outs of the Godot 4 Window class with us, we hope you’ve discovered the robust capabilities at your disposal for crafting interactive and responsive game interfaces. Your newfound skills are a stepping stone to building more immersive and professional games that captivate and engage players. Remember, every great game is an amalgamation of powerful storytelling and seamless user experience—and you’re now equipped to enhance both with Godot 4.

Don’t stop here! Continue to refine your craft and delve into the full breadth of game development with our Godot Game Development Mini-Degree. We at Zenva are excited to be part of your learning journey and can’t wait to see the amazing games you’ll create. Happy coding, and may your passion for game development be the driving force behind every line of code you write!

Python Blog Image

FINAL DAYS: Unlock coding courses in Unity, Godot, Unreal, Python and more.