Fichiers
gastinel-client/README.md
T

Brut Annotations Historique

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

  • Fond papier #F2F0E6, encre #2D2A26, filets #DAD5C8.
  • Police Inter (TTF fournie dans le mod, licence OFL : LICENCE-INTER-OFL.txt). Le grand titre utilise Inter SemiBold suréchantillonnée, agrandie ×3.
  • Aucun arrondi, aucune texture vanilla. Les boutons sont des lignes de liste séparées par des filets fins.
  • Accents francs, utilisés avec retenue : orange #E8590C (serveur, surtitres), vert #2B8A3E (en ligne), rouge #C92A2A (hors ligne, quitter).
  • Arrière-plan maison : outils/fond.py génère textures/gui/fond.png (courbes de niveau d'un relief imaginaire, une ligne de crête et un repère orange). La moitié gauche reste vide pour le menu.

Configuration

config/gastinelclient-client.toml (créé au premier lancement) :

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