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.

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, натисніть Project > Project Settings, після чого перейдіть до Display Server і змініть значення параметра driver.linuxbsd на 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.