SuperMartijn642's Config Lib

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

Создаём конфиг:

Конфигурация создается с помощью ModConfigBuilder. Просто создайте новый экземпляр, используя #ModConfigBuilder().

   ModConfigBuilder builder = new ModConfigBuilder();

Значение можно добавить в конфигурацию с помощью ModConfigBuilder#define, которое принимает имя и значение по умолчанию. Для целых и двойных значений также требуются минимальное и максимальное значения. ModConfigBuilder#define возвращает Supplier, который следует сохранить для получения значения из конфигурации.

   Supplier<Boolean> booleanValue = builder.define( "booleanValue", true );

   Supplier<Integer> integerValue = builder.define( "integerValue", 5, 0, 10 );

   Supplier<Double> doubleValue = builder.define( "doubleValue", 0.5, 0, 1);

   Supplier<ExampleEnum> enumValue = builder.define( "enumValue", ExampleEnum.VALUE_1 );

Комментарий можно добавить к значению, вызвав ModConfigBuilder#comment(String) перед определением значения.

   Supplier<Boolean> valueWithComment = builder.comment( "this is a comment for 'valueWithComment'" ).define( "valueWithComment ", true );

По умолчанию значения перезагружаются при загрузке мира. Это можно изменить, чтобы значение перезагружалось только при запуске Minecraft, вызвав ModConfigBuilder#gameRestart() перед определением значения.

   Supplier<Boolean> notReloadedValue = builder.comment( "this is value will not be reloaded" ).define( "notReloadedValue", true );

Значения в конфигурациях COMMON или SERVER синхронизируются с клиентами по умолчанию, чтобы предотвратить использование ModConfigBuilder#dontSync().

   Supplier<Boolean> notSynchronizedValue = builder.comment( "this is value will not be synchronized" ).define( "notSynchronizedValue", true );

Значения также можно разделить на категории. ModConfigBuilder#push(String) перемещает категорию, а ModConfigBuilder#pop() выдвигает категорию.

   builder.push( "special" );
   
   Supplier<Boolean> specialValue = builder.comment( "this value is in the 'special' category" ).define( "specialValue", true );
   
   builder.pop();

Комментарий можно добавить в активную категорию, используя ModConfigBuilder#categoryComment(String).

   builder.push( "client" ).categoryComment( "this, is a comment for the 'client' category" );

После определения всех значений необходимо вызвать ModConfigBuilder#build() для завершения настройки.

   builder.build();

Теперь значения в вашей конфигурации будут автоматически перезагружены и синхронизированы, и значения можно будет получить, используя сохраненные экземпляры Supplier. Это будет работать для всех доступных версий, включая Minecraft 1.12, 1.14, 1.15, 1.16, 1.17, 1.18 и 1.19.

Пример мода:

Конкретный пример использования проверки Config Lib пример mod.

Часто задаваемые вопросы

Могу ли я использовать ваш мод в своем модпаке?
Да, не стесняйтесь использовать мой мод в своем модпаке.

Дискорд

Чтобы узнать о будущем контенте, предстоящих модах и обсуждениях, присоединяйтесь к дискорд-серверу SuperMartijn642!