Allay Server is the brain behind Allay, the AI helper for Minecraft players. It answers every /ask from your server: it looks into the player’s game, searches the web, and remembers each player. Run it yourself with one Docker Compose file, or use the hosted one at allay.chat.
- Answers about your world. The agent reads the asker’s inventory, surroundings, recipes, and the server’s plugins before it answers.
- Help in the world. Trails to a spot, ghost blocks to build into, glowing chests that hold what you need, buttons right in every answer.
- Agents that do the chores. Sorting chests, smelting, brewing, and crafting run as automation agents that report back.
- Fresh facts and exact math. Web search when a question needs it, and calculations at 64 significant digits.
- A memory per player. A session for follow-ups, plus up to 200 lasting facts and places the player controls, with tags and pins. Allay changes a fact when it changes and knows the places near the player.
- Privacy by design. Every request says which server sends it, and a server reaches only its own players. Game tools see only the asker, the admin panel names players but never shows what anyone asked, and each player can get a copy of their data or have it erased.
- An admin panel. Every setting, accounts with roles, and statistics on questions, cost, models, and tools.
- OpenTelemetry. Traces of every run, metrics per server, and events go to any OTLP collector, with ready Grafana dashboards. Numbers only: no question or answer leaves.
- Your key, your rules. Bring any OpenAI-compatible key, subscribe in Telegram Stars, or self-host with no limits.
-
Save this as
compose.yamlwith the newest version, and replace everychange-mewith its own random value (openssl rand -hex 24). Then rundocker compose up -d:services: allay: image: ghcr.io/allay-ai/server:6.0.0 restart: unless-stopped depends_on: [allay-mongo] ports: ["127.0.0.1:3000:3000"] environment: MONGODB_URI: mongodb://allay:change-me-mongo@allay-mongo:27017/?authSource=admin MONGODB_DATABASE: allay SELFHOSTED: "1" PLUGIN_TOKEN: change-me-to-24-random-characters SECRETS_KEY: change-me PUBLIC_URL: http://localhost:3000 allay-mongo: image: mongo:8.0 restart: unless-stopped environment: MONGO_INITDB_ROOT_USERNAME: allay MONGO_INITDB_ROOT_PASSWORD: change-me-mongo volumes: [mongo:/data/db] volumes: mongo:
-
Set
server.urlin the plugin’sconfig.ymltohttp://localhost:3000andserver.tokento yourPLUGIN_TOKEN, then run/allay reload. Then/allay initopens the admin panel, where you paste your OpenRouter key. The backend listens on this machine only: a Minecraft server elsewhere reaches it through a reverse proxy with TLS. -
Self-hosting with Docker goes further: proxies, passwords, and upgrades.
The wiki holds the full manual.
For server owners: Self-hosting with Docker · Environment variables · Admin panel and settings · Who pays for the model · What Allay can do · Memory and traces · Telemetry · Troubleshooting
For developers: HTTP API · Architecture · Building from source · Releasing · Development · Plugin protocol
- Moonlands – the hard-survival server where all of these run.
- WorldAPI – REST and WebSocket API to the world, players, and stats of a Paper, Fabric, or NeoForge server.
- Minecraft MCP – lets an AI client read and run a server through WorldAPI.
- Allay – an AI helper in the game: ask with
/ask, right in the chat. - Mo’Joins – join and quit messages in each player’s language.
- Mo’Afks – a safe AFK mode that doesn’t block the night.
- Mo’Bosses – monsters that spawn as bosses with classes, abilities, and loot.
- minecraft-exporter – Prometheus metrics from WorldAPI.
- minecraft-grafana – the Grafana dashboard for WorldAPI.
🫡 Made by Pavel Erokhin (Павел Ерохин), aka mairwunnx.