gohud

gohud kurulumu

İki yol var. Yapay zekâ ajanınıza yaptırın ya da klasörü projenize bırakın — başka ayarlanacak bir şey yok.

En hızlı yol — kurulumu yapay zekâ ajanınıza bırakın

Claude Code, Codex, Cursor ya da Gemini CLI'a yapıştırılan tek bir metin bloğu hem beceriyi hem eklentiyi kurar, sonra size gohud'u anlatır. Bu yolu seçerseniz bu kartın altındakilerin hiçbiri gerekmez.

AI SKILL sayfasını aç →

Kurulum

Eklenti klasörünü projenize koyun. Kurulacak başka bir şey yok.

Asset Store'dan veya bir sürüm ZIP'inden

Proje kökünüze çıkarın; sonuçta res://addons/gohud/ elde etmelisiniz. Hepsi bu. İsterseniz Project → Project Settings → Plugins → gohud yolundan etkinleştirin.

git submodule olarak

git submodule add https://github.com/thruthesky/gohud.git addons/gohud
git submodule update --init
git -C addons/gohud checkout v1.0.0   # isteğe bağlı: bir etikete veya commit'e sabitle

Deponun kökü doğrudan eklenti klasörüdür, yani tam olarak Godot'un beklediği yere iner. Yerinde düzenleyin, addons/gohud içinde commit'leyip push'layın, sonra oyununuzda submodule işaretçisini commit'leyin.

Godot 4.6 veya daha yenisi gerekir. gohud, 4.5'te gelen API'leri kullanır (DPITexture, FoldableContainer, erişilebilirlik özellikleri); dolayısıyla daha eski her sürümde ayrıştırma sırasında hata verir. Desteklenen alt sınır 4.6'dır ve GoUi.MIN_ENGINE içinde kayıtlıdır.

Hızlı başlangıç

Her widget .new() ve add_child() ile gelir — sahne dosyası yok, autoload yok.

Arayüzü kurmadan önce bir görünüm seçin (isteğe bağlı)

GoUi.use_preset(GoThemePresets.SCIFI_DARK)   # bunu atlarsanız default_dark kullanılır

await ile beklediğiniz bir onay

var dialogs := GoDialogs.new()
add_child(dialogs)
if await dialogs.confirm("Kaydı sil", "Bu geri alınamaz."):
    delete_save()

destructive = true (son argüman) geçirin; onay düğmesi dolgulu tehlike düğmesi olarak çizilir.

Sabit bir arama alanı ve alt bilgisi olan bir alt sayfa

var sheet := GoSheet.new()
add_child(sheet)
sheet.open("Envanter")
sheet.toolbar().add_child(GoStyle.line_edit("Ara…"))
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("Kapat", sheet.close, GoStyle.Tone.PRIMARY))
sheet.footer().visible = true
Sabit satırlar neden kaydırılan gövdeden ayrı. Onay ve iptali body içine koyarsanız uzun bir liste onları ekrandan dışarı iter. footer() her zaman görünürdür.

Bir HUD köşesi

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'a değmeyen içerik

form.avoid_hud = true                  # görünen her GoHudAnchor'dan uzak dur
joystick_anchor.reserve_space = false  # …yalnızca parmak altında beliren anchor'lar hariç
notice_anchor.avoid_peers = true       # bildirim sabit HUD'ın üstünü kapatmak yerine altına yerleşir

Her dikdörtgenden, en az alana mal olan yönde kaçınılır — dikey tutulan bir telefonda aşağı doğru, yatayda yana doğru. HUD kendinden nasıl kaçınıyor →

Çalıştırabileceğiniz örnekler

Tek satır yazmadan gohud'u görmenin üç yolu — hiçbiri sunucu ya da autoload istemez.

ÖrnekNasıl açılırNe gösterir
Galeriexamples/gallery/gallery.tscn · F6Her widget, kurulu her ön ayar için bir seçici ve simge setinin tamamı
Ortaçağexamples/medieval/medieval.tscn · F6Bir karakter sayfası, heybe ve görev günlüğü; düğmeler demir ile parşömen arasında geçiş yapar ve nesne ayrıntılarını açar
Demo uygulamasıcd examples/demo && godotGaleriyi, 15 bölümlük rehberli turu, vitrin ekranını ve ortaçağ görünümünü açan bir ana ekran; canlı widget'lar ve sınıf başına bir kartla
cd examples/demo && godot                             # ana ekran; ilk çalıştırmada bağlar ve içe aktarır
bash examples/demo/run.sh                               # aynı uygulama, eklenti kökünden
bash examples/demo/run.sh -- --open=gallery             # ana ekranı atla
bash examples/demo/run.sh -- --explore=surfaces         # doğrudan turun tek bir bölümünü aç
bash examples/demo/run.sh --record /tmp/gohud-demo.avi  # turun 1080p / 60 fps kaydı

Demo uygulaması kurulum istemez: eklenti bağlantısı ya da içe aktarma önbelleği eksikse bunu söyler, klasörü onarır ve kendini yeniden açar. Ana ekranı her örneği aynı pencerenin içinde açar — 14 tuşlarına basın ya da bir satıra tıklayın; üstteki çubuk sizi geri getirir.

Turda C Sinema kipini açıp kapatır, F11 tam ekran yapar, Space duraklatır (keşif sırasında ise o anki widget'ı oynatır), oklar bölüm değiştirir ve Escape başlangıca döner.

Bir AI kodlama ajanı mı kullanıyorsunuz? Üçünü de tek komutla açın →