Cocoon

Cocoon - мост между плагинами и модами

Большинство серверов Minecraft крутятся на Bukkit/Spigot/Paper - это стабильно, гибко, но вот с модами беда. Если хочешь добавить на сервер кастомные блоки, нестандартную экипировку или мобов, обычно приходится переходить на Forge/Fabric, а там теряются все плагины и отсекаются ванильные игроки. Cocoon решает эту дилемму.

Это библиотека (не мод, а именно инструмент для разработчиков плагинов), которая даёт плагин-серверу возможность работать с мод-контентом. При этом сервер остаётся ванильным для клиентов - игроки без модов спокойно заходят и играют, просто не видят новой механики. А те, кто поставил клиентский мод Cocoon, получают полную картинку: кастомные блоки с правильными хитбоксами, интерфейсы контейнеров, модели мобов.

Что это даёт на практике? Админ может ставить на сервер плагины, которые используют Cocoon, и не думать о совместимости с мод-сервером. Разработчики пишут один код, а поддержка клиентских модов подключается автоматически.

---

Возможности

Cocoon позволяет реализовать на плагин-сервере:

• Кастомные предметы - любая экипировка, оружие, инструменты.
• Кастомные блоки с собственными хитбоксами - не просто заменяешь текстуру, а делаешь полноценную модель.
• Кастомные сущности - мобы, NPC, транспорт.
• Контейнеры нестандартного размера - хоть 3x3, хоть 6x9.
• Свои UI для контейнеров - кастомные интерфейсы, которые клиент увидит как надо.

Всё это работает без мод-сервера, только плагин + клиентский мод у игроков.

---

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

Важный нюанс: Cocoon разделяет клиентскую и серверную версии. Не перепутай - иначе ничего не заработает.

Для разработчиков

API документация пока в разработке, но базовый принцип такой:

1. Добавь Cocoon как зависимость в свой плагин.
2. Реализуй классы, которые предоставляет Cocoon (например, для кастомного блока или предмета).
3. Зарегистрируй эти классы через API Cocoon.
4. Готово - остальное библиотека делает сама.

Для владельцев серверов

1. Установи любой Bukkit-сервер (Spigot/Paper/Purpur).
2. Установи серверную библиотеку Cocoon.
3. Установи совместимые плагины, которые зависят от Cocoon.
4. Готово.

Для игроков (клиентская часть)

Если хочешь видеть кастомные блоки, мобов и UI на сервере:

1. Установи Fabric или Forge.
2. Установи клиентскую библиотеку Cocoon.
3. Установи моды, которые требуются для конкретного сервера (обычно они идут вместе с плагином).
4. Готово.

---

Кому это нужно

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

Cocoon - это не готовый набор фич, а инструмент. Но с ним плагин-сервера перестают быть ограничены только ванильной механикой Minecraft.