Dex Cosmetics (Декс косметикс)

Мод для серверов Майнкрафт на Fabric, который добавляет косметику: головные уборы, предметы за спиной, облики предметов и визуальные эффекты. Он устанавливается только на сервер: игроки могут заходить с ванильного клиента, а нужный ресурс-пак автоматически выдаёт Polymer.

Возможности

• Шляпы отображаются на голове, не занимая настоящий шлем игрока.
• Предметы за спиной включают плащи, крылья и рюкзаки; они скрываются при плавании, полёте на элитрах, сне и атаке булавой.
• Облики можно наложить на предмет в руке через меню косметики. Для облика задаются подходящие предметы или теги предметов.
• Эффекты бывают трёх типов: частицы, цветная светящаяся обводка и частицы в формате Майнкрафт Бедрок через Cobblemon.
• Игрок видит весь каталог в меню, но может надеть только полученную косметику. Владение и выбранные предметы сохраняются отдельно для каждого игрока.
• Косметику удобно выдавать из кейсов, магазинов и таблиц добычи консольной командой.

Как пользоваться

/cosmetics открывает меню косметики. Чтобы наложить облик, возьмите подходящий предмет в руку и нажмите значок облика в меню.

• /cosmetics remove — снять облик с предмета в руке.
• /cosmetics give <player> <cosmetic_id> — выдать косметику.
• /cosmetics take <player> <cosmetic_id> — отозвать косметику.
• /cosmetics list <player> — показать косметику игрока.
• /cosmetics reload — перечитать конфиги и пересобрать ресурс-пак.
• /cosmetics generatepack — вручную собрать ресурс-пак.

Настройки

Главный файл — config/dex_cosmetics/config.json.

• require_resource_pack определяет, обязателен ли ресурс-пак; сообщение при отказе задаётся в resource_pack_kick_message.
• allow_item_skin_sharing разрешает сохранять облик на выброшенном или переданном предмете.
• rename_item_to_skin_name меняет отображаемое имя предмета на имя облика.
• menu_categories включает категории меню, а menu_focus задаёт открытую по умолчанию.

Своя косметика создаётся отдельными JSON-файлами в config/dex_cosmetics/cosmetics/<type>/<id>.json: hats, back, items и effects. Модели размещаются в config/dex_cosmetics/model/<type>/<id>.json, текстуры — в config/dex_cosmetics/textures/<type>/<id>/. Анимированные текстуры с файлом .mcmeta поддерживаются.

Требования и совместимость

Нужны Fabric API, Fabric Language Kotlin, Polymer и Text Placeholder API. Для прав администраторов можно использовать LuckPerms: право dexcosmetics.admin требуется для команд выдачи, отзыва, просмотра, перезагрузки и сборки пака; без LuckPerms нужен уровень оператора 4. Cobblemon требуется только для эффектов с частицами в формате Майнкрафт Бедрок.

Ресурс-пак выдаётся при входе автоматически. После изменения косметики игрокам нужно переподключиться, чтобы скачать обновлённый пак.