Seth/minecraft-ai-god
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
d28df9c161c2a8d8d1eed022506467c8044e8d57
minecraft-ai-god/CONVERSATION.md
T
Claude Code d28df9c161 Add /update-context workflow to CONVERSATION.md
2026-03-17 00:38:22 -04:00

5.2 KiB
Raw Blame History

Project Conversation Context

This document links the two Minecraft AI God projects together, describes their Gitea repos, and serves as the AI conversation anchor for both.

The Two Projects

This repo — minecraft-ai-god (Vanilla)

  • Local path: /root/bin/Sethpc-Minecraft
  • Gitea: https://git.sethpc.xyz/Seth/minecraft-ai-god
  • Purpose: Vanilla Minecraft 1.21.x, no plugins or mods. All automation via log watching + RCON. Targets the mc1 server (port 25565) and shrink-world server (port 25566) on CT 644.
  • Key services: mc-godmode.service, mc-shrink-kit.service, mc-aigod.service
  • AI features: pray chat trigger → Ollama LLM → structured JSON → RCON execution; divine intervention timer; shrink-world kit/stats watcher

Sister repo — minecraft-ai-god-paper-fork (Paper Advanced Fork)

  • Local path: /root/bin/Sethpc-Minecraft-PaperFork
  • Gitea: https://git.sethpc.xyz/Seth/minecraft-ai-god-paper-fork
  • Purpose: Dedicated Paper server on port 25567 with plugins (FastAsyncWorldEdit, LuckPerms). Extends the vanilla branch with build templates, expanded command set, sudo translator mode, and LangGraph-style session gateway.
  • Key services: mc-paper-ai.service, mc-aigod-paper.service, mc-langgraph-gateway.service
  • AI features: All vanilla features + sudo build/make/create deterministic templates, sudo lookup/wiki/search, LangGraph gateway sidecar (FastAPI on 127.0.0.1:8091), SQLite session persistence

Relationship Between the Two

The Paper fork is a direct evolution of this vanilla repo. They share:

  • Same pray/bible/sudo trigger style and chat patterns
  • Same two-call LLM split (message + commands JSON schema)
  • Same RCON helper (raw socket, no library)
  • Same command validation + syntax repair pipeline
  • Same intervention timer design (Poisson process, presence guard)

The Paper fork adds on top of this base:

  • Plugin-enabled command families (fill, setblock, clone)
  • Deterministic build templates before LLM translation
  • LangGraph gateway with session memory and tool loop
  • server_type gating so paper commands don't leak to vanilla

Both can run simultaneously — they use separate ports, services, and config files.

Gitea Backup Workflow

Both repos push every committed change to Gitea. This is the standard workflow:

# From either local repo dir:
git add -A
git commit -m "<description of change>"
git push origin main

Both remotes are pre-configured with token auth:

  • Vanilla: https://Seth:<token>@git.sethpc.xyz/Seth/minecraft-ai-god.git
  • Paper fork: https://Seth:<token>@git.sethpc.xyz/Seth/minecraft-ai-god-paper-fork.git

The Gitea instance lives at git.sethpc.xyz (CT 146, node-173, 192.168.0.125).
API key: see GITEA_API.md in this repo.

Convention: commit every meaningful change immediately. Commits are the changelog — no squashing, no batching unrelated changes.

Keeping This File Current

Run /update-context in OpenCode at the end of any session to automatically:

  1. Review the conversation for new decisions, fixes, and discoveries
  2. Append them to CONVERSATION.md in both repos
  3. Commit and push both repos to Gitea

The command is defined globally at ~/.config/opencode/commands/update-context.md.

AI Conversation Notes

This section captures decisions and context accumulated across conversations with the AI assistant (OpenCode/Claude). Update it as significant choices are made.

Architecture decisions

  • No plugins on vanilla servers. All mc1 and shrink-world automation is pure log-tail + RCON. This keeps the vanilla experience intact and requires no server restarts for updates.
  • Paper fork is separate, not a branch. Running both as separate services on separate ports was chosen over a single multi-mode script to keep failure domains isolated.
  • LLM backend: Ollama at 192.168.0.179:11434 for the vanilla service. The Paper fork uses 192.168.0.141:11434 (steel141, local GPU) for better throughput on heavier models (gemma3:12b, qwen3-coder:30b).
  • Session gateway (Paper fork only): The LangGraph-style FastAPI sidecar adds multi-turn memory without requiring a full LangGraph install. Safety enforcement stays in mc_aigod_paper.py, not the gateway.

Infrastructure decisions

  • mc1 autoStart: Set to true in MCSManager instance config (/opt/mcsmanager/daemon/data/InstanceConfig/d39f55861cb34204a92a18a9e1c78ca6.json) so the server starts on CT 644 boot. mc-godmode.service uses tail -F and handles the log appearing late gracefully.
  • mc-godmode.service startup: Already enabled (systemctl is-enabled = enabled), WantedBy=multi-user.target, After=mcsm-daemon.service. The service was not failing — the MC server itself wasn't auto-starting (fixed by enabling autoStart).

Open threads / next ideas

  • Prayer history log (JSON) for review and tuning
  • God mood / divine disposition score persisted across restarts
  • Dual-server support in vanilla aigod (watch both mc1 and shrink-world logs)
  • Redis backend for Paper fork gateway sessions (currently SQLite only)
  • MCP-based tool adapters in the gateway tool loop
  • Web dashboard for recent prayers + God responses (n8n or simple Flask)
Reference in New Issue View Git Blame Copy Permalink