Installation

Installation

AzureCortex is distributed from my public Maven, the same repository used for AzureLib:

https://maven.azuredoom.com/mods

Browse available artifacts and exact version numbers at https://maven.azuredoom.com/#/mods/com/azure/azurecortex

Gradle (Groovy DSL)

Add the repository once, alongside Fabric/NeoForge's own repos:

repositories {
    // AzureCortex (and AzureDoom's other mods) live here
    maven { url 'https://maven.azuredoom.com/mods' }
}

Common (multiloader) module

If your mod uses a common/fabric/neoforge multiloader split (the same shape AzureCortex itself uses), depend on the common artifact as compileOnly in your common module, and on the loader-specific artifact as a runtime dependency in each platform module:

// common/build.gradle
dependencies {
    compileOnly "com.azure.azurecortex:azurecortex-common-MCVERSION:MODVERSION"
}

// fabric/build.gradle
dependencies {
    modImplementation "com.azure.azurecortex:azurecortex-fabric-MCVERSION:MODVERSION"
}

// neoforge/build.gradle
dependencies {
    implementation "com.azure.azurecortex:azurecortex-neoforge-MCVERSION:MODVERSION"
}

Single-loader mod

If your mod isn't multiloader, just depend on the one artifact for your loader:

// Fabric only
dependencies {
    modImplementation "com.azure.azurecortex:azurecortex-fabric-MCVERSION:MODVERSION"
}

// NeoForge only
dependencies {
    implementation "com.azure.azurecortex:azurecortex-neoforge-MCVERSION:MODVERSION"
}

Replace MODVERSION with the current release (e.g. 0.1.0, check the Maven browser for the latest).

Declaring the dependency to the loader

AzureCortex is a library mod: it needs to actually be present and initialized at runtime, not just on your classpath. Declare it as a normal mod dependency so users are prompted to install it and so your mod fails fast (rather than NoClassDefFoundError-ing deep into world load) if it's missing.

Fabric (fabric.mod.json):

{
  "depends": {
    "azurecortex": ">=0.1.0"
  }
}

NeoForge (neoforge.mods.toml):

[[dependencies.yourmodid]]
    modId = "azurecortex"
    type = "required"
    versionRange = "[0.1.0,)"
    ordering = "AFTER"
    side = "BOTH"

Verifying the install

AzureCortex.init(...) runs once per platform module during mod initialization (this is handled for you, you never call it yourself) and logs a line like:

AzureCortex framework initialized (debug diagnostics: false, pathfinding debug: false)

If you don't see this line, AzureCortex either isn't on the classpath at runtime or its platform entrypoint isn't being loaded — double check the dependency declaration above and that you're using the artifact for the loader you're actually running.

Next steps

Continue to Core Concepts to understand the runtime model, or jump straight to the Full Example Walkthrough to see a complete, working AI built on top of the framework.