---

Requirements

Minecraft	Java Version	Notes
26.2	Java 25	Latest
26.1	Java 25
1.21.11	Java 21
1.21.10	Java 21
1.21.8	Java 21	Minimum supported version

Spigot or any of its forks will work.

How patch versions are supported (26.1.1, 26.1.2, 26.2.1, etc.)

Minecraft patch releases (Eg: 26.1.1, 26.1.2, 26.2.1) usually do not change anything the plugin needs, so they do NOT require their own build of SimplePets.

When the plugin starts up it will:

1. Look for support that matches your exact server version
2. If there is none, it will link to the newest support that shares the same major/minor version and is not newer than your server
   • 26.1, 26.1.1, and 26.1.2 will all use the 26.1 support
   • 26.2 and 26.2.1 will both use the 26.2 support
3. You will see a message in the console letting you know your version was linked

If a patch release DOES break something, dedicated support for that exact patch version is added and the plugin will automatically pick it over the linked one.

* Version linking only applies to MC 26 and newer, 1.21.x versions require exact support *

Older Minecraft versions (Legacy Jars)

Support for older versions has been dropped over time, if you are on one of these versions you will need to grab the last build that supported it:

• MC 1.21.6 - Last supported build was R5-B295
• MC 1.21.7 - Last supported build was R5-B303

---

API

Maven Dependency:

<repository>
    <id>bs-repo-releases</id>
    <url>https://repo.bsdevelopment.org/releases/</url>
</repository>

<dependency>
    <groupId>org.bsdevelopment.simplepets</groupId>
    <artifactId>api</artifactId>
    <version>R5-B314</version>  <!-- This version is automatically updated -->
</dependency>

Gradle Dependency (Groovy DSL):

repositories {
    maven {
        url 'https://repo.bsdevelopment.org/releases'
    }
}

dependencies {
    implementation 'org.bsdevelopment.simplepets:api:R5-B314' // This version is automatically updated
}

Gradle Dependency (Kotlin DSL):

repositories {
    maven("https://repo.bsdevelopment.org/releases")
}

dependencies {
    implementation("org.bsdevelopment.simplepets:api:R5-B314") // This version is automatically updated
}

---

How to compile yourself

Notice as of Febuary 18th 2026

With the release of R5-B292 we have moved to a gradle project and there are no more jars for each version.
Instead, there is now only a single SimplePets.jar file located in the build/libs folder.
If you wish to compile your own version of the plugin you can do so by running the following command: gradle clean build

Outdated Maven instructions

When compiling a custom version you need to supply a 'revision' variable
which will be your custom version. If no revision is supplied the version
will default to be 5.0-BUILD-0
Example: -Drevision=5.0-BUILD-100

There are a few different ways you can compile the plugin (as of May 1st 2024): - If you want to compile all current supported version you can run this command: mvn clean install -Drevision={version} - If you want to compile a specific supported version run a command similar to this: mvn clean install -Drevision={version} -Dtarget-mc=1.20.6 - If you want to compile the latest supported version run this command: mvn clean install -Drevision={version} -Platest