Instalacja gohud

Instalacja

Wrzuć folder dodatku do swojego projektu. Nie ma nic więcej do ustawienia.

Z Asset Store albo z ZIP-a wydania

Rozpakuj do katalogu głównego projektu, tak aby powstało res://addons/gohud/. To wszystko. Opcjonalnie włącz Projekt → Ustawienia projektu → Wtyczki → gohud.

Jako submoduł git

git submodule add https://github.com/thruthesky/gohud.git addons/gohud
git submodule update --init
git -C addons/gohud checkout v1.0.0   # opcjonalnie: przypnij tag albo commit

Katalog główny repozytorium jest folderem dodatku, więc ląduje dokładnie tam, gdzie Godot się go spodziewa. Edytuj na miejscu, commituj i wypychaj wewnątrz addons/gohud, a potem zacommituj wskaźnik submodułu w swojej grze.

Szybki start

Każdy widżet to .new() i add_child() — bez plików scen, bez autoloadu.

Wybierz wygląd, zanim zbudujesz UI (opcjonalnie)

GoUi.use_preset(GoThemePresets.SCIFI_DARK)   # gdy to pominiesz, użyty zostanie default_dark

Potwierdzenie, na które czekasz przez await

var dialogs := GoDialogs.new()
add_child(dialogs)
if await dialogs.confirm("Usuń zapis", "Tego nie da się cofnąć."):
    delete_save()

Przekaż destructive = true (ostatni argument), a przycisk potwierdzenia zostanie narysowany jako wypełniony przycisk niebezpieczeństwa.

Dolny arkusz z przyklejonym polem wyszukiwania i stopką

var sheet := GoSheet.new()
add_child(sheet)
sheet.open("Ekwipunek")
sheet.toolbar().add_child(GoStyle.line_edit("Szukaj…"))
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("Zamknij", sheet.close, GoStyle.Tone.PRIMARY))
sheet.footer().visible = true

Narożnik 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)

Treść, która omija HUD

form.avoid_hud = true                  # omijaj każdy widoczny GoHudAnchor
joystick_anchor.reserve_space = false  # …poza tymi, które pojawiają się dopiero pod palcem
notice_anchor.avoid_peers = true       # powiadomienie osiada pod stałym HUD, zamiast go zasłaniać

Każdy prostokąt omijany jest w tym kierunku, który kosztuje najmniej powierzchni — w dół na telefonie w pionie, na bok w poziomie. Jak HUD omija sam siebie →

Przykłady, które możesz uruchomić

Trzy sposoby, by zobaczyć gohud przed napisaniem linijki — żaden nie potrzebuje serwera ani autoloadu.

cd examples/demo && godot                             # ekran główny; dowiązania i import przy pierwszym uruchomieniu
bash examples/demo/run.sh                               # ta sama aplikacja, z katalogu głównego dodatku
bash examples/demo/run.sh -- --open=gallery             # pomiń ekran główny
bash examples/demo/run.sh -- --explore=surfaces         # otwórz od razu na jednym rozdziale przewodnika
bash examples/demo/run.sh --record /tmp/gohud-demo.avi  # nagranie przewodnika w 1080p / 60 kl./s

Aplikacja demo nie potrzebuje żadnej konfiguracji: jeśli brakuje dowiązania do dodatku albo pamięci podręcznej importu, mówi o tym, naprawia folder i otwiera się ponownie. Jej ekran główny otwiera każdy przykład wewnątrz tego samego okna — naciśnij 1–4 albo kliknij wiersz, a pasek u góry zabierze cię z powrotem.

W przewodniku C przełącza tryb kinowy, F11 pełny ekran, Spacja pauzuje (albo odtwarza bieżący widżet w trybie eksploracji), strzałki zmieniają rozdziały, a Escape wraca na ekran startowy.

Używasz agenta AI do kodowania? Otwórz wszystkie trzy jednym poleceniem →