Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Wayland/X11

Panoramica

Uno dei componenti fondamentali di qualsiasi sistema operativo è il suo server di visualizzazione. Windows e macOS offrono una sola opzione, mentre Linux ne ha due: X11 e Wayland.

X11 è uno standard più vecchio e la maggioranza delle distribuzioni Linux lo sta gradualmente abbandonando a favore di Wayland, che è sviluppato come suo sostituto. Le applicazioni si basano su X11 possono comunque funzionare anche se una distribuzione usa Wayland, grazie a un livello di compatibilità chiamato Xwayland.

Il supporto di Godot è ancora in fase di sviluppo, quindi per ora X11 rimane l'impostazione predefinita per i progetti di gioco, che probabilmente cambierà in una versione futura.

Quando utilizzare Wayland

If you're an engine developer who wants to help improve support, or if you think Xwayland might be causing visual glitches in your exported project for whatever reason, then we would recommend using Wayland. But outside of that it's recommended to stick with X11 for now. It's important to note that while X11 applications can run on Wayland, the reverse is not true.

A gennaio 2026, la maggioranza delle distribuzioni più diffuse utilizza Wayland come predefinito, tra cui, ma non solo, le seguenti:

  • SteamOS

  • Bazzite

  • CachyOS

  • Fedora

  • Fedora Silverblue

  • Ubuntu

  • OpenSuse

Tieni presente che per alcune distribuzioni, come Ubuntu, gli utenti potrebbero aver cambiato manualmente il server grafico impostandolo su X11.

Cambiare l'impostazione

Per cambiare il server di visualizzazione in Wayland, clicca su Project > project settings, da qui, vai su Display Server e cambia l'opzione driver.linuxbsd in wayland.

Disabilitare il caricamento di Libdecor

Caricare LibDecor su Wayland prevede alcune peculiarità e potrebbe essere utile disabilitarlo a seconda della situazione. Per farlo, è necessario impostare la variabile d'ambiente GODOT_WAYLAND_DISABLE_LIBDECOR su 1 in questo modo:

OS.set_environment("GODOT_WAYLAND_DISABLE_LIBDECOR", "1")