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, iOS, visionOS та Android пропонують лише один варіант. Натомість у Linux є два варіанти: X11 та Wayland.
X11 — це застарілий стандарт, який більшість дистрибутивів Linux поступово виводять з ужитку на користь підтримки Wayland, розробленого як його заміна. Wayland покликаний забезпечити сучасну функціональність, пропонуючи при цьому більш надійну модель безпеки порівняно з X11. Програми, що працюють на X11, можуть і надалі функціонувати навіть у дистрибутивах, які використовують Wayland, завдяки шару сумісності, відомому як Xwayland.
Підтримка Godot ще перебуває на стадії розробки, тому наразі X11 залишається налаштуванням за замовчуванням для проектів. Ймовірно, це зміниться в майбутніх версіях.
Коли використовувати Wayland
Якщо ви розробник двигуна і хочете допомогти поліпшити підтримку, або якщо ви вважаєте, що Xwayland з якихось причин може спричиняти візуальні збої у вашому експортованому проєкті, то ми рекомендуємо використовувати Wayland. В інших випадках на даний момент рекомендується залишатися на X11. Важливо зазначити, що хоча програми X11 можуть працювати на Wayland, зворотне не є правдою.
Станом на червень 2026 року більшість популярних дистрибутивів за замовчуванням використовують Wayland, зокрема (але не обмежуючись цим) такі:
SteamOS
Bazzite
CachyOS
Fedora
Fedora Silverblue
Ubuntu
OpenSUSE
Майте на увазі, що в деяких дистрибутивах, таких як Ubuntu, користувачі могли самостійно вручну змінити сервер відображення на X11.
Зміна налаштувань сервера відображення
Щоб змінити сервер відображення на Wayland, натисніть , після чого перейдіть до і змініть значення параметра на wayland.
Також можна тимчасово змінити сервер відображення за --display-server <x11|wayland> допомогою аргументу командного рядка під час запуску проєкту.
Примітка
Незалежно від того, як налаштований сервер відображення, якщо проект налаштований на використання Wayland, він автоматично перейде на X11, якщо Wayland недоступний.
Це також відбувається і в зворотному напрямку: якщо проект налаштований на використання X11, він перейде на Wayland, якщо X11 недоступний (тобто коли Xwayland відсутній у системі).
Вимкнення завантаження libdecor
libdecor під час завантаження в Wayland може проявляти деякі особливості; залежно від ситуації може бути доцільним вимкнути її. Для цього потрібно встановити значення змінної середовища GODOT_WAYLAND_DISABLE_LIBDECOR на 1, як показано нижче:
OS.set_environment("GODOT_WAYLAND_DISABLE_LIBDECOR", "1")
Підтримка високого динамічного діапазону
Godot підтримує HDR-вивід у Linux, починаючи з версії 4.7. Однак через обмеження сервера відображення HDR-вивід підтримується лише у Wayland, а не в X11 (навіть через Xwayland).
Отже, щоб скористатися HDR-виводом, необхідно налаштувати сервер відображення на Wayland.
Примітка
У версіях GNOME до 50 є помилка, яка заважає роботі HDR-виводу в Wayland. Якщо ви використовуєте старішу версію GNOME, вам потрібно буде оновити її до версії 50 або пізнішої, щоб користуватися HDR-виводом у Wayland.