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:

Level	What Happens
1	Creepy sounds, portal particles, flickering lights, disorienting teleports
2	Monster ambushes, item theft, negative effects, pumpkin head
3	Lava traps, obsidian prisons, evoker fangs, TNT, elite mobs
4	Withers, wardens, void drops, full invasions

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

Command	What it does
/hermesgod mode <eco/prank/disabled>	Switch mode
/hermesgod chat <message>	Talk to HermesGod from console
/hermesgod status	See current mode, API status, last action
/hermesgod interval <seconds>	Set fixed prank thinking interval (e.g. interval 60 = every 60s). Set 0 to disable
/hermesgod interval <min> <max>	Random interval between min and max seconds (e.g. interval 30 90)
/hermesgod api <key>	Set your API key in-game
/hermesgod url <endpoint>	Set API endpoint URL in-game
/hermesgod model <name>	Set the LLM model name
/hermesgod maxtokens <count>	Set max tokens per API call (1~32000)
/hermesgod reset	Clear conversation history
/hermesgod config	View all current settings
/hermesgod help	Show all 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:

Setting	Default	Description
apiEndpoint	https://api.minimaxi.com/v1/chat/completions	OpenAI-compatible API
apiKey	""	Your API key
modelName	MiniMax-M2.7-highspeed	LLM model
currentMode	disabled	Starting mode
chatEnabled	true	Allow chat interaction
prankIntervalMin	30	Min seconds between prank thoughts (0 = off)
prankIntervalMax	30	Max seconds between prank thoughts
maxTokens	8000	Max tokens per API call
temperature	0.8	AI creativity

---

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.