PlayerPreferences

Модуль для Flute CMS, позволяющий игровым серверам сохранять и загружать пользовательские настройки через REST API. Настройки хранятся в привязке к Steam-аккаунту и ID сервера, доступны из любого плагина через HTTP-запросы.

---

Установка

1. Скачать архив последнего релиза.
2. Открыть админ-панель Flute → Модули.
3. Перетащить архив в область загрузки или выбрать через кнопку.
4. Нажать Установить и дождаться завершения.
5. После установки таблица player_preferences создаётся автоматически.

Требует: Steam-авторизация должна быть настроена в Flute (пользователи привязаны через соцсеть steam).

---

Админ-панель

Раздел PlayerPreferences появляется в боковом меню после установки.

• Список — все сохранённые предпочтения, сгруппированные по игроку и серверу. Фильтрация по имени игрока и ID сервера.
• Страница игрока — все настройки конкретного игрока по всем серверам в виде таблицы «ключ / значение / сервер / дата».

---

API

Все запросы требуют токен авторизации Flute в заголовке:

Authorization: Bearer <token>

Токену необходимо назначить одно из следующих разрешений:

Разрешение	Доступ
api.player-preferences	Мастер-доступ: чтение и запись
api.player-preferences.read	Только чтение (GET)
api.player-preferences.write	Только запись (POST)

Параметры принимаются в JSON-теле или в query-строке. Steam-аккаунт передаётся в одном из форматов: steamid64 (17 цифр) или steamid в формате STEAM_X:Y:Z.

---

GET /api/player-preferences/settings

Получить настройки игрока на сервере.

Параметры:

Параметр	Тип	Описание
steamid64	string	SteamID64 игрока
steamid	string	Steam ID в формате STEAM_X:Y:Z (альтернатива steamid64)
server_id	int	ID сервера в Flute

Ответ:

{
    "steamid64": "76561198000000000",
    "server_id": 1,
    "settings": {
        "crosshair": 5,
        "volume": 0.8
    }
}

---

POST /api/player-preferences/settings

Обновить настройки игрока (shallow merge — существующие ключи обновляются, остальные сохраняются).

Тело запроса:

{
    "steamid64": "76561198000000000",
    "server_id": 1,
    "settings": {
        "crosshair": 7
    }
}

Ответ — те же поля, что и в GET, с актуальными значениями после обновления.

---

Коды ошибок:

Код	Причина
400	Не передан steamid/steamid64, server_id или settings
403	Токен не имеет нужного разрешения
404	Steam-аккаунт не привязан ни к одному пользователю Flute

---

Плагины-интеграции

Игра	Плагин
CS 1.6 (AmxModX)	Скоро

Написали плагин под другую игру или движок? Откройте issue — добавим в список.