GastinelMindPNJ 1.1.0 : /guide (accueil de Mind avec boutons cliquables)

Accueil avec [Répondre] -> /guide menu (Commandes, Mods du serveur, Règles, Retour).
Textes dans config/gastinelmind-guide.json (créé depuis le jar, relu à chaud), {joueur} = pseudo.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Cette révision appartient à :
Theo GastineletClaude Sonnet 5.5 a révisé 2026-10-09 20:34:38 +02:00
1 Parent c6f61950a3
révision 370433fb00
11 fichiers modifiés
+322 -4

Aucun fichier ne correspond à votre recherche

+12
Voir le fichier
@@ -0,0 +1,12 @@
# GastinelMindPNJ
Mind (l'IA locale) en PNJ pour NeoForge 1.21.1. **Mod côté serveur uniquement.**
- `/msg mind <texte>` : transmis à l'IA locale, réponse en chuchotement. `/mind spawn|remove` (op) : PNJ évocateur.
- `/guide` (depuis 1.1.0) : message d'accueil de Mind avec un bouton bleu cliquable **[Répondre]** -> `/guide menu` : **[Commandes] [Mods du serveur] [Règles] [Retour]** ; chaque page a ses boutons de navigation. `/guide <page>` ouvre une page directement.
## Textes du guide
`config/gastinelmind-guide.json`, créé au premier `/guide` depuis `src/main/resources/gastinelmind/guide-defaut.json` (textes validés de `Gastinel-Projets/serveur-minecraft-guide-textes.md`, sections 1 à 5 ; règles : « Les règles arrivent bientôt. »). Relu à chaque commande : modifiable sans redémarrer. `{joueur}` = pseudo (caractères sûrs seulement). Chaque page : `lignes` + `boutons` (`texte`, `page`). Noms de page : `[a-z0-9_]`.
## Build
`sh envoyer-et-compiler.sh` depuis le PC (compile sur cornafserver, conteneur jetable).
+1 -1
Voir le fichier
@@ -4,7 +4,7 @@
set -e
cd "$(dirname "$0")"
mkdir -p "$HOME/.cache/gastinelmind-gradle"
docker run --rm \
nice -n 10 docker run --rm --memory 4g --cpus 4 \
-u "$(id -u):$(id -g)" \
-e GRADLE_USER_HOME=/gradle-home \
-v "$HOME/.cache/gastinelmind-gradle:/gradle-home" \
+1
Voir le fichier
@@ -33,6 +33,7 @@ dependencies {
testImplementation platform('org.junit:junit-bom:5.11.4')
testImplementation 'org.junit.jupiter:junit-jupiter'
testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
testImplementation 'com.google.code.gson:gson:2.11.0'
}
test {
+10
Voir le fichier
@@ -0,0 +1,10 @@
#!/bin/sh
# Depuis le PC : envoie les sources sur cornafserver (~/staging/GastinelMindPNJ), compile, rapatrie le jar dans build-out/.
set -e
cd "$(dirname "$0")"
tar czf /tmp/gastinelmind-src.tgz --exclude=build --exclude=.gradle --exclude=build-out --exclude=run .
scp /tmp/gastinelmind-src.tgz cornafserver:gastinelmind-src.tgz
ssh cornafserver 'set -e; rm -rf "$HOME/staging/GastinelMindPNJ"; mkdir -p "$HOME/staging/GastinelMindPNJ"; tar xzf "$HOME/gastinelmind-src.tgz" -C "$HOME/staging/GastinelMindPNJ"; rm "$HOME/gastinelmind-src.tgz"; cd "$HOME/staging/GastinelMindPNJ" && sh build-sur-cornafserver.sh'
mkdir -p build-out
scp 'cornafserver:staging/GastinelMindPNJ/build/libs/gastinelmind-neoforge-1.21.1-1.1.0.jar' build-out/
ls -l build-out
+1 -1
Voir le fichier
@@ -1,7 +1,7 @@
org.gradle.jvmargs=-Xmx2G
org.gradle.parallel=true
mod_version=1.0.0
mod_version=1.1.0
mod_group_id=com.gastinelmind
mod_id=gastinelmind
+1
Voir le fichier
@@ -17,6 +17,7 @@ public class GastinelMind {
NeoForge.EVENT_BUS.register(MindChat.class);
NeoForge.EVENT_BUS.register(MindNpc.class);
NeoForge.EVENT_BUS.register(MindTabList.class);
NeoForge.EVENT_BUS.register(GuideCommand.class);
LOGGER.info("[GastinelMind] Mind PNJ chargé.");
}
}
+112
Voir le fichier
@@ -0,0 +1,112 @@
package com.gastinelmind;
import com.gastinelmind.core.GuideTextes;
import com.gastinelmind.core.GuideTextes.Bouton;
import com.gastinelmind.core.GuideTextes.Page;
import com.mojang.brigadier.arguments.StringArgumentType;
import com.mojang.brigadier.context.CommandContext;
import com.mojang.brigadier.exceptions.CommandSyntaxException;
import net.minecraft.ChatFormatting;
import net.minecraft.commands.CommandSourceStack;
import net.minecraft.commands.Commands;
import net.minecraft.commands.SharedSuggestionProvider;
import net.minecraft.network.chat.ClickEvent;
import net.minecraft.network.chat.Component;
import net.minecraft.network.chat.HoverEvent;
import net.minecraft.network.chat.MutableComponent;
import net.minecraft.network.chat.Style;
import net.minecraft.network.chat.TextColor;
import net.minecraft.server.MinecraftServer;
import net.minecraft.server.level.ServerPlayer;
import net.neoforged.bus.api.SubscribeEvent;
import net.neoforged.neoforge.event.RegisterCommandsEvent;
import java.io.IOException;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
/**
* /guide : Mind accueille le joueur (page « accueil »), /guide <page> : autres pages (menu, commandes, mods, regles).
* Textes dans config/gastinelmind-guide.json (créé depuis la version intégrée au jar s'il n'existe pas),
* relu à chaque commande : on peut le modifier sans redémarrer.
*/
public final class GuideCommand {
static final String FICHIER = "config/gastinelmind-guide.json";
@SubscribeEvent
public static void onRegister(RegisterCommandsEvent event) {
event.getDispatcher().register(Commands.literal("guide")
.executes(ctx -> afficher(ctx, "accueil"))
.then(Commands.argument("page", StringArgumentType.word())
.suggests((ctx, b) -> {
GuideTextes t = textes(ctx.getSource().getServer());
return SharedSuggestionProvider.suggest(t == null ? java.util.List.of() : t.pages.keySet(), b);
})
.executes(ctx -> afficher(ctx, StringArgumentType.getString(ctx, "page")))));
}
private static int afficher(CommandContext<CommandSourceStack> ctx, String nomPage) throws CommandSyntaxException {
ServerPlayer p = ctx.getSource().getPlayerOrException();
GuideTextes t = textes(p.server);
if (t == null) {
ctx.getSource().sendFailure(Component.literal("Le guide est indisponible pour le moment (fichier de textes illisible)."));
return 0;
}
Page page = t.pages.get(nomPage);
if (page == null) {
ctx.getSource().sendFailure(Component.literal("Page de guide inconnue : " + nomPage + ". Essaie /guide menu."));
return 0;
}
String joueur = p.getGameProfile().getName();
Style styleTexte = Style.EMPTY.withColor(couleur(t.couleurTexte, ChatFormatting.GRAY)).withItalic(true);
boolean premiere = true;
for (String ligne : page.lignes()) {
String s = GuideTextes.remplir(ligne, joueur);
p.sendSystemMessage(Component.literal(premiere ? t.prefixe + s : s).withStyle(styleTexte));
premiere = false;
}
if (!page.boutons().isEmpty()) {
MutableComponent ligne = Component.empty();
boolean debut = true;
for (Bouton b : page.boutons()) {
if (!GuideTextes.pageValide(b.page())) continue;
if (!debut) ligne.append(Component.literal(" "));
debut = false;
ligne.append(Component.literal("[" + b.texte() + "]").withStyle(Style.EMPTY
.withColor(couleur(t.couleurBoutons, ChatFormatting.BLUE))
.withBold(true)
.withClickEvent(new ClickEvent(ClickEvent.Action.RUN_COMMAND, "/guide " + b.page()))
.withHoverEvent(new HoverEvent(HoverEvent.Action.SHOW_TEXT, Component.literal(b.texte())))));
}
p.sendSystemMessage(ligne);
}
return 1;
}
private static TextColor couleur(String nom, ChatFormatting defaut) {
TextColor c = nom == null ? null : TextColor.parseColor(nom).result().orElse(null);
return c != null ? c : TextColor.fromLegacyFormat(defaut);
}
/** Lit le fichier de config ; le crée depuis la version intégrée s'il manque. null si illisible. */
static GuideTextes textes(MinecraftServer server) {
Path f = server.getServerDirectory().resolve(FICHIER);
try {
if (!Files.exists(f)) {
try (InputStream in = GuideCommand.class.getResourceAsStream("/gastinelmind/guide-defaut.json")) {
if (in == null) return null;
Files.createDirectories(f.getParent());
Files.copy(in, f);
GastinelMind.LOGGER.info("[GastinelMind] Textes du guide créés : {}", f);
}
}
return GuideTextes.parse(Files.readString(f, StandardCharsets.UTF_8));
} catch (IOException | RuntimeException e) {
GastinelMind.LOGGER.error("[GastinelMind] Textes du guide illisibles ({}) : {}", f, e.toString());
return null;
}
}
}
+65
Voir le fichier
@@ -0,0 +1,65 @@
package com.gastinelmind.core;
import com.google.gson.JsonArray;
import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
/** Textes du /guide lus depuis le JSON de config. Logique pure (Gson seulement), testable. */
public final class GuideTextes {
public record Bouton(String texte, String page) {}
public record Page(List<String> lignes, List<Bouton> boutons) {}
public final String prefixe;
public final String couleurTexte;
public final String couleurBoutons;
public final Map<String, Page> pages;
private GuideTextes(String prefixe, String couleurTexte, String couleurBoutons, Map<String, Page> pages) {
this.prefixe = prefixe;
this.couleurTexte = couleurTexte;
this.couleurBoutons = couleurBoutons;
this.pages = pages;
}
public static GuideTextes parse(String json) {
JsonObject o = JsonParser.parseString(json).getAsJsonObject();
Map<String, Page> pages = new LinkedHashMap<>();
for (Map.Entry<String, JsonElement> e : o.getAsJsonObject("pages").entrySet()) {
JsonObject p = e.getValue().getAsJsonObject();
List<String> lignes = new ArrayList<>();
if (p.has("lignes")) for (JsonElement l : p.getAsJsonArray("lignes")) lignes.add(l.getAsString());
List<Bouton> boutons = new ArrayList<>();
if (p.has("boutons")) {
JsonArray a = p.getAsJsonArray("boutons");
for (JsonElement b : a) {
JsonObject bo = b.getAsJsonObject();
boutons.add(new Bouton(bo.get("texte").getAsString(), bo.get("page").getAsString()));
}
}
pages.put(e.getKey(), new Page(List.copyOf(lignes), List.copyOf(boutons)));
}
return new GuideTextes(
o.has("prefixe") ? o.get("prefixe").getAsString() : "Mind vous chuchote : ",
o.has("couleur_texte") ? o.get("couleur_texte").getAsString() : "gray",
o.has("couleur_boutons") ? o.get("couleur_boutons").getAsString() : "blue",
pages);
}
/** Remplace {joueur} ; garde uniquement les caractères sûrs du pseudo. */
public static String remplir(String ligne, String joueur) {
return ligne.replace("{joueur}", joueur.replaceAll("[^A-Za-z0-9_]", ""));
}
/** Nom de page sûr pour une commande cliquable (/guide <page>). */
public static boolean pageValide(String page) {
return page != null && page.matches("[a-z0-9_]{1,32}");
}
}
+2 -2
Voir le fichier
@@ -4,10 +4,10 @@ license="MIT"
[[mods]]
modId="gastinelmind"
version="1.0.0"
version="1.1.0"
displayName="GastinelMind PNJ"
authors="Théo Gastinel"
description='''Mind devient un PNJ : /msg mind <texte> est transmis à l'IA locale, /mind spawn|remove pour le PNJ évocateur. Mod côté serveur uniquement.'''
description='''Mind devient un PNJ : /msg mind <texte> est transmis à l'IA locale, /guide pour accueillir les nouveaux joueurs, /mind spawn|remove pour le PNJ évocateur. Mod côté serveur uniquement.'''
# Les clients n'ont pas besoin du mod.
displayTest="IGNORE_ALL_VERSION"
+66
Voir le fichier
@@ -0,0 +1,66 @@
{
"_doc": "Textes du /guide, dits par Mind. Modifiable à chaud : le fichier est relu à chaque /guide. {joueur} = pseudo. Chaque page : lignes (texte) + boutons (texte affiché, page ouverte au clic). La page 'accueil' est celle de /guide.",
"prefixe": "Mind vous chuchote : ",
"couleur_texte": "gray",
"couleur_boutons": "blue",
"pages": {
"accueil": {
"lignes": [
"Salut, {joueur}. Je suis Mind, une IA qui va t'aider sur ce serveur !",
"Pour commencer, tu peux continuer l'avenue et marcher sur la plaque de pression, cela t'amènera quelque part sur la map !",
"Veux-tu en savoir plus sur les commandes, les mods du serveur, ou encore les règles ?"
],
"boutons": [{"texte": "Répondre", "page": "menu"}]
},
"menu": {
"lignes": ["Qu'est-ce que tu veux savoir ?"],
"boutons": [
{"texte": "Commandes", "page": "commandes"},
{"texte": "Mods du serveur", "page": "mods"},
{"texte": "Règles", "page": "regles"},
{"texte": "Retour", "page": "accueil"}
]
},
"commandes": {
"lignes": [
"Voici les commandes utiles :",
"- /spawn : te ramène au spawn.",
"- /rtp : te téléporte à un endroit aléatoire de la carte déjà explorée.",
"- /tpa <joueur> : demande à te téléporter vers un joueur. Il accepte avec /tpaccept ou refuse avec /tpadeny. /tpahere <joueur> : demande à ce qu'il vienne à toi. La demande expire au bout d'1 minute.",
"- /claim : protège le chunk où tu es (25 chunks maximum). /unclaim le libère, /claim info te dit à qui il est.",
"- /friend add <joueur> : donne accès à tes claims à un ami (/friend unadd pour retirer).",
"- /msg mind <message> : me parler en privé."
],
"boutons": [
{"texte": "Mods du serveur", "page": "mods"},
{"texte": "Règles", "page": "regles"},
{"texte": "Retour", "page": "menu"}
]
},
"mods": {
"lignes": [
"Le serveur est un survival presque vanilla, avec quelques ajouts :",
"- Create, avec Create Aeronautics et Create New Age : machines, engrenages, énergie, et même de quoi construire des engins volants.",
"- Terralith et Tectonic : des paysages plus variés et des montagnes plus hautes.",
"- Gravestone : quand tu meurs, une tombe garde tes affaires.",
"- Hybrid Birds, Clumps (orbes d'expérience regroupés) et l'armure en netherite pour chevaux.",
"- Simple Voice Chat : un chat vocal de proximité, avec la touche V par défaut pour le menu des réglages.",
"- Le shader Gastinel Wind : le vent anime les arbres, les feuilles et l'eau selon la météo.",
"- Des mods d'optimisation (Sodium, Lithium, FerriteCore, ModernFix…) et des sons d'ambiance. Le launcher installe tout automatiquement."
],
"boutons": [
{"texte": "Commandes", "page": "commandes"},
{"texte": "Règles", "page": "regles"},
{"texte": "Retour", "page": "menu"}
]
},
"regles": {
"lignes": ["Les règles arrivent bientôt."],
"boutons": [
{"texte": "Commandes", "page": "commandes"},
{"texte": "Mods du serveur", "page": "mods"},
{"texte": "Retour", "page": "menu"}
]
}
}
}
+51
Voir le fichier
@@ -0,0 +1,51 @@
package com.gastinelmind.core;
import org.junit.jupiter.api.Test;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;
import static org.junit.jupiter.api.Assertions.*;
class GuideTextesTest {
private static GuideTextes defaut() throws Exception {
try (InputStream in = GuideTextes.class.getResourceAsStream("/gastinelmind/guide-defaut.json")) {
assertNotNull(in);
return GuideTextes.parse(new String(in.readAllBytes(), StandardCharsets.UTF_8));
}
}
@Test
void accueilExact() throws Exception {
GuideTextes t = defaut();
GuideTextes.Page a = t.pages.get("accueil");
assertEquals("Salut, Theo_G. Je suis Mind, une IA qui va t'aider sur ce serveur !",
GuideTextes.remplir(a.lignes().get(0), "Theo_G"));
assertEquals("Pour commencer, tu peux continuer l'avenue et marcher sur la plaque de pression, "
+ "cela t'amènera quelque part sur la map !", a.lignes().get(1));
assertEquals("Veux-tu en savoir plus sur les commandes, les mods du serveur, ou encore les règles ?", a.lignes().get(2));
assertEquals(new GuideTextes.Bouton("Répondre", "menu"), a.boutons().get(0));
assertEquals("blue", t.couleurBoutons);
}
@Test
void toutesLesPagesCibleesExistent() throws Exception {
GuideTextes t = defaut();
for (GuideTextes.Page p : t.pages.values()) {
for (GuideTextes.Bouton b : p.boutons()) {
assertTrue(GuideTextes.pageValide(b.page()), b.page());
assertTrue(t.pages.containsKey(b.page()), b.page());
}
}
assertEquals("Les règles arrivent bientôt.", t.pages.get("regles").lignes().get(0));
assertTrue(t.pages.get("mods").lignes().stream().anyMatch(l -> l.contains("Simple Voice Chat")));
assertEquals(4, t.pages.get("menu").boutons().size());
}
@Test
void pseudoNettoye() {
assertEquals("Salut ab", GuideTextes.remplir("Salut {joueur}", "a§b\""));
assertFalse(GuideTextes.pageValide("menu; /op"));
}
}