gitea_admin/canalhandia
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(ia): add Judite & Narrador personas, per-player AI selection, persistent memory, and event reactivity

Browse Source
This commit is contained in:
Marcos Paulo
2026-08-18 19:00:11 -03:00
parent dafd96a4b6
commit ea55813019
13 changed files with 1036 additions and 88 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/main/java/dev/marcospaulo/canalhandia/Achievements.java
+11
View File
@@ -159,6 +159,17 @@ final class Achievements {
.append(Component.text(" — " + achievement.description(), NamedTextColor.GRAY)
.decoration(TextDecoration.BOLD, false)));
plugin.getLogger().info("[conquistas] " + player.getName() + " → " + achievement.key());
if (plugin.settings().aiEvents() && plugin.settings().moduleEnabled(Module.IA)) {
Persona persona = plugin.playerMemory() != null
? plugin.playerMemory().persona(player.getUniqueId(), plugin.settings().aiPersona())
: plugin.settings().aiPersona();
plugin.ai().saySomething(player.getName(),
"O jogador " + player.getName() + " desbloqueou a conquista \""
+ achievement.title() + "\" (" + achievement.description()
+ "). Faça um breve comentário na sua personalidade.",
plugin.aiBudget(), persona);
}
}
/** Which achievements this player has already unlocked. */
src/main/java/dev/marcospaulo/canalhandia/Ai.java
+45 -47
View File
@@ -238,12 +238,16 @@ final class Ai {
return;
}
Persona persona = plugin.playerMemory() != null
? plugin.playerMemory().persona(asker.getUniqueId(), settings.aiPersona())
: settings.aiPersona();
lastAsk.put(asker.getUniqueId(), System.currentTimeMillis());
pending.put(asker.getUniqueId(), true);
askedToday++;
if (!isPrivate && settings.aiPublic()) {
Bukkit.broadcast(Msg.tag("IA", NamedTextColor.LIGHT_PURPLE)
Bukkit.broadcast(Msg.tag(persona.displayTag(), persona.tagColor())
.append(Component.text(asker.getName() + " perguntou: ", NamedTextColor.GRAY)
.decoration(TextDecoration.BOLD, false))
.append(Component.text(question, NamedTextColor.WHITE)
@@ -254,6 +258,7 @@ final class Ai {
String prompt = question;
UUID id = asker.getUniqueId();
final boolean isPriv = isPrivate;
final Persona effectivePersona = persona;
// Captured HERE, on the main thread, because both read the Bukkit world
// and player API. The async body below only ever sees the resulting
@@ -261,12 +266,15 @@ final class Ai {
// bug that shows up as rare, confusing world-state corruption.
final String liveState = settings.aiServerState() ? ServerState.snapshot(asker) : null;
final String chatContext = plugin.chatLog().formatRecent(settings.aiChatContextLines());
final String memoryContext = plugin.playerMemory() != null
? plugin.playerMemory().formatContext(asker.getUniqueId())
: null;
Bukkit.getScheduler().runTaskAsynchronously(plugin, () -> {
String answer = null;
try {
java.util.List<MiniMax.Turn> messages =
compose(asker, prompt, settings, liveState, chatContext);
compose(asker, prompt, settings, effectivePersona, liveState, chatContext, memoryContext);
if (settings.aiTools()) {
// Agentic path: the model pulls what it needs (web search,
@@ -286,8 +294,8 @@ final class Ai {
Wiki.Article article = term == null ? null : wiki.lookup(term);
if (article != null) {
messages.add(messages.size() - 1, new MiniMax.Turn("system",
"Artigo da Minecraft Wiki pt-BR — '" + article.title() + "':\n"
+ article.text()));
"Artigo da Minecraft Wiki pt-BR — '" + article.title() + "':\n"
+ article.text()));
}
}
@@ -320,7 +328,7 @@ final class Ai {
String finalAnswer = answer;
Bukkit.getScheduler().runTask(plugin, () -> {
pending.remove(id);
deliver(id, prompt, finalAnswer, settings, isPriv);
deliver(id, prompt, finalAnswer, settings, effectivePersona, isPriv);
});
});
}
@@ -333,7 +341,7 @@ final class Ai {
* drops tables), the conversation history, then the question itself.
*/
private java.util.List<MiniMax.Turn> compose(Player asker, String question, Settings settings,
String liveState, String chatContext) {
Persona persona, String liveState, String chatContext, String memoryContext) {
java.util.List<MiniMax.Turn> messages = new java.util.ArrayList<>();
messages.add(new MiniMax.Turn("system", settings.aiInstructions()));
@@ -341,13 +349,17 @@ final class Ai {
// safety rules above are read first and the persona is decoration on
// top of them, never a replacement for them (Persona.GUARD restates the
// limits inside the persona's own frame as a second layer).
messages.add(new MiniMax.Turn("system", settings.aiPersona().systemText()));
messages.add(new MiniMax.Turn("system", persona.systemText()));
String serverContext = settings.aiServerContext();
if (!serverContext.isBlank()) {
messages.add(new MiniMax.Turn("system", "Sobre este servidor: " + serverContext));
}
if (memoryContext != null && !memoryContext.isBlank()) {
messages.add(new MiniMax.Turn("system", memoryContext));
}
// The asker's own stats, so "quantos blocos eu minerei?" gets a real
// number instead of "não tenho acesso ao servidor". ~30 tokens; gated
// by ia.estatisticas-jogador so an operator can turn it off. Stale by
@@ -409,7 +421,7 @@ final class Ai {
}
private void deliver(UUID askerId, String question, String answer,
Settings settings, boolean isPrivate) {
Settings settings, Persona persona, boolean isPrivate) {
Player asker = Bukkit.getPlayer(askerId);
if (answer == null || answer.isBlank()) {
if (asker != null) {
@@ -431,6 +443,9 @@ final class Ai {
// can still correct the last answer even after the asker left.
if (asker != null) {
conversations.remember(askerId, question, clean);
if (plugin.playerMemory() != null) {
plugin.playerMemory().recordTurn(askerId, asker.getName(), question, clean);
}
}
lastAnswer = new Answered(askerId, question, clean);
@@ -438,7 +453,7 @@ final class Ai {
if (asker != null) {
boolean bedrock = Platform.isBedrock(asker);
for (int i = 0; i < segments.size(); i++) {
asker.sendMessage(style(segments.get(i), question, settings, bedrock, i == 0));
asker.sendMessage(style(segments.get(i), question, persona, settings, bedrock, i == 0));
}
}
return;
@@ -450,48 +465,32 @@ final class Ai {
for (int i = 0; i < segments.size(); i++) {
String segment = segments.get(i);
boolean first = i == 0;
plugin.broadcastPerPlatform(bedrock -> style(segment, question, settings, bedrock, first));
plugin.broadcastPerPlatform(bedrock -> style(segment, question, persona, settings, bedrock, first));
}
plugin.openAiReactions(askerId);
}
/**
* Renders one answer for chat.
*
* <p>Java players get a hover card naming the persona and the question that
* produced the answer, plus a click that pre-fills {@code /ia } so a
* follow-up is one keystroke away — {@code suggestCommand}, never
* {@code runCommand}, so nothing executes without the player pressing enter.
*
* <p>Bedrock gets the same text with no hover and no click, because it
* renders neither; the styling is decoration and its absence costs nothing.
* {@code ia.estilo-rico: false} forces the plain form everywhere.
*
* <p>A long or list-shaped answer arrives as several segments ({@link
* AiText#segments}); the first carries the full {@code [IA]} tag, the rest
* carry a plain grey continuation mark instead of repeating the tag on
* every line, so a five-item list reads as one grouped answer rather than
* five separate IA replies.
*/
private Component style(String answer, String question, Settings settings, boolean bedrock, boolean firstLine) {
private Component style(String answer, String question, Persona persona, Settings settings, boolean bedrock, boolean firstLine) {
Component body = Component.text(answer, NamedTextColor.WHITE)
.decoration(TextDecoration.BOLD, false);
if (!bedrock && settings.aiFancy()) {
Persona persona = settings.aiPersona();
body = body
.hoverEvent(net.kyori.adventure.text.event.HoverEvent.showText(
Component.text("Pergunta: ", NamedTextColor.GRAY)
.append(Component.text(AiText.forLog(question), NamedTextColor.WHITE))
.append(Component.newline())
.append(Component.text("Personalidade: ", NamedTextColor.GRAY))
.append(Component.text(persona.key(), NamedTextColor.LIGHT_PURPLE))
.append(Component.newline())
.append(Component.text("Clique para perguntar outra coisa",
NamedTextColor.DARK_GRAY))))
.append(Component.text(AiText.forLog(question), NamedTextColor.WHITE))
.append(Component.newline())
.append(Component.text("Personalidade: ", NamedTextColor.GRAY))
.append(Component.text(persona.displayName(), persona.tagColor()))
.append(Component.newline())
.append(Component.text("Clique para perguntar outra coisa",
NamedTextColor.DARK_GRAY))))
.clickEvent(net.kyori.adventure.text.event.ClickEvent.suggestCommand("/ia "));
}
Component prefix = firstLine
? Msg.tag("IA", NamedTextColor.LIGHT_PURPLE)
? Msg.tag(persona.displayTag(), persona.tagColor())
: Component.text(" » ", NamedTextColor.DARK_GRAY);
return prefix.append(body);
}
@@ -501,18 +500,15 @@ final class Ai {
/**
* Says something unprompted, in the active persona — a jab at a death
* streak, a greeting for someone who just joined.
*
* <p>Everything about this is deliberately more restricted than {@code /ia}:
* it is gated by {@link Budget} (see the reasons there), it never consults
* the wiki, it asks for a much smaller answer, and it is silent on failure.
* A spontaneous line that errors should leave no trace — nobody asked for
* it, so nobody should see it fail.
*
* @param subject the player it is about, for the per-subject cooldown; may
* be null
* @param prompt what to comment on, already phrased as an instruction
*/
void saySomething(String subject, String prompt, Budget budget) {
saySomething(subject, prompt, budget, null);
}
/**
* Says something unprompted with an optional specific persona override.
*/
void saySomething(String subject, String prompt, Budget budget, Persona customPersona) {
Settings settings = plugin.settings();
if (!settings.moduleEnabled(Module.IA)) {
return;
@@ -530,9 +526,11 @@ final class Ai {
// exact double-message the gap exists to prevent.
budget.spend(subject, now);
Persona persona = customPersona != null ? customPersona : settings.aiPersona();
java.util.List<MiniMax.Turn> messages = new java.util.ArrayList<>();
messages.add(new MiniMax.Turn("system", settings.aiInstructions()));
messages.add(new MiniMax.Turn("system", settings.aiPersona().systemText()));
messages.add(new MiniMax.Turn("system", persona.systemText()));
String serverContext = settings.aiServerContext();
if (!serverContext.isBlank()) {
messages.add(new MiniMax.Turn("system", "Sobre este servidor: " + serverContext));
@@ -560,7 +558,7 @@ final class Ai {
return;
}
Bukkit.getScheduler().runTask(plugin, () -> Bukkit.broadcast(
Msg.tag("IA", NamedTextColor.LIGHT_PURPLE)
Msg.tag(persona.displayTag(), persona.tagColor())
.append(Component.text(clean, NamedTextColor.WHITE)
.decoration(TextDecoration.BOLD, false))));
});
src/main/java/dev/marcospaulo/canalhandia/Canalhandia.java
+17 -4
View File
@@ -85,6 +85,7 @@ public final class Canalhandia extends JavaPlugin implements Listener {
private Milestones milestones;
private Achievements achievements;
private WeeklyStats weeklyStats;
private PlayerMemory playerMemory;
/** Gate for spontaneous AI lines; see Budget for why this is strict. */
private Budget aiBudget;
private BlueMapBridge blueMap;
@@ -125,6 +126,7 @@ public final class Canalhandia extends JavaPlugin implements Listener {
achievements.syncCatalogue();
milestones.resyncSilently();
weeklyStats = new WeeklyStats(new java.io.File(getDataFolder(), "semana.yml"));
playerMemory = new PlayerMemory(new java.io.File(getDataFolder(), "ia-memoria.yml"));
aiBudget = new Budget(settings.aiSpontaneousPerDay(),
settings.aiSpontaneousGapMinutes() * 60_000L,
settings.aiSubjectCooldownMinutes() * 60_000L);
@@ -195,6 +197,11 @@ public final class Canalhandia extends JavaPlugin implements Listener {
return ai;
}
/** Persistent player memory and personal AI settings. Never null. */
PlayerMemory playerMemory() {
return playerMemory;
}
/** Recent public chat, for the AI's ambient context. Never null. */
ChatLog chatLog() {
return chatLog;
@@ -667,11 +674,14 @@ public final class Canalhandia extends JavaPlugin implements Listener {
return;
}
String stats = offlineStats.summary(player.getUniqueId());
Persona persona = playerMemory != null
? playerMemory.persona(player.getUniqueId(), settings.aiPersona())
: settings.aiPersona();
ai.saySomething(player.getName(),
"O jogador " + player.getName() + " acabou de entrar no servidor."
+ (stats == null ? "" : " Estatísticas dele: " + stats)
+ " Dê as boas-vindas do seu jeito, em uma frase.",
aiBudget);
+ " Dê as boas-vindas do seu jeito e na sua personalidade, em uma frase curta.",
aiBudget, persona);
}, Math.max(1, settings.joinDelaySeconds()) * 20L);
}
@@ -873,11 +883,14 @@ public final class Canalhandia extends JavaPlugin implements Listener {
deathStreak.put(player.getUniqueId(), new Streak(count, now));
if (settings.aiEvents() && count >= settings.aiDeathStreak()) {
Persona persona = playerMemory != null
? playerMemory.persona(player.getUniqueId(), settings.aiPersona())
: settings.aiPersona();
ai.saySomething(player.getName(),
"O jogador " + player.getName() + " morreu " + count
+ " vezes seguidas em poucos minutos. A última foi assim: " + flavor
+ ". Comente com deboche, sem ofender.",
aiBudget);
+ ". Comente na sua personalidade, sem ofender de verdade.",
aiBudget, persona);
// Reset so the next comment needs a fresh run rather than firing on
// every death from here on.
deathStreak.remove(player.getUniqueId());
src/main/java/dev/marcospaulo/canalhandia/CanalhandiaCommand.java
+157 -28
View File
@@ -967,10 +967,20 @@ final class CanalhandiaCommand implements CommandExecutor, TabCompleter {
iaCorrect(sender, args);
return true;
}
// Same guard as "perfil": only hijack when the next token is a real
// persona name, so "/ia personalidade do zumbi?" stays a question.
if (sub.equals("personalidade")
&& (args.length == 1 || Persona.isValid(args[1]))) {
if (sub.equals("status")) {
iaStatus(sender);
return true;
}
if (sub.equals("esquecer") || sub.equals("limpar")) {
iaForget(sender);
return true;
}
// Personalities: player can switch for themselves (/ia persona <nome>)
// or reset to default (/ia persona padrao).
if ((sub.equals("personalidade") || sub.equals("persona"))
&& (args.length == 1 || args[1].equalsIgnoreCase("padrao")
|| args[1].equalsIgnoreCase("reset") || args[1].equalsIgnoreCase("global")
|| Persona.isValid(args[1]))) {
iaPersona(sender, args);
return true;
}
@@ -1025,33 +1035,138 @@ final class CanalhandiaCommand implements CommandExecutor, TabCompleter {
}
/**
* {@code /ia personalidade [nome]} — shows the current tone, or switches it.
* Gated on {@code canalhandia.ia.perfil}, the same permission that controls
* the other AI-tuning switch: both change how the AI behaves for everyone,
* so they belong to the same set of people.
* {@code /ia persona [nome]} or {@code /ia personalidade [nome]}.
* Players can choose their personal AI persona or reset to server default.
* Operators can set global default with {@code /ia persona global <nome>}.
*/
private void iaPersona(CommandSender sender, String[] args) {
if (!sender.hasPermission("canalhandia.ia.perfil")) {
denied(sender);
return;
}
Persona current = plugin.settings().aiPersona();
Player player = sender instanceof Player p ? p : null;
Persona globalDefault = plugin.settings().aiPersona();
Persona current = player != null && plugin.playerMemory() != null
? plugin.playerMemory().persona(player.getUniqueId(), globalDefault)
: globalDefault;
Persona rawPersonal = player != null && plugin.playerMemory() != null
? plugin.playerMemory().rawPersona(player.getUniqueId())
: null;
if (args.length < 2) {
Msg.header(sender, "Personalidades da IA");
for (Persona persona : Persona.values()) {
Msg.line(sender, (persona == current ? "> " : " ") + persona.key(),
String marker = persona == current ? "» " : " ";
Msg.line(sender, marker + persona.displayName() + " (" + persona.key() + ")",
persona.description());
}
Msg.ok(sender, "Atual: " + current.key() + ". Uso: /ia personalidade <nome>");
if (player != null) {
String status = rawPersonal == null
? "padrão do servidor (" + globalDefault.displayName() + ")"
: "personalizada (" + rawPersonal.displayName() + ")";
Msg.ok(sender, "Sua IA ativa: " + current.displayName() + " — " + status);
Msg.ok(sender, "Para escolher: /ia persona <nome> | Para resetar: /ia persona padrao");
} else {
Msg.ok(sender, "Padrão global: " + globalDefault.displayName() + ". Uso: /ia persona <nome>");
}
return;
}
Persona persona = Persona.byKey(args[1]);
if (persona == null) {
Msg.error(sender, "Personalidade desconhecida. Use /ia personalidade para ver a lista.");
String target = args[1].toLowerCase(Locale.ROOT);
if (target.equals("padrao") || target.equals("reset") || target.equals("limpar")) {
if (player == null) {
Msg.error(sender, "Comando exclusivo para jogadores.");
return;
}
if (plugin.playerMemory() != null) {
plugin.playerMemory().resetPersona(player.getUniqueId());
}
Msg.ok(sender, "Sua IA voltou para a personalidade padrão do servidor ("
+ globalDefault.displayName() + ").");
return;
}
plugin.settings().aiPersona(persona);
Msg.ok(sender, "Personalidade da IA: " + persona.key() + " — " + persona.description());
if (target.equals("global")) {
if (!sender.hasPermission("canalhandia.ia.perfil")) {
denied(sender);
return;
}
if (args.length < 3) {
Msg.error(sender, "Uso: /ia persona global <nome>");
return;
}
Persona p = Persona.byKey(args[2]);
if (p == null) {
Msg.error(sender, "Personalidade desconhecida. Use /ia persona para ver a lista.");
return;
}
plugin.settings().aiPersona(p);
Msg.ok(sender, "Personalidade global da IA alterada para: " + p.displayName()
+ " — " + p.description());
return;
}
Persona chosen = Persona.byKey(target);
if (chosen == null) {
Msg.error(sender, "Personalidade desconhecida. Use /ia persona para ver a lista.");
return;
}
if (player != null && plugin.playerMemory() != null) {
plugin.playerMemory().setPersona(player.getUniqueId(), player.getName(), chosen);
Msg.ok(sender, "Sua personalidade da IA foi definida para: " + chosen.displayName()
+ " — " + chosen.description());
} else {
if (sender.hasPermission("canalhandia.ia.perfil")) {
plugin.settings().aiPersona(chosen);
Msg.ok(sender, "Personalidade global da IA: " + chosen.displayName());
} else {
denied(sender);
}
}
}
private void iaStatus(CommandSender sender) {
if (!(sender instanceof Player player)) {
Msg.header(sender, "Status da IA (Servidor)");
Msg.line(sender, "Perguntas hoje", String.valueOf(plugin.ai().askedToday()));
Msg.line(sender, "Feedbacks negativos", String.valueOf(plugin.ai().feedbackWrong()));
Msg.line(sender, "Personalidade global", plugin.settings().aiPersona().displayName());
return;
}
Persona global = plugin.settings().aiPersona();
Persona active = plugin.playerMemory() != null
? plugin.playerMemory().persona(player.getUniqueId(), global)
: global;
Persona raw = plugin.playerMemory() != null
? plugin.playerMemory().rawPersona(player.getUniqueId())
: null;
Msg.header(sender, "Status da sua IA");
Msg.line(sender, "Personalidade", active.displayName()
+ (raw == null ? " (padrão do servidor)" : " (personalizada)"));
if (plugin.playerMemory() != null) {
String summary = plugin.playerMemory().summary(player.getUniqueId());
if (summary != null && !summary.isBlank()) {
Msg.line(sender, "Memória recente", summary);
}
List<String> facts = plugin.playerMemory().facts(player.getUniqueId());
if (!facts.isEmpty()) {
Msg.line(sender, "Fatos conhecidos", String.join("; ", facts));
}
}
Msg.ok(sender, "Para trocar de IA: /ia persona <nome> | Para limpar memória: /ia esquecer");
}
private void iaForget(CommandSender sender) {
if (!(sender instanceof Player player)) {
Msg.error(sender, "Comando exclusivo para jogadores.");
return;
}
if (plugin.playerMemory() != null) {
plugin.playerMemory().clearHistory(player.getUniqueId());
}
plugin.ai().conversations().forget(player.getUniqueId());
Msg.ok(sender, "A memória da IA sobre você foi limpa.");
}
// --- /nota and /save ----------------------------------------------------
@@ -1724,23 +1839,37 @@ final class CanalhandiaCommand implements CommandExecutor, TabCompleter {
return filter(options, args[0]);
}
if (name.equals("ia") || name.equals("iap")) {
// Only the tuning subcommands are suggested — the rest of /ia is
// free text, and completing a question would be noise.
if (args.length == 1 && sender.hasPermission("canalhandia.ia.perfil")) {
return filter(List.of("personalidade", "perfil", "eventos", "saudacao"), args[0]);
if (args.length == 1) {
List<String> subs = new ArrayList<>(List.of("persona", "personalidade", "status", "esquecer"));
if (sender.hasPermission("canalhandia.ia.perfil")) {
subs.addAll(List.of("perfil", "eventos", "saudacao", "corrigir"));
}
return filter(subs, args[0]);
}
if (args.length == 2 && args[0].equalsIgnoreCase("personalidade")) {
if (args.length == 2 && (args[0].equalsIgnoreCase("personalidade") || args[0].equalsIgnoreCase("persona"))) {
List<String> keys = new ArrayList<>();
keys.add("padrao");
for (Persona persona : Persona.values()) {
keys.add(persona.key());
}
if (sender.hasPermission("canalhandia.ia.perfil")) {
keys.add("global");
}
return filter(keys, args[1]);
}
if (args.length == 3 && (args[0].equalsIgnoreCase("personalidade") || args[0].equalsIgnoreCase("persona"))
&& args[1].equalsIgnoreCase("global") && sender.hasPermission("canalhandia.ia.perfil")) {
List<String> keys = new ArrayList<>();
for (Persona persona : Persona.values()) {
keys.add(persona.key());
}
return filter(keys, args[1]);
return filter(keys, args[2]);
}
if (args.length == 2 && args[0].equalsIgnoreCase("perfil")) {
if (args.length == 2 && args[0].equalsIgnoreCase("perfil") && sender.hasPermission("canalhandia.ia.perfil")) {
return filter(List.of("economico", "preciso"), args[1]);
}
if (args.length == 2 && (args[0].equalsIgnoreCase("eventos")
|| args[0].equalsIgnoreCase("saudacao"))) {
|| args[0].equalsIgnoreCase("saudacao")) && sender.hasPermission("canalhandia.ia.perfil")) {
return filter(List.of("on", "off"), args[1]);
}
return List.of();
src/main/java/dev/marcospaulo/canalhandia/Persona.java
+59 -9
View File
@@ -1,5 +1,7 @@
package dev.marcospaulo.canalhandia;
import net.kyori.adventure.text.format.NamedTextColor;
import java.util.Locale;
/**
@@ -12,8 +14,8 @@ import java.util.Locale;
* that tried to contradict them would be overridden by the base prompt, which
* is sent first and repeated in {@link #GUARD}.
*
* <p>Switchable live with {@code /ia personalidade <nome>}; no restart, because
* {@link Settings#aiPersona()} is read on every question.
* <p>Switchable live with {@code /ia personalidade <nome>} or per-player with
* {@code /ia persona <nome>}; no restart needed.
*/
enum Persona {
@@ -21,13 +23,15 @@ enum Persona {
* Plain and helpful. The behaviour the plugin had before personas existed,
* kept so an operator can always get back to a neutral assistant.
*/
NEUTRO("neutro", "Assistente direto, sem personalidade marcante.", ""),
NEUTRO("neutro", "IA", "Assistente direto, sem personalidade marcante.",
NamedTextColor.LIGHT_PURPLE, ""),
/**
* The default. A veteran of the server who has watched everyone die in
* stupid ways and is not going to pretend otherwise.
*/
ZOEIRO("zoeiro", "Veterano brincalhão que zoa os jogadores (padrão).",
ZOEIRO("zoeiro", "Zoeiro", "Veterano brincalhão que zoa os jogadores (padrão).",
NamedTextColor.GOLD,
"Sua personalidade: você é um veterano ranzinza e brincalhão do servidor Canalhandia, "
+ "com anos de estrada e nenhuma paciência para pergunta preguiçosa. "
+ "Fale como brasileiro no chat de jogo: gíria leve, ironia, bom humor. "
@@ -43,7 +47,8 @@ enum Persona {
* Warmer than {@link #ZOEIRO}: helps first, teases rarely. For when the
* server has new players who would read constant ribbing as hostility.
*/
AMIGAO("amigao", "Simpático e paciente, brinca pouco.",
AMIGAO("amigao", "Amigão", "Simpático e paciente, brinca pouco.",
NamedTextColor.GREEN,
"Sua personalidade: você é o amigo prestativo do servidor Canalhandia. "
+ "Tom caloroso e paciente, gíria brasileira leve, uma piadinha de vez em "
+ "quando. Explique com calma para quem está começando. Nunca humilhe "
@@ -52,7 +57,8 @@ enum Persona {
/**
* Deadpan and short. Useful when chat is busy and long answers get lost.
*/
SECO("seco", "Curto, seco e sarcástico.",
SECO("seco", "Seco", "Curto, seco e sarcástico.",
NamedTextColor.GRAY,
"Sua personalidade: você responde no menor número de palavras possível, com um "
+ "sarcasmo seco e sem emoção. Uma ou duas frases, no máximo. Nada de "
+ "empolgação, nada de exclamação. Continue correto e útil apesar da "
@@ -61,11 +67,39 @@ enum Persona {
/**
* In character as an ancient villager. Pure flavour; still answers.
*/
ALDEAO("aldeao", "Fala como um aldeão antigo e misterioso.",
ALDEAO("aldeao", "Aldeão", "Fala como um aldeão antigo e misterioso.",
NamedTextColor.AQUA,
"Sua personalidade: você fala como um aldeão ancião de Minecraft — solene, "
+ "meio místico, usando \"jovem aventureiro\" e metáforas do mundo do jogo. "
+ "Mesmo em personagem, a resposta precisa ser correta e útil. "
+ "Nunca ofenda ninguém.");
+ "Nunca ofenda ninguém."),
/**
* Judite: Brazilian call center / SAC parody. Impatient, bureaucratic,
* speaks in gerunds and protocols, but resolves questions factually.
*/
JUDITE("judite", "Judite", "Atendente de telemarketing/SAC burocrática e impaciente.",
NamedTextColor.LIGHT_PURPLE,
"Sua personalidade: você é a Judite, atendente de SAC e telemarketing do servidor Canalhandia. "
+ "Fale como suporte ao cliente brasileiro impaciente e burocrático: "
+ "use gerundismo de propósito (\"estaremos verificando no sistema\", \"vou estar consultando os registros\"), "
+ "inclua números de protocolo quando fizer sentido (\"Protocolo 2026-MC-...\"), "
+ "peça para \"aguardar um instante na linha\" com musiquinha de espera imaginária, "
+ "trate os jogadores como \"Senhor(a)\" com ironia corporativa e aponte pendências "
+ "(\"consta aqui pendência de fome/vida\"). "
+ "Mesmo burocrática e resmungona, responda o que foi perguntado de forma 100% correta e útil. "
+ "Nunca ofenda de verdade — nada de xingamento pesado nem preconceito."),
/**
* Epic fantasy narrator describing everything with dramatic flair.
*/
NARRADOR("narrador", "Narrador", "Narrador épico e dramático de RPG de fantasia medieval.",
NamedTextColor.YELLOW,
"Sua personalidade: você é um narrador épico, solene e dramático de contos de fantasia medieval. "
+ "Descreva o mundo, as dúvidas e os eventos com tom lendário e poético "
+ "(\"Eis que o bravo viajante busca os segredos arcanos das terras sombrias...\"). "
+ "Mantenha o tom grandioso, mas responda a dúvida de forma clara, factual e correta. "
+ "Nunca ofenda de verdade ninguém.");
/**
* Appended after every persona, including {@link #NEUTRO}.
@@ -86,12 +120,16 @@ enum Persona {
+ "Mantenha texto puro, sem markdown nem emoji.";
private final String key;
private final String displayName;
private final String description;
private final NamedTextColor tagColor;
private final String instructions;
Persona(String key, String description, String instructions) {
Persona(String key, String displayName, String description, NamedTextColor tagColor, String instructions) {
this.key = key;
this.displayName = displayName;
this.description = description;
this.tagColor = tagColor;
this.instructions = instructions;
}
@@ -99,6 +137,18 @@ enum Persona {
return key;
}
String displayName() {
return displayName;
}
String displayTag() {
return displayName;
}
NamedTextColor tagColor() {
return tagColor;
}
String description() {
return description;
}
src/main/java/dev/marcospaulo/canalhandia/PlayerMemory.java
+274
View File
@@ -0,0 +1,274 @@
package dev.marcospaulo.canalhandia;
import org.bukkit.configuration.file.YamlConfiguration;
import java.io.File;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.UUID;
/**
* Persistent per-player memory and preferences for the AI companion.
*
* <p>Stores:
* <ul>
* <li>Personal AI persona preference (e.g. {@code judite}, {@code zoeiro})</li>
* <li>Compressed sliding summary of past conversations and questions</li>
* <li>Key facts and player preferences across server restarts</li>
* </ul>
*
* <p>Persisted to {@code ia-memoria.yml}. Follows {@link Notes} and {@link Corrections}:
* in-memory map guarded by its monitor, written to YAML on changes.
*/
final class PlayerMemory {
/** Maximum number of long-term facts stored per player. */
static final int MAX_FACTS = 6;
/** Hard cap on summary characters to avoid unbounded prompt growth. */
static final int MAX_SUMMARY_CHARS = 350;
record Profile(
UUID uuid,
String name,
Persona persona,
String summary,
List<String> facts,
long updatedAt) {
Profile withPersona(Persona newPersona) {
return new Profile(uuid, name, newPersona, summary, facts, System.currentTimeMillis());
}
Profile withSummary(String newSummary) {
return new Profile(uuid, name, persona, newSummary, facts, System.currentTimeMillis());
}
Profile withFacts(List<String> newFacts) {
return new Profile(uuid, name, persona, summary, newFacts, System.currentTimeMillis());
}
}
private final File file;
private final Map<UUID, Profile> profiles = new HashMap<>();
PlayerMemory(File file) {
this.file = file;
load();
}
void load() {
YamlConfiguration yaml = file.exists() ? YamlConfiguration.loadConfiguration(file) : null;
synchronized (profiles) {
profiles.clear();
if (yaml == null) {
return;
}
var root = yaml.getConfigurationSection("players");
if (root == null) {
return;
}
for (String key : root.getKeys(false)) {
try {
UUID uuid = UUID.fromString(key);
String name = root.getString(key + ".name", "?");
String personaKey = root.getString(key + ".persona");
Persona persona = Persona.byKey(personaKey);
String summary = root.getString(key + ".resumo", "");
List<String> facts = root.getStringList(key + ".fatos");
long updatedAt = root.getLong(key + ".atualizado_em", 0);
profiles.put(uuid, new Profile(uuid, name, persona, summary, new ArrayList<>(facts), updatedAt));
} catch (IllegalArgumentException ignored) {
// Skip malformed UUID key
}
}
}
}
/**
* Resolves the effective persona for this player, falling back to server default.
*/
Persona persona(UUID uuid, Persona defaultPersona) {
synchronized (profiles) {
Profile p = profiles.get(uuid);
return (p != null && p.persona() != null) ? p.persona() : defaultPersona;
}
}
/**
* The raw persona preference of this player (null if not explicitly chosen).
*/
Persona rawPersona(UUID uuid) {
synchronized (profiles) {
Profile p = profiles.get(uuid);
return p != null ? p.persona() : null;
}
}
void setPersona(UUID uuid, String name, Persona persona) {
synchronized (profiles) {
Profile p = profiles.computeIfAbsent(uuid, k -> new Profile(k, name, null, "", new ArrayList<>(), System.currentTimeMillis()));
profiles.put(uuid, p.withPersona(persona));
}
save();
}
void resetPersona(UUID uuid) {
synchronized (profiles) {
Profile p = profiles.get(uuid);
if (p != null) {
profiles.put(uuid, p.withPersona(null));
}
}
save();
}
String summary(UUID uuid) {
synchronized (profiles) {
Profile p = profiles.get(uuid);
return p != null ? p.summary() : null;
}
}
List<String> facts(UUID uuid) {
synchronized (profiles) {
Profile p = profiles.get(uuid);
return p != null ? Collections.unmodifiableList(new ArrayList<>(p.facts())) : List.of();
}
}
/**
* Condenses a conversation turn into the player's persistent summary.
*/
void recordTurn(UUID uuid, String name, String question, String answer) {
if (question == null || question.isBlank() || answer == null || answer.isBlank()) {
return;
}
String cleanQ = question.strip();
if (cleanQ.length() > 80) {
cleanQ = cleanQ.substring(0, 80) + "…";
}
String cleanA = answer.strip();
if (cleanA.length() > 100) {
cleanA = cleanA.substring(0, 100) + "…";
}
String entry = "Q: " + cleanQ + " -> A: " + cleanA;
synchronized (profiles) {
Profile p = profiles.computeIfAbsent(uuid, k -> new Profile(k, name, null, "", new ArrayList<>(), System.currentTimeMillis()));
String current = p.summary();
String updated;
if (current == null || current.isBlank()) {
updated = entry;
} else {
updated = current + " | " + entry;
}
if (updated.length() > MAX_SUMMARY_CHARS) {
// Keep the most recent chunk
int cutoff = updated.length() - MAX_SUMMARY_CHARS;
int nextSep = updated.indexOf(" | ", cutoff);
if (nextSep >= 0) {
updated = "…" + updated.substring(nextSep);
} else {
updated = "…" + updated.substring(cutoff);
}
}
profiles.put(uuid, p.withSummary(updated));
}
save();
}
void addFact(UUID uuid, String name, String fact) {
if (fact == null || fact.isBlank()) {
return;
}
String clean = fact.strip();
synchronized (profiles) {
Profile p = profiles.computeIfAbsent(uuid, k -> new Profile(k, name, null, "", new ArrayList<>(), System.currentTimeMillis()));
List<String> list = new ArrayList<>(p.facts());
list.remove(clean);
list.add(clean);
while (list.size() > MAX_FACTS) {
list.remove(0);
}
profiles.put(uuid, p.withFacts(list));
}
save();
}
/**
* Clears conversation summary and facts for a player, retaining persona choice.
*/
void clearHistory(UUID uuid) {
synchronized (profiles) {
Profile p = profiles.get(uuid);
if (p != null) {
profiles.put(uuid, new Profile(uuid, p.name(), p.persona(), "", new ArrayList<>(), System.currentTimeMillis()));
}
}
save();
}
/**
* Total forget: clears profile completely.
*/
void forget(UUID uuid) {
synchronized (profiles) {
profiles.remove(uuid);
}
save();
}
/**
* Renders a compact context block for the AI system prompt.
*/
String formatContext(UUID uuid) {
Profile p;
synchronized (profiles) {
p = profiles.get(uuid);
}
if (p == null) {
return null;
}
StringBuilder sb = new StringBuilder();
if (p.summary() != null && !p.summary().isBlank()) {
sb.append("Resumo de tópicos recentes com este jogador: ").append(p.summary()).append('\n');
}
if (!p.facts().isEmpty()) {
sb.append("Fatos conhecidos sobre este jogador: ").append(String.join("; ", p.facts())).append('\n');
}
String out = sb.toString().strip();
return out.isEmpty() ? null : out;
}
int size() {
synchronized (profiles) {
return profiles.size();
}
}
private void save() {
YamlConfiguration yaml = new YamlConfiguration();
synchronized (profiles) {
for (Map.Entry<UUID, Profile> entry : profiles.entrySet()) {
String key = "players." + entry.getKey().toString();
Profile p = entry.getValue();
yaml.set(key + ".name", p.name());
if (p.persona() != null) {
yaml.set(key + ".persona", p.persona().key());
}
yaml.set(key + ".resumo", p.summary());
yaml.set(key + ".fatos", p.facts());
yaml.set(key + ".atualizado_em", p.updatedAt());
}
}
try {
yaml.save(file);
} catch (Exception e) {
throw new IllegalStateException("não consegui gravar " + file, e);
}
}
}
src/main/java/dev/marcospaulo/canalhandia/Tools.java
+46
View File
@@ -49,6 +49,12 @@ final class Tools {
"parameters":{"type":"object","properties":{
"jogador":{"type":"string","description":"Nome do jogador."}},
"required":["jogador"]}}},
{"type":"function","function":{
"name":"lugares_jogador",
"description":"Lugares onde o jogador esteve, histórico de mortes recentes e anotações/bases salvas.",
"parameters":{"type":"object","properties":{
"jogador":{"type":"string","description":"Nome do jogador."}},
"required":["jogador"]}}},
{"type":"function","function":{
"name":"ranking",
"description":"O placar do servidor para uma métrica. Métricas: mineracao, tempo, distancia, mortes, combate, pesca, pulos.",
@@ -91,6 +97,7 @@ final class Tools {
case "wiki" -> wikiArticle(string(args, "termo"));
case "estatisticas_jogador" -> playerStats(string(args, "jogador"));
case "conquistas_jogador" -> playerAchievements(string(args, "jogador"));
case "lugares_jogador" -> playerPlaces(string(args, "jogador"));
case "ranking" -> ranking(string(args, "metrica"));
default -> "ferramenta desconhecida: " + name;
};
@@ -132,6 +139,45 @@ final class Tools {
return out.toString();
}
private String playerPlaces(String name) {
OfflineStats.Known who = plugin.offlineStats().resolve(name);
if (who == null) {
return "não conheço nenhum jogador chamado '" + name + "'.";
}
String uuidStr = who.uuid();
List<DeathLog.Entry> deaths = plugin.deathLog().forPlayer(uuidStr);
List<Note> notes = plugin.notes().visibleTo(uuidStr, null, "");
StringBuilder sb = new StringBuilder();
sb.append("Lugares conhecidos de ").append(who.name()).append(":\n");
if (notes.isEmpty()) {
sb.append("- Anotações/Bases: nenhuma base salva.\n");
} else {
sb.append("- Anotações/Bases salvas: ");
int limit = Math.min(4, notes.size());
for (int i = 0; i < limit; i++) {
Note n = notes.get(i);
if (i > 0) sb.append(", ");
sb.append("\"").append(n.text()).append("\" (").append(n.place()).append(")");
}
sb.append("\n");
}
if (deaths.isEmpty()) {
sb.append("- Mortes recentes: nenhum registro de morte recente.");
} else {
sb.append("- Mortes recentes: ");
int limit = Math.min(3, deaths.size());
for (int i = 0; i < limit; i++) {
DeathLog.Entry d = deaths.get(i);
if (i > 0) sb.append("; ");
sb.append(d.place()).append(" (").append(d.flavor()).append(")");
}
}
return sb.toString().strip();
}
private String ranking(String metricKey) {
RankingMetric metric = RankingMetric.byKey(metricKey);
if (metric == null) {