Chunksmith

Chunksmith

Предварительно сгенерируй свой мир — и увидь его.

Chunksmith заранее генерирует чанки, чтобы игроки никогда не ждали генерацию мира. Его отличие в том, что тот же самый проход также строит данные дальнего горизонта для Distant Horizons или voxy. Один запуск, два результата: мир, который загружается мгновенно, и мир, который видно до самого края.

Изначально основан на Chunky от pop4959; с тех пор развивается самостоятельно. Всё, что делал Chunky, Chunksmith по-прежнему умеет.

Полная документация — в вики — каждая настройка, каждая команда и руководства по предварительной генерации, обрезке и настройке LOD для мультиплеера.

Сообщить об ошибке или задать вопрос

Что добавляет Chunksmith

Он строит данные LOD во время предварительной генерации

Никакого второго прохода. Никакого повторного чтения файлов регионов. Никакой отдельной предварительной генерации LOD после. Установи Distant Horizons или voxy, запусти предген — и дальний ландшафт просто есть.

Он включается сам. Если рендерер установлен, генерация LOD включена. Не нужно искать ключ в конфиге.

Уже сгенерировано заранее? Запусти тот же предген снова. Chunksmith строит LOD из чанков, которые уже есть — он не перегенерирует их и пропускает всё уже сделанное. Сгенерируй сегодня, установи рендерер в следующем месяце — ничего не потеряешь.

LOD для мультиплеера, без companion-мода. Игроки, заходящие на твой сервер, скачивают предварительно сгенерированные данные LOD и видят весь мир вдали, даже ни разу там не пройдя. Один и тот же jar — это обе половины: сервер и клиент. Плагин Paper/Spigot тоже его раздаёт, так что модифицированный клиент против сервера с плагином работает.

LOD без диска (4.4.0). `/cs horizon ` генерирует как обычно внутри радиуса и, за его пределами, строит LOD и выбрасывает чанк вместо его сохранения. Мир, который иначе занял бы сотни гигабайт, хранит только ту область, где люди реально играют, а дальний ландшафт всё равно виден — в одиночной игре и для каждого подключающегося игрока. Чанки, к которым игрок подходит близко, всегда сохраняются. Недоступно с Moonrise; на Paper полностью сгенерированные чанки отбрасываются, но некоторые частично сгенерированные на краях всё ещё записываются.

Он продолжает генерировать, пока люди играют

Большинство предгенераторов заставляют выбирать между скоростью и играбельным сервером. Chunksmith измеряет, что он добавляет ко времени тика, а не ориентируется на абсолютное время тика — так что сервер, который и без того работает на пределе по своим причинам, не задушит Chunksmith до нуля за нагрузку, которую тот не создавал.

Каждый игрок онлайн ещё больше уменьшает лимит, так что пустой сервер работает на полную, а загруженный активно уступает. Если сервер всё равно не выдерживает, запуск ставится на паузу с указанием причины и возобновляется, когда всё придёт в норму. Твоя /cs pause всегда имеет приоритет.

Он измеримо быстрее

dispatchMaxConcurrent управляет тем, сколько запросов чанков остаётся в полёте, и масштабируется под твой CPU вместо фиксированного лимита. На 8-ядерном выделенном сервере повышение с прежних фиксированных 50 до 200 дало +39% — с 31,6 до 43,9 чанков/сек. Настраивается на лету.

Структуры других модов действительно строятся

Предгенератор, который выбрасывает каждый чанк в момент его генерации, ломает каждый мод, который реагирует на «появился новый чанк» и затем строит на более позднем тике — земли уже нет к тому моменту, когда он смотрит. Замерено с Millenaire на предгене 1.21.1: 309 попыток размещения, 309 отложенных, ноль деревень.

Chunksmith удерживает каждый чанк, пока не появятся все восемь соседей, и затем освобождает его. Здесь нет ничего завязанного на конкретные моды — правило касается чанков, так что всё, что строится на новой земле, выигрывает.

Сообщает, когда генерация мира сбоит

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

Всё работает на лету

Каждую настройку можно прочитать и изменить на лету — без перезапуска, без правки файлов, без простоя сервера. Настройки сервера — через /cs set; те, что относятся к твоему клиенту — через /csclient set. Это правило, которого проект придерживается, с тестом, который падает, если настройку добавили без команды для неё.

Всё, что умел Chunky

Гибкие формы (квадрат, круг, ромб, треугольник, звезда и другие), с центром на координатах, спавне мира или границе мира. Мультимир. Прогресс, скорость, ETA и опциональный боссбар в реальном времени. Пауза, продолжение, отмена и продолжение после перезапуска. Обрезка мира. API для разработчиков для событий прогресса и завершения.

Установка

Обязателен на сервере — или в одиночной игре, где твоя игра и есть сервер. Установка на клиент необязательна.

Он нужен на клиенте только для мультиплеерного LOD: чтобы видеть предгенерированный дальний ландшафт на сервере, по которому ты не ходил. Для самой предгенерации на клиенте ничего не нужно.

Поставляется как мод для Fabric, Forge и NeoForge и как плагин для Paper / Spigot. (Folia не поддерживается. Начиная с 4.0.0 плагин вообще не загрузится на Folia — он больше не объявляет folia-supported, так что Folia отказывается его запускать, а не гоняет платформу, которую никто не тестирует. Непроверяемое утверждение хуже отсутствующего.)

Сервер и клиент должны работать на одной мажорной версии. В 4.0.0 изменился сетевой протокол LOD, и смешанная пара 3.x/4.x отключает LOD в обе стороны: клиент не запрашивает, а сервер не отдаёт. Всё остальное продолжает работать — перестаёт приходить именно дальний ландшафт, и обе стороны говорят об этом прямо, а не падают странным образом.

Стоит знать перед обновлением: лаунчер предложит 4.0.0 всем, у кого 3.x, так что клиент может обновиться до этого несоответствия, пока сервер не тронут. Обновляйте оба вместе.

Ставьте рендерер на клиент и только на клиент. Distant Horizons и Voxy рисуют дальний ландшафт, а рисует что-либо только клиент — сервер лишь отправляет данные. Рендерер, установленный на сервере, настоятельно не рекомендуется, и начиная с 3.18.1 сервер сообщает об этом красным при запуске. Он конкурирует за тот же CPU, на котором Chunksmith занимается предгенерацией, и дублирует LOD, который вашим игрокам и так отправляют; серверный Distant Horizons ещё и забивает консоль предупреждениями [SharedApi] No DH level provided .... Ничего не выигрывается. Если LOD плохо работает на вашем сервере, это первое, что нужно проверить.

Поддержка рендереров, по загрузчикам и версиям Minecraft, на странице Поддерживаемые рендереры — включая форки voxy, и то, рядом с какими модами Chunksmith отказывается загружаться.

Быстрый старт

/cs world <world>     # pick the world
/cs spawn             # centre on spawn
/cs radius 5000       # how far out
/cs start             # go

/cs progress — чтобы следить, /cs pause и /cs continue — по необходимости. Остальное в вики.

Исходники

CSv3-Current — ветки 3.x и 4.x, где идёт текущая разработка. Ветка 2.x заморожена на CSv2_archive.

Лицензия

GPL-3.0-only. Оригинальный Chunky (c) pop4959. Модификации Chunksmith (c) Kishku7.