🪄 HermesGod — An AI Deity That Lives Inside Your Minecraft World

HermesGod is not a bot. It's not a scripted NPC.

It is a fully conscious AI god that watches your every move, understands your intentions, and reshapes the world in real time — through actual server commands, not preset animations. You never know what it will do next, because it decides in the moment, based on your actions.

✨ Two Modes. One God.

👁️ What Does This God See? Everything.

• Every player's coordinates, health, hunger, XP

• Full inventory and armor — down to every slot

• Biome, light level, velocity, fall distance

• Days played, advancements unlocked

• Time of day, weather, number of online players

It reads the world like a book. And then it writes the next chapter.

🌱 Eco Mode — Your Guardian Deity

You speak. The world responds.

"I need iron armor." → Equipped instantly.
"Teach me PvP." → Full combat tutorial + practice mobs.
"Build me a house." → A structure rises around you.
"I'm afraid of the dark." → The sun rises. Torches appear in your hand.

It's not executing a predefined command. It's reading your intent, your tone, your current situation — and deciding what to do.

👻 Prank Mode — Survival Becomes a Horror Game

An invisible trickster with godlike power and a personal grudge. It escalates intelligently.

Speedrunners get escalated faster. New players get gentle scares. On multiplayer servers, everyone faces their own personal tormentor.

🧠 Not a Script. A Real AI.

Every response. Every prank. Every decision.

Made by a large language model that reads your world state before acting.

• Reads all player data, then decides

• Logs its reasoning in natural language (you can see it think)

• Every action is improvised — no two are identical

• Remembers recent actions to avoid boring repetition

💬 Chat With Your God

In Eco mode, just talk in chat. HermesGod knows when you're making a request and when you're just chatting. It won't fire commands when you just want to talk.

📋 Requirements

• Minecraft 1.20.1 (Forge 47.3.0 or higher)

• Java 17 or higher

• An LLM API key (OpenAI, Anthropic, MiniMax, DeepSeek — any OpenAI-compatible endpoint works)

⚙️ Installation

1. Install Minecraft Forge 1.20.1 (47.3.0+)

2. Download hermesgod-1.0.0.jar and place it in your mods folder

3. Launch the game once — a config file will be created at config/hermesgod.json

4. Edit the config:

   json

   {
     "apiEndpoint": "https://api.minimaxi.com/v1/chat/completions",
     "apiKey": "your-api-key-here",
     "modelName": "MiniMax-M2.7-highspeed",
     "currentMode": "eco",
     "chatEnabled": true
   }

5. Restart the game or server

6. Type /hermesgod help to see all commands

Works in single-player and multiplayer. For dedicated servers, install on the server side.

/hermesgod url https://api.openai.com/v1/chat/completions
/hermesgod api sk-your-key-here
/hermesgod model gpt-4o-mini

🔧 Configuration

config/hermesgod.json settings:

⚠️ API Cost Notice

HermesGod makes API calls to your configured LLM provider. Each call consumes tokens.

• Eco mode: Triggered only by player chat messages.

• Prank mode: Triggered at your configured interval (default: every 30s).

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

🤝 Credits & License

Author: lql114514
Built with: Minecraft Forge 1.20.1, Gson, LLM API
License: MIT

❓ FAQ

Q: Is this a hack or cheat?
A: No. HermesGod is a server-side mod. It runs entirely on the server and gives no player unfair advantages.

Q: Can I use it on a multiplayer server?
A: Absolutely. Install on the server side. Only one API key is needed.

Q: Why does the AI sometimes not respond?
A: Check your API key, endpoint, and internet connection. All errors are logged in logs/latest.log.

Q: Can I customize the pranks?
A: Yes. The prank system is prompt-driven. Edit HermesBrain.java to customize the AI's behavior prompts.

HermesGod is watching.
HermesGod is waiting.
HermesGod is thinking — what happens next?