DimLib

Мод DimLib для Minecraft — библиотека для создания и управления измерениями

DimLib — это библиотека для загрузчика Fabric, предназначенная для реализации динамической работы с измерениями. Она позволяет администраторам серверов добавлять новые измерения, клонировать существующие типы миров и удалять измерения в процессе работы сервера. Мод также предоставляет API для интеграции в другие проекты и возможность отключить предупреждение о несовместимости с экспериментальными настройками.

Механика работы с измерениями

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

Для клонирования используется механизм копирования типа измерения и генератора чанков с существующего шаблона. Важно понимать, что при клонировании копируются только параметры генерации (world generation), а не содержимое мира (блоки, сущности, структуры). Это позволяет быстро создать копию, например, 'надмирного' или 'послеобеденного' измерения, сохранив при этом оригинальный ландшафт.

Консольные команды

Управление измерениями осуществляется через набор консольных команд, доступных администраторам. Каждая команда имеет строгую синтаксис и требует наличия соответствующего разрешения.

• **/dims add_dimension **: Добавляет новое измерение, используя указанную конфигурацию типа. Пример: /dims add_dimension "aaa:ccc" void создаёт измерение aaa:ccc типа void.
• **/dims clone_dimension **: Копирует тип и генератор чанков с шаблона. Пример: /dims clone_dimension minecraft:overworld "aaa:bbb" создаёт измерение aaa:bbb с генерацией, идентичной 'надмиру'.
• **/dims remove_dimension **: Удаляет измерение из списка доступных. Операция не удаляет файлы сохранения мира, они остаются на диске.
• **/dims view_dim_config **: Отображает текущую конфигурацию измерения, включая ID типа и настройки генератора чанков.

API и интеграция

Для разработчиков, желающих интегрировать функционал управления измерениями в свои моды, библиотека предоставляет класс DimensionAPI. Документация к API доступна в javadoc. Это позволяет создавать собственные типы измерений или модифицировать существующие программно, а не только через консольные команды.

Настройка предупреждений

Мод DimLib решает проблему с предупреждением "Worlds using Experimental Settings are not supported". Это сообщение появляется, когда сервер запускается в режиме, не поддерживающем экспериментальные настройки, но использует измерения, требующие их. Библиотека позволяет отключить это предупреждение двумя способами:

1. Через конфигурационный файл (config).
2. Через программный код с использованием API.

Это делает возможным запуск серверов с новыми измерениями в более стабильных режимах запуска.

Связанные материалы

• Cloth Config API — похожий мод
• YetAnotherConfigLib (YACL) — похожий мод
• Fabric Language Kotlin — похожий мод
• Architectury API — похожий мод
• Just Enough Items (JEI) — похожий мод

Автор: qouteall · Автор: Nick1st · Лицензия: Apache-2.0