Лаунчсервер Laminara

Laminara — лаунчсервер, который умеет брать данные из сайта через модуль UnicoreProviderLaminara. Игрок входит в лаунчер логином и паролем от сайта, а сборки, скины и лента новостей подтягиваются оттуда же.

В отличие от GravitLauncher, сессии Laminara держит у себя: сама выпускает токены, крутит ротацию, обслуживает yggdrasil и узнаёт машину игрока. От сайта ей нужен только ответ «эта пара логин-пароль верна, и вот кто это» плюс справка об игроке. Поэтому контракт здесь короче — четыре ручки под /auth/laminara вместо одиннадцати у Gravit.

Что берётся с сайта

Все четыре включаются по имени unicore и работают независимо: можно взять с сайта только вход, а новости оставить свои.

Подключение

curl -L -o unicore https://github.com/MCXTeam/UnicoreProviderLaminara/releases/latest/download/unicore-linux-amd64
install -m 755 unicore /var/lib/laminara/modules/unicore

{
  "modules": {
    "dir": "/var/lib/laminara/modules",
    "config": {
      "unicore": {
        "url": "https://api.example.com",
        "apiKey": "ваш-ключ",
        "timeout": "5s",
        "cacheTTL": "1m"
      }
    }
  },

  "auth": { "provider": "unicore" },
  "yggdrasil": { "enabled": true, "skinProvider": "unicore" },
  "news": { "source": { "type": "unicore", "config": { "limit": 10 } } },
  "access": {
    "sources": { "site": { "type": "unicore" } },
    "rules": [{ "builds": ["*"], "source": "site", "message": "Сборка открыта по привилегии на сайте" }]
  }
}

laminara-server exec "unicore"

curl https://api.example.com/auth/laminara/ping \
  -H 'Authorization: Api-Key ваш-ключ'

Настройки модуля

Профили кэшируются, потому что за ними модуль ходит часто: скины отдаются в том числе игровому серверу через yggdrasil, и на каждую проверку доступа к сборке тоже нужен профиль.

Доступ к сборкам

Отдельной ручки для сборок нет: список сборок живёт в лаунчсервере, а сайт только отвечает, что есть у игрока. Решение принимает модуль по профилю.

По правам

Основное → Настройки → «Сборки лаунчера Laminara» — перечислите идентификаторы сборок через запятую:

survival, skyblock, anarchy

На каждую сборку появится право laminara.build.<id> — его видно в конструкторе прав в группе «Лаунчер». Выдали право игроку, роли или донат-группе — сборка открылась в лаунчере.

Шаблон права меняется в конфиге источника доступа, а пустая строка выключает проверку по правам совсем:

{
  "type": "unicore",
  "config": {
    "permission": "laminara.build.%build%",
    "groups": { "creative": ["vip", "premium"] },
    "failOpen": false
  }
}

По ролям и группам

Если заводить права не хочется, соответствие сборок и групп пишется прямо в конфиге — блок groups выше. Модуль сверит его с ролями и донат-группами из профиля. Со стороны сайта для этого ничего настраивать не нужно.

Игрок проходит, если у него есть право по шаблону либо одна из перечисленных групп. Забаненный на сайте не проходит никогда, даже при failOpen.

Ручки

Все под ключом с правом kernel.laminara.provider.

Профиль у authenticate и user одинаковый:

{
  "uuid": "d1b0f4a2-0000-4000-8000-000000000001",
  "username": "Steve",
  "roles": ["player", "moderator"],
  "groups": ["vip"],
  "permissions": ["laminara.build.survival"],
  "banned": false,
  "banReason": "",
  "textures": {
    "skin": { "url": "https://api.example.com/skin/Steve.png", "slim": false },
    "cape": { "url": "https://api.example.com/cape/Steve.png" }
  }
}

username — канонический ник, даже если вошли по почте: именно он попадёт в игру. В permissions приходят права игрока вместе с правами его ролей и активных донат-привилегий. У user поле banned заполняется по-настоящему — забаненный отдаётся профилем, а не ошибкой, потому что модуль отличает бан от «игрока нет».

Тексты новостей приходят без HTML: заголовок и тело прогоняются в простой текст, потому что лаунчер разметку не рендерит. limit по умолчанию — 20.

Ошибки входа

Тело ответа — { "error": "<код>" }, у блокировки добавляется reason.

Получив auth.require2fa, лаунчер показывает поле для кода и повторяет запрос. Неверный логин, пароль и код игрок видит одинаково — «неверный логин или пароль», чтобы перебором нельзя было узнать список ников.

Ограничения частоты

Ручки Laminara не троттлятся: лаунчсервер считает попытки входа сам, до обращения к сайту. Но неудачные входы сайт всё равно копит — после десяти промахов по одной учётке за 15 минут включается растущая пауза, до пяти минут. С подключённой каптчей порог поднимается до 25. Это та же защита, что и у входа на сайте, и она работает по учётной записи, а не по адресу лаунчсервера.

Команды в консоли

Модуль добавляет в консоль лаунчсервера команду unicore (алиас cms):

$ laminara-server exec "unicore user Steve"
Ник         Steve
UUID        d1b0f4a2-0000-4000-8000-000000000001
Роли        Player, Moderator
Группы      VIP
Права       laminara.build.survival
Бан         нет
Скин        https://api.example.com/skin/Steve.png
Плащ        —

$ laminara-server exec "unicore forget"
кэш профилей очищен

unicore forget сбрасывает кэш профилей — пригодится, когда право выдано только что, а лаунчер ещё показывает старое состояние.