Bobby Share

Bobby Share — это высокопроизводительный мод для Fabric, который совместно передаёт данные чанков с сервера Minecraft напрямую клиентам, чтобы динамически заполнять кэш отрисовки мода Bobby.

🚀 Как это работает

Bobby — это клиентский мод, который позволяет иметь дальность прорисовки больше серверного лимита за счёт локального кэширования чанков на вашем компьютере. Обычно вам приходится самому посещать чанки, чтобы они закэшировались.

Bobby Share решает эту проблему:

1. Когда вы заходите на сервер или перемещаетесь в новые области, ваш клиент проверяет, не хватает ли данных чанков в его локальном кэше Bobby.
2. Если чанк отсутствует, клиент отправляет на сервер лёгкий сетевой запрос.
3. Сервер асинхронно загружает данные чанка (или сериализует активные чанки напрямую из оперативной памяти сервера), оптимизирует их и отправляет обратно вам.
4. Ваш клиент сохраняет чанк локально и отображает его, позволяя мгновенно видеть далеко за пределами серверной дальности прорисовки.

🔄 Инвалидация кэша чанков в реальном времени и бесшовная горячая замена (v1.3.0+ и v1.4.0)

Больше не нужно беспокоиться об устаревшей дальней дальности прорисовки или визуальных дырах!

• Мгновенная синхронизация: Всякий раз, когда игрок ломает блок, ставит блок или взрывает рельеф на сервере, Bobby Share инвалидирует изменённый чанк в реальном времени.
• Нулевые накладные расходы: Отправляет подключённым клиентам крошечный пакет-уведомление размером 8 байт.
• Бесшовное обновление горячей заменой (новое в v1.4.0): Изменённые чанки обновляются и внедряются напрямую в активную визуальную память Bobby на клиенте без выгрузки, полностью устраняя мерцание отрисовки, подтормаживания и зияющие чёрные пустоты.
• Отбрасывание устаревших пакетов: Автоматически отбрасывает пришедшие не в порядке ответы, если чанк был изменён, пока сетевые пакеты были в пути.

⚡ Оптимизации производительности, безопасности и параллелизма

Разработан для плавного масштабирования от 3 до 100+ одновременных игроков без просадок TPS и забивания сетевых каналов:

• Потокобезопасная потоковая передача живых чанков (новое в v1.4.0): Активно загруженные чанки рядом с игроками безопасно сериализуются в серверном потоке перед отправкой пакетов, полностью устраняя гонки многопоточности PalettedContainer и падения серверного watchdog при интенсивном исследовании.
• Протестировано под высокой нагрузкой: Тщательно проверено на обслуживании десятков тысяч запросов чанков в реальном времени при интенсивном перемещении игроков — без падений и утечек.
• Серверный LRU-кэш: Кэширует до 4096 оптимизированных compound-данных чанков в памяти (~100MB RAM), чтобы мгновенно отдавать популярные регионы без повторных чтений с диска.
• Ограниченная очередь клиента: Ограничивает исходящие запросы клиента до 3 чанков за тик (60 чанков/сек), полностью устраняя скачки пинга в пещерах или плотном рельефе.
• Ограничение скорости по token bucket: Ограничивает запросы на игрока (всплеск: 200 чанков, пополнение: 80 чанков/сек), чтобы защитить сервер от спама.
• Очистка NBT (оптимизация трафика): Убирает тяжёлые, не относящиеся к отрисовке данные из чанков (структуры, тики сущностей, carving masks, блочные сущности) перед отправкой, уменьшая размер полезной нагрузки на 50%–80%.
• Безопасность главного потока: Получает данные чанков асинхронно с помощью потокобезопасных API загрузки Minecraft. На клиенте запись файлов выполняется в фоновых потоках, чтобы игра работала полностью без лагов.
• Безопасное развязывание: Корректно обрабатывает окружения, где Bobby отсутствует или является клиентским, без сбоев инъекций mixin и падений сервера.

⚙️ Конфигурация и команды (на стороне сервера)

Вы можете настроить параметры производительности Bobby Share через автоматически создаваемый файл конфигурации config/bobbyshare.json на вашем сервере:

• rateLimitBurst — максимальное количество чанков, которое игрок может запросить за короткий всплеск (по умолчанию: 200).
• rateLimitRefill — количество запросов чанков, восстанавливаемых игроку в секунду (по умолчанию: 80).
• cacheCapacity — максимальное количество очищенных чанков, хранимых в оперативной памяти сервера (по умолчанию: 4096).
• maxRequestDistance — предохранительное ограничение того, насколько далеко от игрока могут быть запрошенные чанки (по умолчанию: 34.0).
• blacklistedDimensions — список идентификаторов измерений, для которых отключается потоковая передача чанков (по умолчанию: ["minecraft:the_end"]).

Админ-команды (требуется OP level 2):

• /bobbyshare stats — отображает живую панель производительности сервера: заполненность RAM-кэша, % попаданий, живые захваты RAM, чтения с диска, запросы с ограничением скорости и отправленные инвалидации.
• /bobbyshare reload — перезагружает файл конфигурации с диска и мгновенно применяет изменения.
• /bobbyshare clearcache — очищает серверный RAM-кэш чанков.

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

Чтобы потоковая передача чанков работала успешно, Bobby Share должен быть установлен и на сервере, и на клиенте:

• На клиенте: поместите `bobbyshare-1.4.0+mc.jar**И** оригинальныйbobby-*.jarв вашу директорию.minecraft/mods/`.
• На сервере: поместите ТОЛЬКО `bobbyshare-1.4.0+mc.jarв директориюmods/` вашего сервера. (ВНИМАНИЕ: НЕ ставьте оригинальный мод Bobby на сервер, так как он клиентский и обрушит сервер при запуске).

Поддерживаемые версии Minecraft: 1.20.1 — 26.2 в 13 отдельных сборках версий, доступных в GitHub Releases, Modrinth и CurseForge.