Skip to content
allay-aiPublic

About

🛠️⚡ The backend of Allay, an AI helper for Minecraft: a Mastra agent on Bun that answers through OpenRouter, calls the plugin's game tools, and remembers each player. Player data encrypted at rest. EU (GDPR) and US privacy law friendly.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

453 Commits

Folders and files

Repository files navigation

🛠️ Allay Server

GitHub Release Build Docker image License

Русская версия

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.

What you get

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

Get started

  1. Save this as compose.yaml with the newest version, and replace every change-me with its own random value (openssl rand -hex 24). Then run docker 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:
  2. Set server.url in the plugin’s config.yml to http://localhost:3000 and server.token to your PLUGIN_TOKEN, then run /allay reload. Then /allay init opens 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.

  3. Self-hosting with Docker goes further: proxies, passwords, and upgrades.

Documentation

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

Related projects

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

About

🛠️⚡ The backend of Allay, an AI helper for Minecraft: a Mastra agent on Bun that answers through OpenRouter, calls the plugin's game tools, and remembers each player. Player data encrypted at rest. EU (GDPR) and US privacy law friendly.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages