ИИ-помощник для серверов Spigot и Paper
Allay живёт в чате вашего сервера. Игрок пишет /ask, и Allay заглядывает в его настоящую игру — в инвентарь, в блок под прицелом, в сундуки вокруг, в рецепты и плагины этого сервера — и только потом отвечает.
Пример ответа Allay в игровом чате
⠹ Порхаю над сундуками… (3с · ↑ 2 184 · ↓ 61 токен)
/ask куда я дел редстоун?
Что получает игрок
Allay читает игру через инструменты, которые запускает плагин, поэтому ответ подходит этому игроку, этому миру и этому серверу.
«Какой меч лучше?» Allay смотрит инвентарь, блок под прицелом, статистику и достижения, а не гадает.
«Куда я дел редстоун?» — Allay считает его в инвентаре, в эндер-сундуке и в сундуках в радиусе 32 блоков, даже внутри шалкеров и мешков.
Компас и след из частиц ведут к месту смерти, деревне, вишнёвой роще, заметке или к другу на локаторе.
Сортируют сундуки по категориям, плавят поровну, варят зелья в несколько заходов, крафтят на настоящем верстаке. Вы играете, они докладывают.
«Меч первым, еда в последний ряд». Стопки сливаются, закреплённые слоты получают лучший предмет, а [Вернуть как было] отменяет всё 5 минут.
Рецепты, все шаги варки, самый дешёвый порядок на наковальне, чары и сделки жителей — в один клик под ответом.
«Почему не открывается дверь?» Allay читает схему и отмечает поломку. Экспериментальные чертежи показывают постройку призрачными блоками, слой за слоем.
Заметки с привязкой к месту, цели полосой вверху экрана и напоминания от 1 до 120 минут.
Поиск в интернете, когда вопрос того требует, и расчёты с точностью до 64 знаков: стопки, координаты Незера, опыт.
Как спросить
Allay отвечает на языке вопроса. Пока он работает, в строке действий видно, чем он занят, а в чате появляется строка для каждого инструмента.
/ask <вопрос>/askall <вопрос>/askx <что сделать>/allay chat отправляет Allay всё, что вы пишете в чат. Первый символ решает, куда уйдёт строка:
| Вы пишете | Куда уйдёт |
|---|---|
как найти незерит? | Allay, лично, как /ask |
! дай стопку факелов | Allay в виде команд, как /askx |
? где ближайшая деревня? | Всем, как /askall |
~ щас вернусь | В обычный чат |
Память
Сессия игрока хранит обмены целиком, вместе с результатами инструментов, 24 часа после последнего вопроса. «А сколько было в том сундуке?» не требует второго взгляда.
До 30 коротких фактов на игрока: где база, что он строит, какие ответы любит. Allay сохраняет их сам и говорит об этом.
/allay memory показывает факты, /allay forget стирает их, а /allay new начинает разговор заново.
Языки
Тексты плагина есть на пяти языках. Язык выбирается по стране IP-адреса игрока, затем по языку игры, а /allay language выбирает его вручную.
База стран лежит на вашем сервере: для поиска адрес никуда не уходит. Отвечает Allay на том языке, на котором задан вопрос.
Честно по устройству
Allay видит то, что мог бы увидеть сам спросивший, и не даёт обычным игрокам ничего, что они не заработали.
Игровые инструменты видят спросившего и мир вокруг него. Другие игроки видны только так, как их показывает локатор: имя, расстояние, направление.
Инструменты, которые выдают предметы, телепортируют или меняют погоду, доступны только операторам, и плагин проверяет это трижды.
Allay открывает только те контейнеры, которые мог бы открыть игрок, уважает приваты GriefPrevention и не выдаёт игроков в ванише.
Панель администратора не показывает ни вопросы, ни ответы — ни одной роли. Ключи и лицензии никогда не попадают в лог.
Установка
Плагин сразу работает с нашим бэкендом на allay.chat. Можно поднять и свой.
Скопируйте allay-spigot.jar в plugins/ и перезапустите сервер.
Оператором выполните /allay link для подписки или впишите свой ключ OpenRouter в provider.byok и выполните /allay reload.
Напишите /ask как скрафтить маяк? На вопрос «что ты умеешь?» Allay сам расскажет о себе.
Пока Allay есть только на GitHub. Страницы на Modrinth и Hangar появятся позже, а до тех пор берите jar из релизов.
Укажите адрес jar в PLUGINS, и контейнер сам скачает Allay.
services:
minecraft:
image: itzg/minecraft-server:java25
environment:
EULA: "TRUE"
TYPE: PAPER
VERSION: "26.3"
PLUGINS: |
https://github.com/allay-ai/minecraft/releases/latest/download/allay-spigot.jar
ports: ["25565:25565"]
volumes: ["./data:/data"]
Цены
Каждый ответ стоит денег у провайдера модели. Ваш сервер выбирает, кто за это платит.
Бесплатно
На allay.chat, а счёт — от вашего провайдера.
Наш ключ и наши модели, оплата в Telegram Stars.
7 дней
0,75 $ на стоимость модели
30 дней, продлевается сама
3,00 $ на стоимость модели
365 дней
6,00 $ на стоимость модели каждые 30 дней
/allay link оператором/allay statusБесплатно
Ваш бэкенд, ваш ключ, никаких лимитов.
Свой бэкенд
Allay Server — открытый код и один Docker-образ. С SELFHOSTED=1 оплата выключена, и каждый вопрос идёт на вашем ключе.
compose.yaml, замените каждый change-me своим случайным значением и выполните docker compose up -d.server.url в config.yml плагина, тот же PLUGIN_TOKEN — в server.token, и выполните /allay reload./allay init — получите разовую ссылку на панель администратора и вставьте туда ключ OpenRouter.services:
allay:
image: ghcr.io/allay-ai/server:6.0.0
restart: unless-stopped
depends_on: [allay-mongo, allay-redis]
# This machine only. Another machine reaches it through a reverse proxy with TLS.
ports: ["127.0.0.1:3000:3000"]
environment:
MONGODB_URI: mongodb://allay:change-me-mongo@allay-mongo:27017/?authSource=admin
MONGODB_DATABASE: allay
REDIS_URL: redis://:change-me-redis@allay-redis:6379
# Your own backend: no subscriptions, your plugins run on your key.
SELFHOSTED: "1"
# The plugin sends this as server.token; without it the backend answers no plugin. 24 characters or more.
PLUGIN_TOKEN: change-me-plugin-token
# Seals the keys you save in the admin panel. Keep it with your other secrets.
SECRETS_KEY: change-me
# The address you open in a browser; the panel's setup link starts here.
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]
allay-redis:
image: redis:8-alpine
restart: unless-stopped
command: ["redis-server", "--save", "60", "1", "--requirepass", "change-me-redis"]
volumes: [redis:/data]
volumes:
mongo:
redis:
Вопросы
На обоих и на их форках: плагин собран на Spigot API. Опыт из печей агентов достаётся игроку только на Paper, на Spigot он остаётся в печи.
Нет. Инструменты, которые выдают предметы или меняют мир, доступны только операторам, и плагин проверяет это трижды. Агенты перекладывают только вещи самого игрока и крафтят из настоящих ингредиентов. Единственное исключение — [Взять книгу]: написанная книга с длинным ответом самого Allay, один раз.
Только то, что показывает локатор спросившего: имя, расстояние и направление. Кто прячется от локатора — приседая, в тыкве или под невидимостью, — прячется и от Allay.
Сессию — 24 часа после последнего вопроса, до 30 фактов — пока игрок их не сотрёт или год не задаёт вопросов, обезличенную статистику из одних чисел — 400 дней, а полные трассы десятой части запросов — 7 дней. Подробности — в политике конфиденциальности (на английском). В игре /allay privacy показывает игроку то же самое и стирает всё по его просьбе.
По подписке — модель, которую выбирает allay.chat, и плагин её не меняет. Со своим ключом или своим бэкендом — любая модель, умеющая вызывать инструменты; можно даже дать каждой группе игроков свою модель.
Да. Квота плагина задаёт месячный бюджет и честно делит его между группами, которые вы выдаёте правами. Подробнее — в разделе Limits per player (на английском).
Пока нет. Единственный источник — релизы на GitHub, и itzg/minecraft-server умеет скачивать jar оттуда.
До версии 4.0.0 Allay назывался MCBuddy. При первом запуске плагин сам переносит старую папку, настройки и переводы. Подробнее — на странице Coming from MCBuddy (на английском).
Allay работает на Moonlands — хардкорном выживании с друзьями. Заходите и спросите его о чём-нибудь.
ru.minecraft.mairwunnx.com