Back to mods
Dial project artwork

Modrinth · Minecraft mod

Dial

A lightweight config library for Minecraft mods.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Dial release matches 26.1 Fabric?

Updated 22 days ago
Best match for your filters 0.2.0+26.1.2-fabric
Game version 26.1, 26.1.1, 26.1.2
Loader Fabric

Dial 0.2.0+26.1.2-fabric targets 26.1, 26.1.1, 26.1.2 with Fabric. It must be installed on the client. Do not install it on the dedicated server. All 1 required mods have matching files.

Where it goes

Is Dial required on the client, server, or both?

It must be installed on the client. Do not install it on the dedicated server.

Client Required
Dedicated server Not supported
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This file is marked client-only.

What else does Dial 0.2.0+26.1.2-fabric need?

0.2.0+26.1.2-fabric on 26.1 Fabric. Every mod below is checked against that same setup.

All 1 required mods have matching files

Install Fabric API first. We found matching files for this game-version and loader setup. 3 come through another mod in the chain.

3 listed on this file 3 pulled in by those mods
Mod Menu Optional for Dial 0.2.0+26.1.2-fabric
optional
Matching file found Matched file: 18.0.2
Fabric API Needed by Dial 0.2.0+26.1.2-fabric
required
Matching file found Matched file: 0.155.3+26.1.2
OneConfig Optional for Dial 0.2.0+26.1.2-fabric
optional
Matching file found Matched file: v1.8.0
Compose Multiplatform Needed by OneConfig
pulled in
Matching file found Matched file: v2.1.0+compose.1.13.0-alpha02

3 extra mods were pulled in by other dependencies. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Dial without breaking your instance.

Built for Dial 0.2.0+26.1.2-fabric on 26.1 Fabric. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 0.2.0+26.1.2-fabric. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Fabric API first. We found matching files for this game-version and loader setup. 3 come through another mod in the chain.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 0.2.0+26.1.2-fabric. It opens that exact file at the source.

About this project

What does Dial add?

Dial

A lightweight config library for Minecraft mods. Declare your options in a few lines and Dial saves them and builds the settings screen for you.

Why Dial?

  • You never write serialization code or build a screen by hand.
  • The same code runs on every supported version and loader, so you write your config once and keep it as you port.
  • It supports everything from Beta 1.7.3 up to the latest releases.
  • An optional Kotlin module adds a builder DSL and property delegates.
  • Dial configs can show up in OneConfig.

Supported versions

Minecraft Fabric Forge NeoForge Ornithe
26.4 ✓
26.3 ✓
26.1.2 ✓ ✓
1.21.1 ✓ ✓
1.20.1 ✓ ✓
1.18.2 ✓ ✓
1.16.5 ✓ ✓
1.12.2 ✓
1.8.9 ✓ ✓
1.7.10 ✓
Beta 1.7.3 ✓

For players

Install Dial next to any mod that needs it.

For developers

Java

public final class MyMod {
    public static final Config CONFIG = Dial.config("mymod", "My Mod");

    public static final BooleanOption ENABLED = CONFIG.toggle("enabled", true)
        .description("Turn the mod on or off.");
    public static final EnumOption<Corner> CORNER = CONFIG.cycle("corner", Corner.TOP_LEFT)
        .description("Which corner of the screen to draw in.");
    public static final SliderOption OPACITY = CONFIG.slider("opacity", 40, 0, 100, 5).suffix("%")
        .description("Background opacity.");
    public static final TextOption FORMAT = CONFIG.text("format", "{fps} FPS").maxLength(64)
        .description("The text to show.");
}

Read a value with ENABLED.get(), change it with set(...), and open the settings screen with Dial.open(CONFIG). Use onChange(...) to react when the player edits an option.

Bigger mods can group options into categories. Each category gets its own button on the settings screen and opens a page of its own, and categories can nest:

public static final Category ITEMS = CONFIG.category("items").description("How held items look.");
public static final BooleanOption BLOCK_HITTING = ITEMS.toggle("block_hitting", true);
public static final BooleanOption ALWAYS_SWING = ITEMS.category("swing").toggle("always_swing", false);

Categories only change the screen. Every option still lives in the same config file, so option ids must be unique across the whole config.

Kotlin

object MyMod {
    val config = dial("mymod", "My Mod")

    val enabled by config.toggle("enabled", true)
        .description("Turn the mod on or off.")
    val corner by config.cycle("corner", Corner.TOP_LEFT)
        .description("Which corner of the screen to draw in.")
    val opacity by config.slider("opacity", 40.0, 0.0..100.0, 5.0).suffix("%")
        .description("Background opacity.")
    val format by config.text("format", "{fps} FPS").maxLength(64)
        .description("The text to show.")
}

A fully working FPS HUD example, lives in example/.

License

Dial is licensed under Apache-2.0. You can use, modify, and distribute it in any project, commercial ones included, without paying royalties.

Project description from Modrinth.

Pick your setup

Dial by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

27 available setups

Showing the newest 12 of 16 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Dial versions and loaders

2 of 34 releases match
Clear filters

Looking for an older file? The official Modrinth project page is in Resources.