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.
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.
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
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.
| Örnek | Nasıl açılır | Ne gösterir |
|---|---|---|
| Galeri | examples/gallery/gallery.tscn · F6 | Her widget, kurulu her ön ayar için bir seçici ve simge setinin tamamı |
| Ortaçağ | examples/medieval/medieval.tscn · F6 | Bir 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 && godot | Galeriyi, 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 — 1–4 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 →