Встановлення gohud

Найшвидший шлях — доручіть встановлення ШІ-агенту

Один блок тексту, вставлений у Claude Code, Codex, Cursor чи Gemini CLI, встановить і навичку, і доповнення, а тоді пояснить вам gohud. На цьому шляху ніщо нижче цієї картки не потрібне.

Відкрити сторінку AI SKILL →

Встановлення

Покладіть теку доповнення у свій проєкт. Більше нічого налаштовувати не треба.

З Asset Store або ZIP-архіву релізу

Розпакуйте в корінь проєкту так, щоб вийшло res://addons/gohud/. Це все. За бажання увімкніть Проєкт → Параметри проєкту → Плагіни → gohud.

Як підмодуль git

git submodule add https://github.com/thruthesky/gohud.git addons/gohud
git submodule update --init
git -C addons/gohud checkout v1.0.0   # необов'язково: закріпити тег або коміт

Корінь репозиторію і є текою доповнення, тож він лягає рівно туди, де його чекає Godot. Редагуйте на місці, комітьте й пуште всередині addons/gohud, а тоді закомітьте вказівник підмодуля у своїй грі.

Потрібен Godot 4.6 або новіший. gohud користується API, що з'явилися в 4.5 (DPITexture, FoldableContainer, властивості доступності), тож на будь-чому старішому він падає ще на розборі. 4.6 — підтримувана нижня межа, записана в GoUi.MIN_ENGINE.

Швидкий старт

Кожен віджет — це .new() та add_child(): жодних файлів сцен, жодного автозавантаження.

Виберіть образ до того, як будувати UI (необов'язково)

GoUi.use_preset(GoThemePresets.SCIFI_DARK)   # якщо пропустити, буде default_dark

Підтвердження, на яке ви робите `await`

var dialogs := GoDialogs.new()
add_child(dialogs)
if await dialogs.confirm("Видалити збереження", "Цю дію не можна скасувати."):
    delete_save()

Передайте destructive = true (останній аргумент) — і кнопка підтвердження намалюється як залита кнопка небезпеки.

Нижній аркуш із липким полем пошуку та підвалом

var sheet := GoSheet.new()
add_child(sheet)
sheet.open("Інвентар")
sheet.toolbar().add_child(GoStyle.line_edit("Пошук…"))
sheet.toolbar().visible = true
for item in items:
    sheet.body.add_child(GoStyle.list_button(GoIconSet.BOX, item.name, _use.bind(item),
        Color.TRANSPARENT, item.description, false))
sheet.footer().add_child(GoStyle.button("Закрити", sheet.close, GoStyle.Tone.PRIMARY))
sheet.footer().visible = true

Чому липкі рядки відокремлені від тіла з прокруткою. Покладіть підтвердження та скасування в body — і довгий список виштовхне їх за екран. footer() видно завжди.

Куток HUD

var corner := GoHudAnchor.new()
corner.spot = GoHudAnchor.Spot.TOP_LEFT
corner.landscape_spot = GoHudAnchor.Spot.TOP_RIGHT
add_child(corner)

var hp := GoBar.new()
hp.label_text = "HP"
hp.ink = GoUi.color(GoTheme.DANGER_FILL)
corner.add_child(hp)
hp.set_values(320, 500)

Вміст, що тримається осторонь HUD

form.avoid_hud = true                  # обходити кожен видимий GoHudAnchor
joystick_anchor.reserve_space = false  # …окрім тих, що з'являються лише під пальцем
notice_anchor.avoid_peers = true       # снекбар осідає під нерухомим HUD, а не накриває його

Кожен прямокутник обходиться в тому напрямку, який коштує найменше площі — униз на телефоні в портреті, убік у ландшафті. Як HUD обходить сам себе →

Приклади, які можна запустити

Три способи побачити gohud, не написавши ані рядка, — жодному не потрібні ні сервер, ні автозавантаження.

Приклад	Як відкрити	Що показує
Галерея	`examples/gallery/gallery.tscn` · F6	Кожен віджет, список вибору для всіх встановлених пресетів і повний набір іконок
Середньовіччя	`examples/medieval/medieval.tscn` · F6	Картка персонажа, торба та журнал завдань; кнопки перемикають залізо й пергамент і відкривають подробиці предметів
Застосунок демо	`cd examples/demo && godot`	Домашній екран, що відкриває галерею, екскурсію з 15 розділів, вітринний екран і середньовічний образ, із живими віджетами й однією карткою на клас

cd examples/demo && godot                             # домашній екран; при першому запуску створює посилання й імпортує
bash examples/demo/run.sh                               # той самий застосунок, із кореня доповнення
bash examples/demo/run.sh -- --open=gallery             # пропустити домашній екран
bash examples/demo/run.sh -- --explore=surfaces         # відкрити одразу на одному розділі екскурсії
bash examples/demo/run.sh --record /tmp/gohud-demo.avi  # запис екскурсії 1080p / 60 к/с

Застосунок демо не потребує налаштування: якщо бракує посилання на доповнення чи кешу імпорту, він про це скаже, полагодить теку й перевідкриє себе. Його домашній екран відкриває кожен приклад у тому самому вікні — натисніть 1–4 чи клацніть рядок, а смуга вгорі поверне вас назад.

В екскурсії C вмикає кінорежим, F11 — повний екран, Пробіл ставить на паузу (або програє поточний віджет у режимі дослідження), стрілки міняють розділи, а Escape повертає на початок.

Користуєтеся AI-агентом для написання коду? Відкрийте всі три однією командою →

Встановлення gohud

Найшвидший шлях — доручіть встановлення ШІ-агенту