Редактор playerdata — файли гравців Minecraft .dat

Підтримуються Minecraft Bedrock Edition і Java Edition — а також усі їхні серверні ядра, популярні й маловідомі: Vanilla, Paper, Spigot, Purpur, Folia, Fabric, Forge, NeoForge, Mohist, Sponge, Bedrock Dedicated Server, PocketMine-MP, Nukkit, PowerNukkitX, Cloudburst, Dragonfly, Endstone, LeviLamina та інші. Повний список.

Java Edition записує для кожного гравця окремий файл NBT gzip big-endian у world/playerdata/<uuid>.dat. Він містить інвентар, скриню Енду, позицію, вимір, здоров’я, голод, XP та атрибути. Перетягніть файл нижче, щоб звільнити гравця, який застряг у блоках, видалити предмет, що спричиняє збій, або скинути параметри. Сервер має бути зупинений або принаймні гравець має бути офлайн.

Java playerdataСкриня ЕндуІнвентарПозиціяАтрибутиПов’язані досягнення

Перетягніть файл playerdata .dat сюди

level.dat · .nbt · .mcstructure · .schem · .schematic · .dat · дампи чанків

Теги у файлі гравця

ТегТипПризначення
PosСписок DoubleX, Y, Z. Використовується, щоб звільнити гравця, який застряг у стіні або під бедроком.
RotationСписок FloatПоворот по горизонталі й вертикалі.
DimensionString / IntВимір, у якому з’являється гравець після входу.
InventoryСписок CompoundОдин запис на кожен стак: id, Count, Slot, components або tag.
EnderItemsСписок CompoundВміст скрині Енду в такій самій структурі.
Health, foodLevel, XpLevel, XpTotalFloat / IntСтан гравця та досвід.
playerGameTypeIntРежим гри окремого гравця.
abilitiesCompoundПоліт, невразливість, швидкість ходьби та польоту.
AttributesСписок CompoundМаксимальне здоров’я, швидкість руху та інші модифікатори.
SpawnX/SpawnY/SpawnZ або respawnInt / CompoundОсобиста точка відродження залежно від версії.
UUIDInt[4]UUID гравця як чотири значення Int у сучасних версіях.

Структура стаків предметів змінилася у 1.20.5: користувацькі дані перенесено з одного compound tag до окремих components. Тут відкриваються обидва варіанти; редагуйте той, який записує ваша версія.

Типові виправлення

  • Гравець застряг у блоках або нескінченно падає. Установіть у Pos безпечні координати — три Double у порядку X, Y, Z — і очистьте Motion, якщо він містить надто велике значення.
  • Клієнт завершує роботу під час входу. Зазвичай причина в неправильно сформованому предметі. Видаліть проблемний запис з Inventory, а не весь список.
  • Неправильний вимір після помилки порталу. Поверніть Dimension значення minecraft:overworld і задайте відповідні координати в Pos.
  • Гравець залишився в режимі спостерігача. Установіть playerGameType у 0 для виживання або 1 для творчого режиму.
  • Модифікатори атрибутів від видаленого плагіна. Видаліть застарілі записи в Attributes.

Редагуйте, коли гравець офлайн

Сервер тримає стан гравця в пам’яті та записує його під час виходу й автозбереження. Якщо редагувати файл, поки гравець онлайн, зміни гарантовано буде перезаписано; редагування під час збереження може обрізати файл. Від’єднайте гравця або зупиніть сервер, скопіюйте й відредагуйте файл, а потім поверніть його до повторного підключення. Зберігайте оригінал, доки вхід не буде перевірено.

Сервери Bedrock не використовують таку структуру: дані гравців містяться в LevelDB світу під ключами на зразок player_<uuid>, значення яких є NBT little-endian. Витягнуте значення відкривається тут як Bedrock без заголовка.

Часті запитання

Який файл належить моєму гравцеві?

Файли мають назви за UUID. Знайдіть UUID гравця через переглядач API Mojang або відсортуйте playerdata/ за часом зміни й зіставте його з останнім входом.

Чи можна видати собі предмети через playerdata?

На власному сервері — так. Додайте запис до списку Inventory із id, Count і Slot. На чужому сервері це буде несанкціонованим втручанням і все одно не спрацює, бо активний сервер перезапише файл.

Чому мої зміни зникли?

Під час редагування сервер працював або гравець був онлайн. Під час наступного збереження стан із пам’яті перезаписав файл.

Чи однаковий формат playerdata у Bedrock?

Ні. Bedrock зберігає гравців у LevelDB світу, а не в окремих UUID-файлах. NBT усередині цих значень має формат little-endian і відкривається тут після вилучення.

Пов’язані інструменти