HermesGod

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

">gutters">

Mode	You're dealing with...
🌱 Eco (Guardian)	An all-powerful ally. Ask for gear. Ask for a house. Ask it to teach you PvP. Say one sentence. Watch the world change.
👻 Prank (Trickster)	An invisible troublemaker. It watches you mine that diamond. It sees you cross that lava. And it waits. No two pranks are ever the same, because it's thinking — not replaying a script.

---

👁️ 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.

">gutters">

Difficulty	What you'll face...
Level 1	Cave whispers, flickering lights, eerie particles
Level 2	Zombie swarms, skeleton snipers, poison potions
Level 3	Lava pools under your feet, obsidian prisons, TNT traps
Level 4	Withers, Wardens, void drops, full-scale invasions

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.

---

🎮 In-Game Commands

⚠️ First-Time Setup (Required)

You must configure these three settings in order before the AI can respond:

">gutters">

Command	Description	Example
/hermesgod url <endpoint>	Set the API endpoint URL for your LLM provider	/hermesgod url https://api.openai.com/v1/chat/completions
/hermesgod api <key>	Set your API key for authentication	/hermesgod api sk-xxxxxxxxxxxxxxxx
/hermesgod model <name>	Specify which language model to use	/hermesgod model gpt-4o-mini

---

📋 Other Commands

">gutters">

Command	Description
/hermesgod help	Display all available commands
/hermesgod mode <eco/prank/disabled>	Switch mode: eco Guardian / prank Trickster / disabled Off
/hermesgod chat <message>	Talk to HermesGod via server console
/hermesgod status	View current mode, API connection status, and last action
/hermesgod interval <seconds>	Set fixed prank interval in seconds (0 to disable auto-pranks)
/hermesgod interval <min> <max>	Set random prank interval range (in seconds)
/hermesgod maxtokens <count>	Set max tokens per API call
/hermesgod reset	Clear the AI's conversation memory and reset context

---

💡 Setup Example

Enter these three commands in order to activate the AI:

text

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

Once configured, use /hermesgod mode eco to enable Guardian mode. You can now talk to the AI in chat.

---

🔧 Configuration

config/hermesgod.json settings:

">gutters">

Setting	Default	Description
apiEndpoint	MiniMax API	OpenAI-compatible endpoint URL
apiKey	""	Your API key
modelName	MiniMax-M2.7-highspeed	Model to use
currentMode	disabled	Default mode on startup
chatEnabled	true	Enable chat interaction
prankIntervalMin	30	Min seconds between pranks (0 = off)
prankIntervalMax	30	Max seconds between pranks
maxTokens	8000	Max tokens per LLM call
temperature	0.8	AI creativity level

---

⚠️ 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?

undefined