Window

Category: Executor Tier: Basic

Purpose

Controls the application window state, including fullscreen mode, resolution, and border visibility.

Visual Reference

As added to your scene

Runtime Behavior

Inputs

• Activate (Pulse): Applies the window settings.

Outputs None.

Properties

• Mode (String, “Windowed”): “Windowed”, “Fullscreen”, “Exclusive Fullscreen”, “Maximized”, “Minimized”.

• Resolution (Vector2, (1920, 1080)): Target resolution (pixels). Valid only in Windowed/Fullscreen modes (depending on OS).

• Borderless (Bool, false): Remove window borders (for “Borderless Windowed” feel).

• V-Sync (Bool, true): Enable Vertical Sync (Maps to DisplayServer.VSYNC_ENABLED/DISABLED).

Execution Behavior

Connect Logic

• None.

Tick Behavior

• When activated:

  • Mode: Maps string to DisplayServer.WINDOW_MODE_*.

    • “Windowed” -> WINDOW_MODE_WINDOWED

    • “Fullscreen” -> WINDOW_MODE_FULLSCREEN (Note: Godot 4 treats this as “Borderless Fullscreen” usually, “Exclusive” is separate).

    • “Exclusive Fullscreen” -> WINDOW_MODE_EXCLUSIVE_FULLSCREEN

  • Resolution: Calls DisplayServer.window_set_size(size).

    • Centering Logic: When switching to “Windowed”, calculate center: screen_pos + (screen_size / 2) - (window_size / 2). Use DisplayServer.screen_get_position() and screen_get_size(). Essential to prevent top-left jumping.

  • Borderless: Calls DisplayServer.window_set_flag(DisplayServer.WINDOW_FLAG_BORDERLESS, value).

  • V-Sync: Maps boolean to Enum.

    • true -> DisplayServer.window_set_vsync_mode(DisplayServer.VSYNC_ENABLED)

    • false -> DisplayServer.window_set_vsync_mode(DisplayServer.VSYNC_DISABLED)

State Changes None.

Examples

…

Generated UI Mockup — showing expanded properties

Window

-

x

Name:

Label this brick...

Mode:

Windowed

Verbose

Properties

Property	Type	Default	Notes
Mode	option	Windowed	Window mode to apply when this brick activates
Verbose	bool	False	Log window mode change to console (controlled by ladybug button)