FurnitureLib

FurnitureLib - это не просто плагин, а полноценная библиотека для серверов Майнкрафт, которая решает одну из главных проблем кастомной мебели - лаги. Проект существует с 2015 года и за это время стал фундаментом для множества furniture-плагинов вроде DiceFurniture или FurnitureMaker.

Что делает эта библиотека

FurnitureLib позволяет создавать сложные 3D-модели мебели через ArmorStand, но делает это умно - через пакеты ProtocolLib. Вместо того чтобы спавнить реальные сущности на сервере (что грузит TPS), библиотека отправляет игрокам только визуальные данные. Серверу не нужно обрабатывать физику, коллизии и AI для каждого стула или стола.

По факту это значит, что вы можете разместить сотни предметов мебели без просадок производительности. Для владельцев серверов это критично - никто не хочет, чтобы декор в хабе убивал сервер.

Зачем нужна FurnitureLib обычному админу

Сама по себе библиотека не добавляет мебель в игру. Это зависимость - базовый инструментарий, который используют другие плагины. Если вы ставите DiceFurniture, FurnitureMaker или любой другой furniture-плагин на Spigot/Paper, скорее всего вам потребуется FurnitureLib.

Библиотека берёт на себя всю грязную работу:

• Создание и синхронизацию ArmorStand-моделей
• Оптимизацию пакетов для снижения нагрузки
• Проверку прав доступа через ProtectionLib
• Интеграцию с экономикой через Vault
• Поддержку кастомного освещения через LightAPI

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

FurnitureLib поддерживает Minecraft 1.9.x - 1.19.x, а по актуальным данным обновляется и под ветку 1.20+. Работает на Spigot, Paper и совместимых форках. Для работы обязательно нужен ProtocolLib - без него библиотека просто не запустится.

Важный нюанс с Geyser: если у вас стоит Geyser для кроссплатформенной игры с Bedrock, то по умолчанию мебель будет отключена для бедрок-игроков. Причина в ограничениях Bedrock Edition - там позиционирование ArmorStand работает иначе, и модели выглядят криво. Это не баг, а вынужденная мера.

Поддержка Minecraft 1.8 прекращена с релиза 1.9. Автор полностью переписал библиотеку, а Mojang изменили позиционирование предметов на сущностях, из-за чего старые модели выглядят странно на новых версиях.

ProtectionLib - защита мебели

В комплекте с FurnitureLib идёт ProtectionLib - дополнительный модуль для интеграции с плагинами защиты территорий. Он подключается к API WorldGuard, PlotSquared и других protection-плагинов.

Что это даёт на практике: когда игрок пытается поставить мебель на чужом участке или в регионе, ProtectionLib проверяет права. Если игрок владелец региона или добавлен в trusted - мебель ставится. Если нет - получает отказ. Это защищает от гриферства через мебель, которую сложно отследить обычными средствами.

Зависимости

Для работы FurnitureLib нужны:

• ProtocolLib (обязательно) - для работы с пакетами
• Vault (опционально) - для экономики и покупки мебели
• LightAPI (опционально) - для кастомного освещения от мебели
• ProtectionLib (опционально, уже внутри архива) - для интеграции с защитой

Плагины, использующие FurnitureLib

Библиотека лежит в основе нескольких популярных проектов:

• FurnitureMaker - создание собственной мебели
• DiceFurniture - большая коллекция готовой мебели
• DiceGraveStoneOfDeath - надгробия на месте смерти
• FurnitureLib in GUI - управление через интерфейс
• Selection Visualizer (Premium) - визуализация выделения территорий
• Graves - система могил

Производительность и оптимизация

Главная фишка FurnitureLib - работа через пакеты вместо реальных сущностей. Когда вы ставите диван из мебельного плагина, сервер не спавнит настоящий ArmorStand с включенной физикой. Вместо этого он отправляет клиенту пакет "вот тут стоит ArmorStand с такой-то головой и в такой-то позе".

Для игрока разницы нет - он видит мебель. Но для сервера это огромная экономия ресурсов. Реальный ArmorStand требует тиков на обработку, проверку коллизий, синхронизацию с другими плагинами. Пакетная версия - просто визуал.

На больших серверах с сотнями игроков и тысячами предметов мебели разница колоссальная. TPS не проседает, тиковая нагрузка минимальна.

Установка и настройка

Установка стандартная для Spigot-плагинов:

1. Скачайте FurnitureLib и ProtocolLib
2. Закиньте оба .jar в папку plugins
3. Перезапустите сервер
4. Установите furniture-плагин, который использует библиотеку

Если планируете использовать защиту регионов, ProtectionLib уже включён в архив FurnitureLib - отдельно качать не нужно. Просто убедитесь, что у вас стоит WorldGuard или PlotSquared.

Для экономики (покупка мебели за игровую валюту) поставьте Vault и любой economy-плагин вроде EssentialsX.

Хостинг и запуск сервера с мебелью

Если хотите поиграть с друзьями на сервере с кастомной мебелью, проще всего арендовать хостинг Майнкрафт с предустановленным Paper или Spigot. На BungeeHost можно запустить сервер в пару кликов, а FurnitureLib и нужные furniture-плагины установятся автоматически или через панель управления.

Хостинг серверов Майнкрафт на BungeeHost поддерживает все необходимые зависимости - ProtocolLib, Vault, WorldGuard. Вам не придётся вручную настраивать каждый плагин, достаточно выбрать нужные из списка и запустить сервер.

Известные проблемы и нюансы

Некоторые модели мебели могут выглядеть странно на новых версиях Minecraft из-за изменений в позиционировании предметов на ArmorStand. Автор постоянно фиксит такие баги, но на старых версиях (1.9-1.12) визуальные глитчи встречаются чаще.

Если у вас Bedrock-игроки через Geyser, помните - они не увидят мебель по умолчанию. Можно попробовать включить отображение в конфиге Geyser, но модели будут кривыми из-за ограничений Bedrock.

При обновлении сервера на новую версию Minecraft сначала проверьте совместимость FurnitureLib. Библиотека обычно обновляется быстро, но на мажорных релизах (типа 1.20 -> 1.21) могут быть задержки.

Стоит ли использовать

Если вы собираете сервер с кастомной мебелью - FurnitureLib must-have. Альтернатив практически нет, большинство furniture-плагинов завязаны именно на эту библиотеку. Она стабильна, оптимизирована и проверена годами.

Для ванильного сервера без декора библиотека не нужна. Но если хотите красивый спавн, уютные домики игроков или тематические постройки с интерактивной мебелью - скачайте FurnitureLib и подходящий furniture-плагин.

Скачать FurnitureLib можно для серверов на Spigot, Paper и форках. Убедитесь, что у вас стоит ProtocolLib нужной версии, иначе библиотека не запустится.