Installer gohud

Installation

Déposez le dossier de l'add-on dans votre projet. Il n'y a rien d'autre à configurer.

Depuis l'Asset Store ou un ZIP de version

Décompressez à la racine de votre projet pour obtenir res://addons/gohud/. C'est tout. Vous pouvez éventuellement activer Projet → Paramètres du projet → Extensions → gohud.

En sous-module git

git submodule add https://github.com/thruthesky/gohud.git addons/gohud
git submodule update --init
git -C addons/gohud checkout v1.0.0   # facultatif : fixer un tag ou un commit

La racine du dépôt est le dossier de l'add-on : il atterrit donc exactement là où Godot l'attend. Modifiez-le sur place, committez et poussez depuis addons/gohud, puis committez le pointeur de sous-module dans votre jeu.

Démarrage rapide

Chaque widget se crée avec .new() puis add_child() — aucun fichier de scène, aucun autoload.

Choisissez une apparence avant de construire l'UI (facultatif)

GoUi.use_preset(GoThemePresets.SCIFI_DARK)   # default_dark est utilisé si vous sautez cette étape

Une confirmation que vous await

var dialogs := GoDialogs.new()
add_child(dialogs)
if await dialogs.confirm("Supprimer la sauvegarde", "Cette action est irréversible."):
    delete_save()

Passez destructive = true (le dernier argument) et le bouton de confirmation est dessiné comme un bouton de danger plein.

Une feuille inférieure avec champ de recherche et pied de page fixes

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

Un coin de 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 = "PV"
hp.ink = GoUi.color(GoTheme.DANGER_FILL)
corner.add_child(hp)
hp.set_values(320, 500)

Un contenu qui reste à l'écart du HUD

form.avoid_hud = true                  # reste à l'écart de chaque GoHudAnchor visible
joystick_anchor.reserve_space = false  # …sauf ceux qui n'apparaissent que sous un doigt
notice_anchor.avoid_peers = true       # un toast se pose sous le HUD fixe au lieu de le recouvrir

Chaque rectangle est contourné dans la direction qui coûte le moins de surface — vers le bas sur un téléphone en portrait, sur le côté en paysage. Comment le HUD s'évite lui-même →

Des exemples que vous pouvez exécuter

Trois façons de voir gohud avant d'écrire une ligne — aucune ne demande de serveur ni d'autoload.

cd examples/demo && godot                             # écran d'accueil ; liens et imports au premier lancement
bash examples/demo/run.sh                               # la même application, depuis la racine de l'add-on
bash examples/demo/run.sh -- --open=gallery             # saute l'écran d'accueil
bash examples/demo/run.sh -- --explore=surfaces         # ouvre directement sur un chapitre de la visite
bash examples/demo/run.sh --record /tmp/gohud-demo.avi  # enregistrement de la visite en 1080p / 60 ips

L'application de démo ne demande aucune configuration : si le lien vers l'add-on ou le cache d'import manque, elle le signale, répare le dossier et se rouvre. Son écran d'accueil ouvre chaque exemple dans la même fenêtre — appuyez sur 1–4 ou cliquez sur une rangée, et la barre du haut vous y ramène.

Dans la visite, C active le mode cinéma, F11 le plein écran, Espace met en pause (ou joue le widget courant en mode exploration), les flèches changent de chapitre et Échap ramène à l'écran de départ.

Vous utilisez un agent de codage IA ? Ouvrez les trois avec une seule commande →