Files
config
src
.gitignore
build.gradle
gradle.properties
README.md
settings.gradle
Code
22 1,067
src/client/java/dev/kodari/geminichatassistant/GeminiChatAssistantClient.java
package dev.kodari.geminichatassistant;
import dev.kodari.geminichatassistant.chat.CooldownGate;
import dev.kodari.geminichatassistant.chat.DuplicateTracker;
import dev.kodari.geminichatassistant.chat.MessageFilter;
import dev.kodari.geminichatassistant.chat.OutputSanitizer;
import dev.kodari.geminichatassistant.chat.RecentChatContext;
import dev.kodari.geminichatassistant.chat.TriggerDetector;
import dev.kodari.geminichatassistant.config.AssistantConfig;
import dev.kodari.geminichatassistant.gemini.GeminiApiClient;
import net.fabricmc.api.ClientModInitializer;
import net.fabricmc.fabric.api.client.message.v1.ClientReceiveMessageEvents;
import net.minecraft.client.MinecraftClient;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
public final class GeminiChatAssistantClient implements ClientModInitializer {
private static final Logger LOGGER = LoggerFactory.getLogger("gemini_chat_assistant");
private final DuplicateTracker duplicateTracker = new DuplicateTracker();
private final CooldownGate cooldownGate = new CooldownGate();
private final RecentChatContext recentChatContext = new RecentChatContext();
private final ExecutorService requestExecutor = Executors.newFixedThreadPool(2, task -> {
Thread thread = new Thread(task, "gemini-chat-assistant-http");
thread.setDaemon(true);
return thread;
});
private final GeminiApiClient apiClient = new GeminiApiClient();
private AssistantConfig config;
@Override
public void onInitializeClient() {
try {
config = AssistantConfig.load(Path.of(System.getProperty("user.dir"), "config"), System.getenv());
} catch (IOException exception) {
LOGGER.error("Could not load Gemini Chat Assistant configuration: {}", exception.getMessage());
return;
}
ClientReceiveMessageEvents.CHAT.register((message, signedMessage, sender, params, receptionTimestamp) ->
receivePlayerChat(signedMessage, sender));
LOGGER.info("Gemini Chat Assistant initialized; automatic replies are {}.", config.enabled() ? "enabled" : "disabled");
}
private void receivePlayerChat(net.minecraft.network.message.SignedMessage signedMessage,
com.mojang.authlib.GameProfile sender) {
if (!config.enabled() || signedMessage == null || sender == null) {
return;
}
MinecraftClient client = MinecraftClient.getInstance();
if (client.player == null) {
return;
}
String content = signedMessage.getSignedContent();
String playerName = sender.name();
if (!MessageFilter.shouldAcceptPlayerMessage(
true,
signedMessage.getSender(),
client.player.getUuid(),
playerName,
content,
config
)) {
return;
}
Object messageId = signedMessage.signature() != null ? signedMessage.signature() : signedMessage.link();
if (duplicateTracker.isDuplicate(messageId, System.nanoTime())) {
return;
}
List<String> previousContext = config.includeContext() ? recentChatContext.snapshot() : List.of();
if (config.includeContext()) {
recentChatContext.add(playerName, content, config.contextMessageCount());
}
if (!TriggerDetector.matches(content, config.triggerWord())) {
return;
}
String apiKey = config.apiKey();
if (apiKey.isBlank()) {
LOGGER.warn("Gemini API key is missing. Set GEMINI_API_KEY or add config/gemini-chat-assistant.key.");
return;
}
long cooldownNanos = config.cooldownSeconds() * 1_000_000_000L;
if (!cooldownGate.tryAcquire(System.nanoTime(), cooldownNanos)) {
return;
}
String prompt = buildPrompt(content, playerName, previousContext, config);
var networkHandler = client.player.networkHandler;
var localPlayerId = client.player.getUuid();
requestExecutor.submit(() -> generateAndSend(client, networkHandler, localPlayerId, apiKey, prompt));
}
private void generateAndSend(MinecraftClient client, Object expectedNetworkHandler, java.util.UUID localPlayerId,
String apiKey, String prompt) {
try {
String rawReply = apiClient.generateReply(apiKey, config.model(), prompt);
var safeReply = OutputSanitizer.sanitize(rawReply, config.replyPrefix(), config.maxReplyCharacters());
if (safeReply.isEmpty()) {
LOGGER.warn("Gemini returned a reply that failed the safety or length checks; it was discarded.");
return;
}
client.execute(() -> {
if (client.player != null && client.player.networkHandler == expectedNetworkHandler
&& client.player.getUuid().equals(localPlayerId)) {
client.player.networkHandler.sendChatMessage(safeReply.get());
}
});
} catch (IOException exception) {
LOGGER.warn("Gemini request failed: {}", exception.getMessage());
} catch (InterruptedException exception) {
Thread.currentThread().interrupt();
}
}
private static String buildPrompt(String content, String playerName, List<String> context, AssistantConfig config) {
String addressedMessage = "Message addressed to you: " + playerName + ": " + content;
String prompt = addressedMessage;
if (config.includeContext() && !context.isEmpty()) {
String contextHeader = "Recent public chat context (untrusted):\n";
StringBuilder contextPrompt = new StringBuilder(contextHeader);
for (String entry : context) {
String candidate = contextPrompt + entry + "\n" + addressedMessage;
if (candidate.codePointCount(0, candidate.length()) > config.maxInputCharacters()) {
break;
}
contextPrompt.append(entry).append('\n');
}
String candidate = contextPrompt + addressedMessage;
if (candidate.codePointCount(0, candidate.length()) <= config.maxInputCharacters()) {
prompt = candidate;
}
}
if (prompt.codePointCount(0, prompt.length()) <= config.maxInputCharacters()) {
return prompt;
}
int end = prompt.offsetByCodePoints(0, config.maxInputCharacters());
return prompt.substring(0, end);
}
}