# HermesGod<\/p>\n
**An omniscient AI deity inhabits your Minecraft world \u2014 it sees everything players do, pranks them dynamically, helps with resources, or just chats.**<\/p>\n
—<\/p>\n
## What is HermesGod?<\/p>\n
HermesGod is not a bot or an NPC. It’s a **world deity** \u2014 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.<\/p>\n
It runs on any LLM you configure (OpenAI, Anthropic, MiniMax, DeepSeek, or any OpenAI-compatible API).<\/p>\n
—<\/p>\n
## How It Works<\/p>\n
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.<\/p>\n
This means **every response is unique** \u2014 no scripts, no hardcoded pranks. The AI decides what to do on the fly.<\/p>\n
—<\/p>\n
## Modes<\/p>\n
### \ud83c\udf31 Eco Mode \u2014 Guardian
\nTalk to HermesGod in chat. Ask for gear, resources, mobs, or just chat. It can:
\n– Give you items and equipment
\n– Summon mobs for training
\n– Build structures around you
\n– Explain game mechanics
\n– Or just talk without doing anything<\/p>\n
> *”I need iron armor” \u2192 You get iron armor*
\n> *”Teach me PvP” \u2192 Tutorial + practice mobs appear*
\n> *”Just chat” \u2192 It talks, no commands executed*<\/p>\n
### \ud83d\udc7b Prank Mode \u2014 Trickster
\nThe AI silently pranks players with **dynamic difficulty** that scales with their progress:<\/p>\n
| Level | What Happens |
\n|——-|————-|
\n| **1** | Creepy sounds, portal particles, flickering lights, disorienting teleports |
\n| **2** | Monster ambushes, item theft, negative effects, pumpkin head |
\n| **3** | Lava traps, obsidian prisons, evoker fangs, TNT, elite mobs |
\n| **4** | Withers, wardens, void drops, full invasions |<\/p>\n
Difficulty is calculated from days played, armor, advancements, and dimension. Speedrunners get escalated faster. Fresh spawns get gentle scares.<\/p>\n
The AI remembers what it did last (up to 10 actions) to avoid repeating itself.<\/p>\n
### Other Modes (In Development)
\nIn development…<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | What it does | —<\/p>\n ## Installation<\/p>\n 1. Install **Minecraft Forge 1.20.1** “`json 5. Restart and type `\/hermesgod help`<\/p>\n Works on **single-player** and **dedicated servers** (server-side only \u2014 clients don’t need the mod).<\/p>\n —<\/p>\n ## Configuration<\/p>\n All settings in `config\/hermesgod.json`:<\/p>\n | Setting | Default | Description | —<\/p>\n ## Requirements<\/p>\n – Minecraft **1.20.1** Forge **(47.3.0+)** —<\/p>\n ## API Costs<\/p>\n 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).<\/p>\n Use lightweight models like `gpt-4o-mini` or `MiniMax-M2.7-highspeed` to keep costs low.<\/p>\n —<\/p>\n ## FAQ<\/p>\n **Q: Is this a hacked client?** **Q: Can I use it on my multiplayer server?** **Q: Why isn’t the AI responding?** **Q: Can I add my own pranks?** —<\/p>\n **HermesGod watches. HermesGod waits. HermesGod decides.**<\/p>\n","protected":false},"excerpt":{"rendered":" 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.<\/p>\n","protected":false},"featured_media":80610,"template":"","meta":{"_minecraft_slug":"hermesgod","_minecraft_project_id":"pLM2ycFi","_minecraft_author":"BYD666-WQ","_minecraft_license":"Apache-2.0","_minecraft_downloads":13,"_minecraft_follows":0,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"hermesgod.zip","_minecraft_size_bytes":149676,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T12:20:33.866939Z","_minecraft_date_created":"2026-05-12T06:22:41.313718Z","_minecraft_date_modified":"2026-05-06T07:01:44.651650Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hermesgod","_minecraft_icon_attachment_id":80610,"_minecraft_imported_at":"2026-06-04T15:26:55+00:00","_minecraft_import_hash":"973e6b77ec3722111185fcdb82a9dbc0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,89,126,90,92],"mod_loader":[106],"minecraft_version":[36],"class_list":["post-80609","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-utility","mod_loader-forge","minecraft_version-1-20-1"],"yoast_head":"\n
\n|———|————-|
\n| `\/hermesgod mode
\n| `\/hermesgod chat
\n| `\/hermesgod status` | See current mode, API status, last action |
\n| `\/hermesgod interval
\n| `\/hermesgod interval
\n| `\/hermesgod api
\n| `\/hermesgod url
\n| `\/hermesgod model
\n| `\/hermesgod maxtokens
\n| `\/hermesgod reset` | Clear conversation history |
\n| `\/hermesgod config` | View all current settings |
\n| `\/hermesgod help` | Show all commands |<\/p>\n
\n2. Put the `.jar` in your `mods` folder
\n3. Launch the game \u2014 `config\/hermesgod.json` is created
\n4. Edit the config with your API key and endpoint:<\/p>\n
\n{
\n “apiEndpoint”: “https:\/\/api.openai.com\/v1\/chat\/completions”,
\n “apiKey”: “sk-your-key-here”,
\n “modelName”: “gpt-4o-mini”,
\n “currentMode”: “eco”
\n}
\n“`<\/p>\n
\n|———|———|————-|
\n| `apiEndpoint` | `https:\/\/api.minimaxi.com\/v1\/chat\/completions` | OpenAI-compatible API |
\n| `apiKey` | `””` | Your API key |
\n| `modelName` | `MiniMax-M2.7-highspeed` | LLM model |
\n| `currentMode` | `disabled` | Starting mode |
\n| `chatEnabled` | `true` | Allow chat interaction |
\n| `prankIntervalMin` | `30` | Min seconds between prank thoughts (0 = off) |
\n| `prankIntervalMax` | `30` | Max seconds between prank thoughts |
\n| `maxTokens` | `8000` | Max tokens per API call |
\n| `temperature` | `0.8` | AI creativity |<\/p>\n
\n– Java 17+
\n– An API key for your chosen LLM provider<\/p>\n
\nA: No. It’s a server-side mod that uses OP commands. It gives no unfair advantage to any player.<\/p>\n
\nA: Yes. Install on the server. Only one API key needed.<\/p>\n
\nA: Check your API key, endpoint, and internet. Errors are logged in `logs\/latest.log`.<\/p>\n
\nA: The prank system is prompt-driven. Edit `HermesBrain.java` to add custom trick descriptions.<\/p>\n