DisguiseLib

DisguiseLib - это серверная библиотека для Майнкрафт, которая позволяет маскировать сущности под другие. По факту это не самостоятельный геймплейный мод, а мощное API для разработчиков, которое решает проблемы с синхронизацией пакетов и метаданных между сервером и клиентом.

Зачем нужен DisguiseLib

В ванильном Minecraft сервер отправляет клиенту данные о том, как выглядит сущность. Если вы хотите написать плагин или мод, который превращает зомби в крипера, или маскирует игрока под корову, вам нужно правильно подменять эти пакеты. DisguiseLib берет всю эту рутину на себя. Библиотека работает полностью на стороне сервера, то есть игрокам не нужно скачивать никаких дополнительных файлов - они будут видеть маскировку как стандартную ванильную механику.

Важный нюанс про команду /disguise

Раньше в DisguiseLib была встроенная команда /disguise, но сейчас разработчик вынес её и некоторые другие фичи в отдельный мод. Так что если вы искали инструмент для прямого использования в игре, вам нужен тот самый отдельный проект. Сам же DisguiseLib теперь служит исключительно как API-библиотека для других модов.

Совместимость и версии

Библиотека поддерживает сразу три загрузчика:

• Fabric
• Forge
• Quilt

Она доступна для Minecraft 1.16.5, 1.17.x, 1.18.x, а также 1.19 и 1.19.2-1.19.3. Проект распространяется по лицензии MIT, что делает его очень удобным для включения в свои сборки модов или серверные плагины. Последняя актуальная версия - 1.3.3 для Minecraft 1.19.3.

Совет для разработчиков

Если вы пишете свой серверный мод под старые версии, обратите внимание на сборку 1.0.2 для Minecraft 1.16.5. В ней разработчик исправил серьезную проблему с datatracker-пакетами, из-за которой у некоторых сущностей могли слетать метаданные при маскировке.

Скачайте DisguiseLib, если вам нужно надежное API для подмены сущностей на сервере. Это must-have инструмент для создателей кастомных мини-игр и RPG-режимов, где важна визуальная маскировка мобов или игроков без нагружения клиента.