Introduction
Galdur UI est la bibliothèque d’interface de Galdur Studio pour les mods NeoForge : fenêtres décrites en code, menus à cases, widgets au thème Galdur, et un thème que les packs de ressources peuvent changer.
⏱ 4 minGaldur UI 0.1.0Client et serveur
Ce qu’elle fait
Tu décris un écran, Galdur UI fait la mise en page. Pas de coordonnées, pas de tailles, pas de sous-classe de Screen pour les fenêtres simples.
- Fenêtres déclaratives (
GaldurWindow) : titres, texte, boutons, rangées, listes, champs de recherche, cases à cocher, barres de progression et onglets, chacun avec un handle pour le modifier ensuite. - Menus à cases (
GaldurMenuetGaldurContainerScreen) : grilles de cases et inventaire du joueur, Maj-clic compris. - Widgets (
api.widget) : bouton, bouton icône, texte, case à cocher, champ de recherche, liste qui défile, onglets, barre de progression, case d’objet, et une grille d’objets défilante pour des milliers d’objets. - Un thème : couleurs et espacements dans
theme.json, relus avec les ressources et modifiables par un pack de ressources. - Les finitions : narration de chaque widget en anglais et en français, animations courtes que le joueur peut couper, intégrations JEI et EMI optionnelles.
Versions
| Version | |
|---|---|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.x |
| Java | 21 |
| Galdur UI | 0.1.0 |
Galdur UI est un mod à part : les joueurs l’installent à côté du tien, il n’est pas inclus dans ton jar.
Trois règles
À lire avant d’écrire du code
- N’utilise que
com.galdurstudio.galdurui.api.*.internal.*peut changer à chaque version. - Tout sauf
api.menuest côté client uniquement. Garde-le hors du code qui tourne sur un serveur dédié. - Relis les couleurs et espacements du thème à chaque image ou à chaque
init(), jamais dans un champstatic final: un pack de ressources peut les changer.
Et ensuite
- Installation : la dépendance Gradle et
neoforge.mods.toml. - Ta première fenêtre : une recherche, une liste filtrée et deux boutons.
- Menus à cases : un menu façon coffre, client et serveur.
- Référence API : toutes les classes publiques, générées depuis la Javadoc.