HermesGod

A Forge mod that turns an LLM into a living world deity who can prank players, spawn mobs, build structures, and chat with you as if the server itself is alive.

# 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 ` | Switch mode |

| `/hermesgod chat ` | Talk to HermesGod from console |

| `/hermesgod status` | See current mode, API status, last action |

| `/hermesgod interval ` | Set fixed prank thinking interval (e.g. `interval 60` = every 60s). Set `0` to disable |

| `/hermesgod interval ` | Random interval between min and max seconds (e.g. `interval 30 90`) |

| `/hermesgod api ` | Set your API key in-game |

| `/hermesgod url ` | Set API endpoint URL in-game |

| `/hermesgod model ` | Set the LLM model name |

| `/hermesgod maxtokens ` | 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"
}

1. 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.