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 à :
1 Parent
c6f61950a3
révision
370433fb00
11 fichiers modifiés
+322
-4
Aucun fichier ne correspond à votre recherche
@@ -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).
|
||||
@@ -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" \
|
||||
|
||||
@@ -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 {
|
||||
|
||||
@@ -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,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
|
||||
|
||||
|
||||
@@ -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é.");
|
||||
}
|
||||
}
|
||||
@@ -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;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -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}");
|
||||
}
|
||||
}
|
||||
@@ -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"
|
||||
|
||||
|
||||
@@ -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"}
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -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"));
|
||||
}
|
||||
}
|
||||
Référencer dans un nouveau ticket
Bloquer un utilisateur