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

Огляд

Одним із важливих компонентів будь-якої операційної системи є її сервер відображення. Windows і macOS пропонують лише один варіант, тоді як у Linux їх два: X11 і Wayland.

X11 — це застарілий стандарт, який зараз поступово витісняється з більшості дистрибутивів Linux на користь Wayland, розробленого як його заміна. Програми, що працюють на X11, можуть і надалі функціонувати в дистрибутивах, які використовують Wayland, завдяки шару сумісності, відомому як Xwayland.

Підтримка Godot ще перебуває на стадії розробки, тому наразі X11 залишається стандартним налаштуванням для ігрових проєктів, хоча це, ймовірно, зміниться в майбутніх версіях.

Коли використовувати Wayland

Якщо ви розробник двигуна і хочете допомогти поліпшити підтримку, або якщо ви вважаєте, що Xwayland з якихось причин може спричиняти візуальні збої у вашому експортованому проєкті, то ми рекомендуємо використовувати Wayland. В інших випадках на даний момент рекомендується залишатися на X11. Важливо зазначити, що хоча програми X11 можуть працювати на Wayland, зворотне не є правдою.

Станом на січень 2026 року найпопулярніші дистрибутиви за замовчуванням використовують Wayland, зокрема такі (але не обмежуючись ними):

  • SteamOS

  • Bazzite

  • CachyOS

  • Fedora

  • Fedora Silverblue

  • Ubuntu

  • OpenSuse

Майте на увазі, що в деяких дистрибутивах, таких як Ubuntu, користувачі могли самостійно вручну змінити сервер відображення на X11.

Зміна налаштувань

Щоб змінити сервер відображення на Wayland, натисніть Project > project settings, звідти перейдіть до Display Server і змініть значення параметра driver.linuxbsd на wayland.

Вимкнення завантаження Libdecor

Завантаження Libdecor у Wayland має деякі особливості, і залежно від ситуації може бути корисно вимкнути його. Для цього потрібно встановити значення змінної середовища GODOT_WAYLAND_DISABLE_LIBDECOR на 1, як показано нижче:

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