You can download the latest version of the mod from CurseForge or Modrinth.

• Forge (required on Minecraft 1.18.1-1.20.1) / NeoForge (required on Minecraft 1.20.4+)
• GeckoLib (CurseForge / Modrinth) (required)
• Patchouli (CurseForge / Modrinth) (required)
• Curios (CurseForge / Modrinth) (optional)
• Jade (CurseForge / Modrinth) (optional)
• JEI (CurseForge / Modrinth) (optional)
• The One Probe (CurseForge / Modrinth) (optional)

You can develop addons for this mod using the Ars Magica API. To use the API you need to first add the maven repository to your build.gradle:

repositories {
    maven {
        name = "MinecraftschurliMods"
        url = "https://minecraftschurli.ddns.net/repository/maven-public/"
    }
}

Then you can add the API as a dependency (don't forget to also include the required dependencies at runtime):

dependencies {
    compileOnly fg.deobf('com.github.minecraftschurli:arsmagicalegacy:<arsmagicalegacy-version>:api')
    runtimeOnly fg.deobf('com.github.minecraftschurli:arsmagicalegacy:<arsmagicalegacy-version>')
    runtimeOnly fg.deobf('vazkii.patchouli:Patchouli:<patchouli-version>')
    runtimeOnly fg.deobf('software.bernie.geckolib:geckolib-forge-<mc-version>:<geckolib-version>')
}

1. Clone the repository.
2. Run ./gradlew genIntellijRuns / ./gradlew genEclipseRuns / ./gradlew genVSCodeRuns depending on your IDE to set up the workspace.
3. Open the project in your IDE.

To launch the client either:

1. Run the runClient run configuration generated in setup.
2. Run ./gradlew runClient in the project directory.

To launch the dedicated server either:

1. Run the runServer run configuration generated in setup.
2. Run ./gradlew runServer in the project directory.

To run the data generators either:

1. Run the runData run configuration generated in setup.
2. Run ./gradlew runData in the project directory.

1. Create a new class in src/test/java in the package com.github.minecraftschurli.arsmagicalegacy.test.
2. Add the @PrefixGameTestTemplate(false) and @GameTestHolder(ArsMagicaAPI.MOD_ID) annotations to the class.
3. Add the @GameTest annotation to the test method and specify the template name (e.g. @GameTest(template = "example")). Use the empty template for tests that don't require a specific template.
4. Write the test case. Use the GameTestHelper parameter of your test method to fail or succeed. Your testcase is required to call succeed at least once or it will fail with a timeout.

To run the tests either:

1. Run the runGameTestServer run configuration generated in setup.
2. Run ./gradlew runGameTestServer in the project directory.
3. Launch the client and use the /test command.

Run ./gradlew build to build the mod. The resulting jars will be located in build/libs.

Ars Magica is a trademark of Atlas Games®, used with permission.

Some textures used in this mod are property of D3miurge, used with permission.