CIT-paper - кастомные текстуры для серверов Майнкрафт

Кастомные текстуры предметов (CIT) - это когда вы переименовываете алмазный меч в "Меч Тысячи Истин" и он меняет скин. Раньше для этого на серверах пихали OptiFine или ставили мод CIT Resewn. Но OptiFine на серверах - это боль, а CIT Resewn требует модовый загрузчик. Плагин CIT-paper решает эту проблему, беря всю работу на себя.

Плагин доступен на Modrinth.

Зачем нужен этот плагин?

По факту, CIT-paper автоматизирует конвертацию ресурсов. Сервер сам берет ваш старый ресурспак, переделывает его под новые стандарты Майнкрафт и раздает игрокам. Игрокам на клиенте вообще ничего не нужно ставить, достаточно просто согласиться на загрузку серверного пакета. Это идеальный вариант для рпг-серверов, где много кастомного оружия и брони с уникальными моделями.

Как установить и настроить

1. Кидаем плагин в папку plugins.
2. Запускаем сервер, чтобы сгенерировались конфиги.
3. Кладем ваш старый ресурспак с CIT-свойствами в папку input.
4. В конфиге указываем папку output, куда пойдут готовые пакеты.
5. Перезапускаем сервер. Плагин сконвертирует пакеты и создаст нужные конфиги.
6. Включаем готовый ресурспак на сервере (через встроенную раздачу или загрузку на любой хостинг пакетов). Теперь переименование предметов будет менять их текстуру, прямо как в CIT Resewn.

Если планируете играть онлайн с друзьями, проще всего поднять сервер на BungeeHost (https://bungee.host). Плагин ставится туда в один клик, а раздача ресурсов настраивается за пару минут.

Как это работает под капотом

Плагин вешает на предмет компонент item_model, когда тот получает нужное состояние. Это может быть переименование, зачарование или даже потеря прочности. Структура ресурспака меняется так, чтобы всё работало на ванильных клиентах без всяких модов.

Важный нюанс: Плагин отлично понимает старые форматы OptiFine, но некоторые фичи еще допиливаются. Если какая-то сложная модель не отображается, возможно, она пока не поддерживается конвертером.

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

Основные тесты шли на Paper и Bukkit. По идее, всё должно работать и на Spigot, и на Folia, хотя с последней всегда бывают сюрпризы из-за многопоточности.

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

Если вы используете GitHub Actions или другие CI/CD системы, есть отдельная CLI-версия для автоматической конвертации ресурсов. Но учтите: сам плагин CIT-paper все равно должен стоять на сервере, чтобы раздавать и применять эти текстуры.

Скачайте CIT-paper, если устали тащить OptiFine на сервер ради пары кастомных мечей. Это действительно удобная замена, которая экономит нервы и админам, и игрокам.