About

JustRaces is a framework that allows to create custom data-driven races with active and passive abilities, special item properties and attributes. The main difference from other race mods and plugins is that JustRaces mainly have code-driven approach instead of data-driven.

Showcase

Creating a Project

Adding JustRaces as a Dependency

To use the JustRaces API in your project, you need to add the repository and the dependency to your build configuration file (build.gradle.kts).

Configure build.gradle.kts

Add the JitPack repository to your repositories block and specify Just-Races under your dependencies:

// ...

repositories {
    mavenCentral()
    maven("https://repo.papermc.io/repository/maven-public/")
    maven("https://jitpack.io")
}

dependencies {
    // Replace `RELEASE_TAG` with release tag, e.g., `v1.2.0`
    // Or with `main-SNAPSHOT` if you want use latest version
    compileOnly("com.github.JustJabka:Just-Races:RELEASE_TAG")
}

// ...

Configure paper-plugin.yml

Next, register JustRaces as a dependency in your plugin's manifest file (src/main/resources/paper-plugin.yml). This ensures Paper loads JustRaces before your addon and joins their classloaders.

name: ExampleAddon
version: '1.0.0'
api-version: '26.2'

# ...

dependencies:
  server:
    JustRaces:
      load: BEFORE
      required: true
      join-classpath: true