YAML Config

Bisect Hosting Promotion Banner

Ko-fi Promotion Banner

YAML Config: A Minecraft Configuration Mod

Overview

YAML Config is a powerful Minecraft configuration mod that enables mod developers to create and manage configuration settings using the YAML file format. It offers a user-friendly GUI, extensive support for data types, and robust networking for client-server synchronization.

Features

* Date and Time: YAML Config utilizes the YAML file format, known for its readability and ease of use. * Date and Time: A well-designed GUI allows players to easily navigate and edit their configuration settings. * Date and Time: The mod supports a wide range of data types, including: * Date and Time: `boolean`, `int`, `float`, `double`, `String`, `ResourceLocation`, `Registry` * Date and Time: `List`, `Map` * Date and Time: `LocalDateTime`

* Validation and Error Handling: Changes made to configurations on the server are automatically synchronized to clients, ensuring consistency across the gameplay experience. * Validation and Error Handling: The mod is designed to work seamlessly with existing modpacks, offering a flexible and expandable configuration system. * Validation and Error Handling: The mod includes robust validation and error handling, ensuring that configurations meet the expected requirements.

Installation and Usage

Installation

1. Launch Minecraft: Download the latest version of YAML Config from the mod's official website, CurseForge, or Modrinth. 2. Launch Minecraft: Move the downloaded JAR file into the "mods" folder within your Minecraft directory. 3. Launch Minecraft: Start Minecraft and join a world.

Usage

1. Open the Configs Screen: Press "F12" on your keyboard to open the Configs screen.

2. Navigate to the Config: The Configs Screen displays a list of available configurations. Select the mod whose configuration you want to modify.

3. Reset Button: The Config Screen displays the available settings. Each entry includes: * Reset Button: The name of the setting. * Reset Button: A field for editing the value. * Reset Button: A button for resetting the value back to its default.

4. Save Changes: Click the "Save Changes" button to save your modifications. The mod will automatically save the changes to the configuration file and synchronize them with other players on the server (if applicable).

Development

Creating Configurations

1. Define a Config Class:

* Create a new Java class within your mod's codebase that represents your mod's configuration.

```java public class MyModConfig {

public static IConfig config;

public static IConfigEntry<Boolean> debug;

public static void init() { ConfigBuilder builder = new ConfigBuilder(MyMod.MOD_ID, "mymod-config", ConfigExtension.YAML, ConfigType.CLIENT); } } ```

2. Define Config Entries:

* Use the `ConfigBuilder` class to define the settings for your configuration. * Choose the appropriate data type for each entry using the `define*` methods.

```java // Example of defining a boolean entry: debug = builder.defineBoolean("debug", false);

// Example of defining an integer entry with range: intEntry = builder.defineInteger("intEntry", 10, 0, 100); // Min 0, Max 100

// Example of defining a string entry with pattern: stringEntry = builder.defineString("stringEntry", "test", "test\d+");

// Example of defining a registry entry: registryEntry = builder.defineRegistry("registryEntry", Blocks.GRASS_BLOCK, BuiltInRegistries.BLOCK);

// Example of defining a list: stringListEntry = builder.defineStringList("stringListEntry", List.of("test1", "test2", "test3"), 3, 10); // Min 3, Max 10

// Example of defining a map: integerMapEntry = builder.defineIntegerMap("integerMapEntry", Map.of("test1", 1, "test2", 2, "test3", 3), 3, 10); // Min 3, Max 10 ```

3. Build the Configuration:

* Call the `build()` method on the `ConfigBuilder` to create your configuration. * Store the configuration in a static field for easy access within your mod's code.

```java public MyModConfig() { ConfigBuilder builder = new ConfigBuilder("mymod", "mymod-config", ConfigExtension.YAML, ConfigType.CLIENT); // ... define config entries config = builder.build(); } ```

4. Access Config Values in Your Code:

* Use the `get()` method to retrieve the current value of a config entry. * Use the `set()` method to modify the value of a config entry.

```java // Example: boolean debugEnabled = MyModConfig.debug.get(); // Retrieve the current value of the "debug" setting

if (debugEnabled) { // Perform debug-related actions }

MyModConfig.intEntry.set(25); // Set the value of the "intEntry" to 25 ```

Config Type

* `ConfigType.COMMON`: Client-side configurations are specific to the client who has installed the mod. They are not shared with other players on the server. * `ConfigType.COMMON`: Server-side configurations are specific to dedicated servers. They will not be used on single player worlds and are not synced to the players on the server. * `ConfigType.COMMON`: Common configurations are shared between both clients and the server. They can be edited on the server by editing the config file directly and restarting the server or by editing the values using the in-game GUI and saving the changes.

Using Custom Data Types

* Use the `IConfigEntryType` interface to register custom data types with the YAML Config mod. * Implement a custom serializer for handling the serialization and deserialization of your custom data type.

Modpack Configuration

* If you are creating a modpack, you can use YAML Config to define the configuration settings for your modpack. * Place the configuration file for your modpack in the "config" folder within your modpack's directory.

Examples

```java // Example: Basic client-side configuration

public class MyModConfig {

public static IConfig config;

public static IConfigEntry<Boolean> debug; public static IConfigEntry<Integer> testInt;

public static void init() { ConfigBuilder builder = new ConfigBuilder("mymod", "mymod-config", ConfigExtension.YAML, ConfigType.CLIENT);

debug = builder.defineBoolean("debug", false) // default false. .withComments("Whether debug mode is enabled for the mod.");

testInt = builder.defineInteger("testInt", 10, 0, 100); // default 10, min 0 and max 100.

config = builder.build(); } } ```