Fichiers
gastinel-client/README.md
T

59 lignes
4.0 KiB
Markdown
Brut Annotations Historique

Ce fichier contient des caractères Unicode ambigus.
Ce fichier contient des caractères Unicode qui peuvent être confondus avec d'autres caractères. Si vous pensez que c'est intentionnel, vous pouvez ignorer cet avertissement. Utilisez le bouton Échappe pour les dévoiler.
# GastinelClient
Mod **côté client** pour NeoForge 1.21.1 (testé avec NeoForge 21.1.234). Il remplace l'écran d'accueil et le menu pause de Minecraft par des écrans aux couleurs de Gastinel. NeoForge n'est pas modifié : le mod écoute `ScreenEvent.Opening` et ouvre ses propres écrans à la place de `TitleScreen` et de `PauseScreen`.
Le serveur n'a pas besoin du mod (`displayTest="IGNORE_ALL_VERSION"`), et un joueur sans le mod peut se connecter.
## Écrans
| Écran | Contenu |
|---|---|
| Accueil | Solo · **Serveur Gastinel** (un clic, avec l'état en direct : « En ligne · 0/20 joueur · 15 ms ») · Autres serveurs · Options · Quitter. En pied de page : versions, lien « Mods ». |
| Autres serveurs | Une case d'adresse (Rejoindre / Enregistrer, Entrée = rejoindre), la liste des serveurs enregistrés (un clic pour rejoindre, avec des pages s'il y en a beaucoup) et un lien vers la liste complète de Minecraft pour modifier ou supprimer. Le serveur Gastinel n'y figure pas, puisqu'il est déjà sur l'accueil. |
| Options | Deux colonnes avec des boutons − / + : distance d'affichage, champ de vision, luminosité, taille de l'interface, plein écran, synchro verticale, volumes (général, musique, blocs), sensibilité de la souris. Un lien mène à toutes les options de Minecraft. |
| Pause | Un panneau papier à gauche, le monde visible à droite (sans flou) : Reprendre (avec le nom du monde ou du serveur), Options, Progrès, Statistiques, Ouvrir en réseau local (en solo), Mods, Sauvegarder et quitter / Se déconnecter (retour à l'accueil Gastinel). |
Les captures sont dans `livrable/captures/`.
## Charte (proposition A « sobre », branche `design/propositions`)
- Fond blanc `#FFFFFF` (alterné `#F4F4F4`), encre `#111111`, gris `#6B6B6B`, filets `#D9D9D9` (fort : 2 px d'encre au-dessus des listes). Valeurs de la charte relevée (Mind, météo, Hub).
- Police Inter (TTF fournie dans le mod, licence OFL : `LICENCE-INTER-OFL.txt`). Grands titres en Inter SemiBold suréchantillonnée ; étiquettes en capitales espacées.
- Aucun arrondi, aucune texture vanilla, plus d'image de fond. Les menus sont des listes numérotées séparées par des filets ; l'action principale est une ligne pleine à l'encre.
- La couleur ne sert que de signal, toujours avec un texte : succès `#1A5C2A` sur `#F0F7F0`, alerte `#8A1C1C` sur `#FDF2F2`.
- Accueil : à droite, l'état du serveur en grands chiffres (joueurs, latence, version, adresse), masqué si l'écran est étroit.
- Les deux autres propositions (B, C) et les maquettes sont dans `propositions/`.
## Configuration
`config/gastinelclient-client.toml` (créé au premier lancement) :
```toml
serveurNom = "Serveur Gastinel"
serveurAdresse = "gastinel.me:25565"
remplacerAccueil = true
remplacerPause = true
```
Si l'adresse figure déjà dans la liste multijoueur, l'accueil reprend cette entrée, ce qui conserve le choix fait pour le pack de ressources.
## Compiler
Depuis le PC : `sh envoyer-et-compiler.sh`. Le script envoie les sources dans `~/staging/GastinelClient` sur cornafserver, compile dans un conteneur jetable `eclipse-temurin:21-jdk` (8 Go, car la décompilation du client échoue avec 4 Go) puis rapatrie le jar dans `livrable/`. Les tests JUnit de `core/` s'exécutent pendant la compilation.
## Tester sans carte graphique
Sur cornafserver : `sh outils/client-xvfb.sh`. Le script lance le client de développement dans un conteneur `gc-test` avec Xvfb et Mesa llvmpipe, donc un rendu 100 % CPU. On le pilote ensuite avec `docker exec gc-test sh -c 'DISPLAY=:99 xdotool …'` et `import -window root` pour les captures. Pour l'arrêter : `docker rm -f gc-test`.
## Structure
```
src/main/java/com/gastinelclient/
GastinelClient.java @Mod(dist = CLIENT), remplacement des écrans
Config.java config client
core/Libelles.java textes et calculs purs (testés)
ui/Charte.java couleurs, polices, fond, filets
ui/Bouton.java bouton plat (MENU, PRIMAIRE, CADRE, LIEN)
ecrans/ Accueil, Serveurs, OptionsSimples, PauseGastinel, base EcranGastinel
```