Aegis

Aegis is a DSL/Wrapper around brigadier for kotlin with fabric, designed to reduce clutter as well as providing utility types

---

Standard kotlin brigadier (with static imports):

dispatcher.register(
    literal("example")
        .then(
            argument(
                "value", IntegerArgumentType.integer(-10, 200)
            ).executes {
                println(IntegerArgumentType.getInteger(it, "value"))
                1
            }
        )
)

Aegis:

dispatcher.register("example") {
   integer("value", -10, 200) {
        executes { 
            println(it.getInt("value"))
        }
    }
}

---

Installation (build.gradle)

Latest version:

repositories {
    mavenCentral()
    maven { url = "https://api.modrinth.com/maven" }
}

dependencies {
    // Aegis + Colonel
    modImplementation "ca.stellardrift:colonel:0.2.1"
    include "ca.stellardrift:colonel:0.2.1"
    modImplementation "maven.modrinth:aegis:<VERSION>"
    include "maven.modrinth:aegis:<VERSION>"
}

Note: If you care about file size you can include the runtime instead, a stripped down jar with only the bare minimum required to run against with

include ("maven.modrinth:aegis:<VERSION>") {
        artifact {
            name = 'aegis-runtime'
            extension = 'jar'
            type = 'jar'
            url = "https://api.modrinth.com/maven/maven/modrinth/aegis/<VERSION>/aegis-runtime-<VERSION>.jar"
        }
    }

---

Implementation notes

Aegis does not cover every use case (at least, not currently!), however most cases not covered explicitly are covered by the raw and custom blocks

If you find a use case not covered explicitly that can not be achieved with these blocks, please open an issue!