SuperMartijn642's Config Lib [1.21.1] [1.19.4] [1.18.2] [1.17.1] [1.16.5] / Minecraft / Geroncraft

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

Создание конфига:

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

ModConfigBuilder builder = new ModConfigBuilder();

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

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.