58 lignes
3.8 KiB
Markdown
58 lignes
3.8 KiB
Markdown
# 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
|
||
```
|