Crimson.Lab

Лаборатория Кримсона

Как перенести профили Paper в offline-режим, если в мире уже играли

Minecraft хранит инвентарь по UUID игрока. В нашей схеме с прямым подключением к Paper после перехода в offline-режим игровой UUID вычисляется из строки OfflinePlayer:<ник> с учётом регистра.

До переноса оставьте online-mode=true и настройте AuthMe и PacketEvents для входа через TLauncher в Crafty.

Для переноса я собрал скрипт, который создаёт рядом с исходным сервером готовую копию. На резервной копии нашего Paper 26.2 он перенёс три профиля, включая 14 файлов игроков и 24 ссылки на игроков в семи регионах мира. Скачать мигратор для Linux (paper-offline-migrate.py)

Данные Что переносится
Профиль Paper Инвентарь, броня, опыт, эндер-сундук и координаты. Скрипт переименовывает .dat и .dat_old и обновляет UUID внутри NBT. Находит и старый playerdata/, и новый players/data/.
Статистика и достижения Файлы из stats/ и advancements/ в обеих структурах мира.
Доступ на сервер Записи в ops.json, whitelist.json, banned-players.json и usercache.json. У оператора сохраняется уровень доступа, у бана — причина и срок.
Мир и питомцы Ссылки на известных игроков в сущностях, чанках и отдельных файлах NBT обнаруженных миров и измерений, включая владельцев приручённых животных.
EssentialsX и LuckPerms Личные файлы EssentialsX с домами и балансом, ссылки на игроков и оба бинарных кэша. В локальных H2 и SQLite LuckPerms переносятся идентификаторы игроков, основные группы и индивидуальные права.

У AuthMe поле premiumUUID обозначает лицензионную учётную запись. Скрипт копирует каталог AuthMe целиком, вместе с паролями и первоначальными привязками. История действий LuckPerms также сохраняется в исходном виде. Приваты, банки и инвентари сторонних плагинов могут иметь собственные файлы или SQL-базы. Скрипт выводит дополнительные каталоги плагинов для проверки. При внешнем или разделённом хранилище самого LuckPerms он останавливается. Форматы хранения LuckPerms · Структура миров начиная с Java Edition 26.1

1. Проверить, кого и что предстоит перенести

С готовым конфигом AuthMe запустите Paper на прежнем online-mode=true. Попросите владельцев операторских и других привилегированных ников зайти под лицензией, войти по паролю AuthMe и выполнить /premium. При первом входе им понадобится регистрация. Затем нажмите Stop в Crafty и сделайте резервную копию. До конца переноса приостановите запуск по расписанию. Привязка лицензии в AuthMe 6.0.1

Скачайте скрипт в отдельный каталог. Команды выполняйте в терминале Linux от имени пользователя, который запускает Paper. Нужны Python 3.9+, GNU cp и место под копию сервера. Для EssentialsX и LuckPerms нужен PyYAML (пакет Debian/Ubuntu python3-yaml), для H2 — команда java и JDBC-драйвер из plugins/LuckPerms/libs/. Если мир использует LZ4, установите также python3-lz4 и python3-xxhash.

В каталоге со скачанным файлом задайте SERVER — полный путь к каталогу с server.properties из настроек вашего сервера в Crafty. Для COPY нужен свободный путь на той же файловой системе. Если Crafty работает в контейнере, эти команды удобно выполнять на хосте, в родительском каталоге серверов.

SERVER=/srv/crafty/servers/ВАШ_ID
COPY="${SERVER}.offline"
python3 paper-offline-migrate.py --server "$SERVER" --check

Сверьте пары «ник, старый UUID, новый UUID». Скрипт берёт имена из кэша Paper, списков доступа и профилей EssentialsX. Запасной источник — поле bukkit.lastKnownName внутри файла игрока. Если для профиля или прав всё ещё не хватает ника, скрипт укажет UUID и остановится. Создайте players.csv по образцу ниже, заменив пример своими данными. Если от прежнего игрока в мире остался только приручённый волк, ник владельца и его старый UUID тоже можно внести в эту таблицу. Регистр ника влияет на новый UUID.

name,online_uuid
PlayerName,12345678-1234-4abc-8def-123456789abc

Повторите проверку с --map players.csv. Если у одного ника уже есть online- и offline-файлы, сравните их с бэкапом. Флаг --prefer-online PlayerName выбирает версию из online-профиля для конфликтующих файлов этого ника. При конфликте в LuckPerms он также заменяет права назначения правами online-профиля. Для нескольких игроков повторите флаг. Если нужны вещи из обоих инвентарей, сначала объедините их на рабочей копии вручную.

По умолчанию скрипт находит миры верхнего уровня. Для своего каталога миров добавьте, например, --world worlds/survival для каждого дополнительного мира. Каталоги по символьным ссылкам заранее соберите в самостоятельную копию. Все выбранные параметры повторите при создании результата.

2. Создать копию и переключить Crafty

python3 paper-offline-migrate.py --server "$SERVER" --output "$COPY"

Дождитесь строки «Готовая копия». Перед её появлением скрипт повторно проверяет файлы и права по исходной таблице UUID. Пример команды при истёкшем кэше и конфликте у одного игрока — python3 paper-offline-migrate.py --server "$SERVER" --map players.csv --prefer-online PlayerName --output "$COPY".

Теперь выставьте online-mode=false и enforce-secure-profile=false в файле $COPY/server.properties. Проверьте настройки AuthMe в этой же копии. Следующая команда одним вызовом Linux меняет два каталога местами. Crafty запустит перенесённый мир по привычному пути $SERVER, прежний мир окажется в $COPY. Если при миграции указывали --world, добавьте те же пути при обмене.

python3 paper-offline-migrate.py --server "$SERVER" --swap-with "$COPY"

Запустите сервер в Crafty. Попросите прежнего игрока проверить инвентарь, опыт, эндер-сундук, достижения и команды питомцу. Проверьте дом EssentialsX и группу LuckPerms. Войти под привязанным операторским ником должно получиться только с его лицензией, а новому локальному нику AuthMe должен предложить регистрацию.

Для отката остановите Paper, повторите ту же команду с --swap-with и запустите сервер из Crafty. По пути $SERVER снова будет прежний мир с исходными настройками входа. Прогресс игроков после переключения останется отдельно в $COPY.

tags: minecraft - paper - crafty - tlauncher - authme - uuid - essentialsx - luckperms