Fichiers

58 lignes
3.8 KiB
Markdown
Brut Lien permanent 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
- 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) :
```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
```