Обзор
Все файлы конфигурации Identica, как они записываются и перезагружаются и как записываются значения.
В этом разделе описана каждая настройка, файл за файлом. Расположение каждой страницы повторяет расположение её файла в папке данных: plugins/identica/ на Velocity и plugins/Identica/ на BungeeCord. Чтобы узнать, что менять для конкретной задачи, начните с руководств.
Файлы
| Файл | Страница |
|---|---|
settings.yml | Настройки |
engine.yml | Движок |
routing.yml | Маршрутизация |
commands.yml | Команды |
messages.yml | Сообщения |
persistence.yml | Хранилище |
replication.yml | Репликация |
providers/providers.yml | Провайдеры |
identity/addresses.yml | Адреса аккаунтов |
identity/username/ | Ник |
features/recognition/ | Распознавание |
features/restriction/ | Ограничения |
features/restriction/join/ | Ограничение входа |
features/sentinel/ | Sentinel |
features/verification/ | Подтверждение |
providers/Credential/ | Настройки Credential |
providers/Premium/ | Настройки Premium |
Провайдер или аддон из другого источника сам документирует свои файлы.
YAML или JSON
В примерах используется YAML — формат Identica по умолчанию. Формат выбирает пустой файл в папке данных: type=YAML или type=JSON. Identica создаёт type=YAML при первом запуске; переименуйте его до того, как измените какую-либо настройку, потому что Identica не преобразует уже существующие файлы.
Пометки настроек
Некоторые настройки отмечены пометкой:
- Для опытных: значение по умолчанию подходит почти любой сети. Меняйте его, только если можете назвать причину.
- Осторожно: изменение влияет на безопасность или на то, что видят игроки; сначала прочитайте описание настройки.
- Опасно: изменение может затронуть существующие аккаунты, и его трудно отменить.
- Экспериментально: работает, но может измениться в одном из следующих релизов.
- Зарезервировано: читается, но пока ни на что не влияет. Оставьте как есть.
Настройки без пометок — это обычная конфигурация.
Что Identica записывает обратно
При каждом запуске и перезагрузке Identica дополняет каждый файл недостающими настройками и записывает его обратно. Ваши значения сохраняются, а комментарии — нет.
Список берётся в том виде, в каком вы его записали, в том числе пустой: [] означает «ничего», а не «использовать значение по умолчанию». Чтобы вернуть список по умолчанию, удалите ключ.
settings.yml и файл settings каждой функции начинаются с _version, по которому Identica их обновляет. Не редактируйте и не удаляйте его.
Перезагрузка
/identica admin reload заново читает все файлы запущенного прокси: файлы самой Identica, её функций и каждого загруженного провайдера. Сообщения и настройки, которые читаются в момент использования, например запросы, которые видят игроки, или лимиты попыток провайдера, применяются к следующим игрокам без перезапуска. Подключение к базе данных открывается при запуске, поэтому изменения в persistence.yml вступают в силу при следующем запуске.
Файл, который не удалось прочитать, сохраняет прежние значения, а остальные файлы всё равно перезагружаются. В этом случае команда отвечает сообщением commands.reload.error из messages.yml, где {error} перечисляет все файлы с ошибками; сообщение commands.reload.success выводится, только если перезагрузились все файлы. Identica не перезаписывает файл, который не смогла прочитать, так что вы можете исправить его и выполнить перезагрузку ещё раз.
Форматы значений
- Длительности:
"30s","10m","2h","1d12h"или ISO-8601, например"PT10M". Число без единицы, например10, означает минуты. Нагляднее всего строки в кавычках с единицей. - Варианты выбора: строки в верхнем регистре, например
"RANDOM"или"REPLACE_EXISTING". - Переключатели:
trueилиfalse. - Сообщения: текст в формате MiniMessage; см. Сообщения.
