Конфиг server.json

Серверные настройки WebGUI хранятся в config/webgui/server.json.

Файл создаётся автоматически при первом запуске. Также создаётся шаблон config/webgui/server.example.json. Если tokenSecretBase64 пустой, новый секрет генерируется и сохраняется автоматически.

Полный пример

{
  "enableTokens": true,
  "tokenTtlSeconds": 900,
  "queryParamName": "webgui_token",
  "tokenSecretBase64": "<авто-генерируется или ваш секрет>",

  "autoHudOnJoin": false,
  "autoHudUrl": "",

  "mainMenuUrl": "",
  "updateCheckUrl": ""
}

Поля

Подписанные токены

Подписанные токены позволяют вашему бэкенду убедиться, что запрос пришёл от настоящего клиента WebGUI.

Поле	Тип	По умолчанию	Описание
enableTokens	bool	true	Добавлять подписанный токен к каждому URL, который открывает мод.
tokenTtlSeconds	int	900	Время жизни токена в секундах. Минимум, применяемый модом: 60.
queryParamName	string	"webgui_token"	Имя query-параметра для передачи токена.
tokenSecretBase64	string	авто	Base64 HMAC-секрет, общий с вашим бэкендом. Генерируется автоматически, если пустой.

Авто-HUD

Поле	Тип	По умолчанию	Описание
autoHudOnJoin	bool	false	Автоматически открывать HUD-оверлей при входе игрока на сервер.
autoHudUrl	string	""	URL для авто-HUD. Обязателен, если autoHudOnJoin равен true.

Главное меню

Поле	Тип	По умолчанию	Описание
mainMenuUrl	string	""	URL, отправляемый клиентам при входе для экрана главного меню (открывается нажатием F6). Пустая строка — клавиша ничего не делает.

Проверка обновлений

Поле	Тип	По умолчанию	Описание
updateCheckUrl	string	""	URL, возвращающий информацию о версии. Поддерживаемые форматы: {"version":"1.2.3"} или {"tag_name":"v1.2.3","html_url":"..."}. Пустая строка — отключено.

Примечания

• Если вы используете подписанные токены, ваш бэкенд должен проверять их с тем же секретом, указанным в tokenSecretBase64.
• Путь к конфигу — config/webgui/server.json — обратите внимание: webgui, а не webui.