diff --git a/README.md b/README.md new file mode 100644 index 0000000..cf47c52 --- /dev/null +++ b/README.md @@ -0,0 +1,12 @@ +# GastinelMindPNJ + +Mind (l'IA locale) en PNJ pour NeoForge 1.21.1. **Mod côté serveur uniquement.** + +- `/msg mind ` : 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 ` 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). diff --git a/build-sur-cornafserver.sh b/build-sur-cornafserver.sh index 7a423b8..23e57f2 100644 --- a/build-sur-cornafserver.sh +++ b/build-sur-cornafserver.sh @@ -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" \ diff --git a/build.gradle b/build.gradle index eebf26f..1f8a6be 100644 --- a/build.gradle +++ b/build.gradle @@ -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 { diff --git a/envoyer-et-compiler.sh b/envoyer-et-compiler.sh new file mode 100644 index 0000000..6339edd --- /dev/null +++ b/envoyer-et-compiler.sh @@ -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 diff --git a/gradle.properties b/gradle.properties index 7d20005..deed746 100644 --- a/gradle.properties +++ b/gradle.properties @@ -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 diff --git a/src/main/java/com/gastinelmind/GastinelMind.java b/src/main/java/com/gastinelmind/GastinelMind.java index 24d7e36..adfe7f0 100644 --- a/src/main/java/com/gastinelmind/GastinelMind.java +++ b/src/main/java/com/gastinelmind/GastinelMind.java @@ -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é."); } } diff --git a/src/main/java/com/gastinelmind/GuideCommand.java b/src/main/java/com/gastinelmind/GuideCommand.java new file mode 100644 index 0000000..ac07b3c --- /dev/null +++ b/src/main/java/com/gastinelmind/GuideCommand.java @@ -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 : 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 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; + } + } +} diff --git a/src/main/java/com/gastinelmind/core/GuideTextes.java b/src/main/java/com/gastinelmind/core/GuideTextes.java new file mode 100644 index 0000000..80ac3ea --- /dev/null +++ b/src/main/java/com/gastinelmind/core/GuideTextes.java @@ -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 lignes, List boutons) {} + + public final String prefixe; + public final String couleurTexte; + public final String couleurBoutons; + public final Map pages; + + private GuideTextes(String prefixe, String couleurTexte, String couleurBoutons, Map 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 pages = new LinkedHashMap<>(); + for (Map.Entry e : o.getAsJsonObject("pages").entrySet()) { + JsonObject p = e.getValue().getAsJsonObject(); + List lignes = new ArrayList<>(); + if (p.has("lignes")) for (JsonElement l : p.getAsJsonArray("lignes")) lignes.add(l.getAsString()); + List 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 ). */ + public static boolean pageValide(String page) { + return page != null && page.matches("[a-z0-9_]{1,32}"); + } +} diff --git a/src/main/resources/META-INF/neoforge.mods.toml b/src/main/resources/META-INF/neoforge.mods.toml index 77f4d62..6da1764 100644 --- a/src/main/resources/META-INF/neoforge.mods.toml +++ b/src/main/resources/META-INF/neoforge.mods.toml @@ -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 est transmis à l'IA locale, /mind spawn|remove pour le PNJ évocateur. Mod côté serveur uniquement.''' +description='''Mind devient un PNJ : /msg mind 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" diff --git a/src/main/resources/gastinelmind/guide-defaut.json b/src/main/resources/gastinelmind/guide-defaut.json new file mode 100644 index 0000000..61f4d06 --- /dev/null +++ b/src/main/resources/gastinelmind/guide-defaut.json @@ -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 : demande à te téléporter vers un joueur. Il accepte avec /tpaccept ou refuse avec /tpadeny. /tpahere : 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 : donne accès à tes claims à un ami (/friend unadd pour retirer).", + "- /msg mind : 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"} + ] + } + } +} diff --git a/src/test/java/com/gastinelmind/core/GuideTextesTest.java b/src/test/java/com/gastinelmind/core/GuideTextesTest.java new file mode 100644 index 0000000..f2c215a --- /dev/null +++ b/src/test/java/com/gastinelmind/core/GuideTextesTest.java @@ -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")); + } +}