Всё лежит в папке данных pnLibrary (plugins/pnLibrary). Собственное состояние и настройки библиотеки хранятся в одной папке data/, а рядом лежат только localization/ и link.key. Все пути задаёт один класс LibraryPaths; при старте состояние старых версий переносится в data/ само (LegacyLayoutMigration), существующее не перезаписывается. Файлы нужны только для удобства: если файла нет или он повреждён, библиотека стартует как обычно и начинает записывать заново.
| Файл или папка | Что хранит | Формат | Как пишется |
|---|---|---|---|
data/settings.json |
настройки библиотеки: только то, что изменил администратор (/pn settings, меню) |
JSON | атомарно при каждом изменении, при старте читается; повреждённый файл сохраняется как settings.json.broken |
Помощь.txt, Настройки.txt, Команды.txt (в корне plugins/pnLibrary) |
справка для администратора со ссылками на поддержку, обзор всех настроек с текущими значениями и список всех команд /pn с правами |
текст UTF-8 | заново при каждом запуске, Настройки.txt ещё и после каждого изменения настройки; текст берётся из кода, ручные правки не сохраняются, не читаются обратно. Если JVM сервера не умеет создавать файлы с русскими именами, пишутся HELP.txt, SETTINGS.txt и COMMANDS.txt |
link.key, groups.tsv |
связь с прокси и группы серверов | base64, таблица | прокси; см. ниже |
data/history/task-history.tsv |
завершённые задачи плагинов | таблица (TsvRecords), версия 3 |
не чаще раза в 30 секунд и при остановке |
data/history/event-history.tsv |
вызовы событий по дням и часам | своя таблица, первая строка # pnLibrary event history v1 |
не чаще раза в минуту и при остановке |
data/history/event-history.csv, event-history.json |
выгрузка истории событий | CSV, JSON | только по кнопке выгрузки в меню или команде, не читается обратно |
data/journal/*.pnj |
журнал сервера по уровням и дням | бинарный | по событию, старые удаляются |
data/observability/ (observations.jsonl, attachments/) |
наблюдения за работой плагинов | JSON по строке | по событию |
data/diagnostics/history/*.pndlog |
журнал сессии для отчёта поддержки | бинарный | в течение сессии |
data/updates/ |
каталог релизов, события обновлений, резервные копии, настройки каналов и паузы (preferences.json) |
JSON и сами файлы | модуль обновлений |
data/reports/ |
созданные отчёты поддержки | zip | по команде /pn debug |
data/upload-ledger.json |
квитанции удаления загруженных отчётов | JSON | при загрузке и удалении |
data/downloads/ |
состояние скачивания файлов и зависимостей | свои файлы | при скачивании |
Таблицы с записями (история задач и группы серверов) пишет один класс TsvRecords из modules/common:
- первая строка называет формат и версию, например
#pnlibrary-task-history 3; - одна запись на строку, поля через табуляцию, табуляция, перенос строки и обратная косая внутри поля экранируются;
- файл заменяется целиком и атомарно, поэтому при сбое остаётся прежний;
- нечитаемая строка пропускается, отсутствующий файл читается как пустой.
Новая версия формата должна читать старые строки: так сделана история задач (версии 1, 2 и 3).
- перевести
event-history.tsvнаTsvRecords; - общий лимит размера и очистка старого для журнала, наблюдений и истории сессий;
- одна страница в меню «Данные библиотеки»: что и сколько занимает, кнопка очистки каждой части.
Лежат в папке pnLibrary на прокси; link.key копируют на игровые серверы. Что это и как настроить: network.md.
link.key— общий секрет связи (каналpnlibrary:link), одна строка base64, не меньше 32 байт. Игровой сервер файл только читает.groups.tsv— группы серверов, формат#pnlibrary-groups 2, поля через табуляцию: группа, вид записи (group,server,plugin,extra,skip), затем сервер или плагин (уextraиskip— сервер и плагин). Файл можно править вручную, но проще командами и меню.