Identica

Обзор

Все файлы конфигурации 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; см. Сообщения.

На этой странице