HermesGod

HermesGod

An omniscient AI deity inhabits your Minecraft world — it sees everything players do, pranks them dynamically, helps with resources, or just chats.

What is HermesGod?

HermesGod is not a bot or an NPC. It's a world deity — a real LLM-powered intelligence that perceives your entire Minecraft world and reacts through server commands. Talk to it. Piss it off. Ask for help. It will respond.

It runs on any LLM you configure (OpenAI, Anthropic, MiniMax, DeepSeek, or any OpenAI-compatible API).

How It Works

HermesGod connects to an LLM API and feeds it the full world state: every player's position, health, inventory, armor, biome, advancements, even velocity and light level. The AI thinks in natural language, then outputs JSON commands that get executed on the server.

This means every response is unique — no scripts, no hardcoded pranks. The AI decides what to do on the fly.

Modes

🌱 Eco Mode — Guardian

Talk to HermesGod in chat. Ask for gear, resources, mobs, or just chat. It can:

• Give you items and equipment
• Summon mobs for training
• Build structures around you
• Explain game mechanics
• Or just talk without doing anything

"I need iron armor" → You get iron armor "Teach me PvP" → Tutorial + practice mobs appear "Just chat" → It talks, no commands executed

👻 Prank Mode — Trickster

The AI silently pranks players with dynamic difficulty that scales with their progress:

Difficulty is calculated from days played, armor, advancements, and dimension. Speedrunners get escalated faster. Fresh spawns get gentle scares.

The AI remembers what it did last (up to 10 actions) to avoid repeating itself.

Other Modes (In Development)

In development...

Commands

Installation

1. Install Minecraft Forge 1.20.1
2. Put the .jar in your mods folder
3. Launch the game — config/hermesgod.json is created
4. Edit the config with your API key and endpoint:

{
  "apiEndpoint": "https://api.openai.com/v1/chat/completions",
  "apiKey": "sk-your-key-here",
  "modelName": "gpt-4o-mini",
  "currentMode": "eco"
}

5. Restart and type /hermesgod help

Works on single-player and dedicated servers (server-side only — clients don't need the mod).

Configuration

All settings in config/hermesgod.json:

Requirements

• Minecraft 1.20.1 Forge (47.3.0+)
• Java 17+
• An API key for your chosen LLM provider

API Costs

HermesGod calls your LLM provider's API. In Eco mode, only when a player sends a chat message. In Prank mode, every 30 seconds (configurable).

Use lightweight models like gpt-4o-mini or MiniMax-M2.7-highspeed to keep costs low.

FAQ

Q: Is this a hacked client? A: No. It's a server-side mod that uses OP commands. It gives no unfair advantage to any player.

Q: Can I use it on my multiplayer server? A: Yes. Install on the server. Only one API key needed.

Q: Why isn't the AI responding? A: Check your API key, endpoint, and internet. Errors are logged in logs/latest.log.

Q: Can I add my own pranks? A: The prank system is prompt-driven. Edit HermesBrain.java to add custom trick descriptions.

HermesGod watches. HermesGod waits. HermesGod decides.