TaterLib

A cross API code library that allows developers to write code that works across multiple modding platforms, and across a wide range of Minecraft versions, all with one JAR file. If TaterLib runs on it, so can your plugin/mod.

Please note, some abstractions may not be fully implemented yet, and some may be missing. If you're looking for a specific abstraction/game event, please open an issue, and we'll get to it as soon as possible, or feel free to open a PR with an implementation. Contributions are always welcome!

Let's cut to the chase, why should you use and/or contribute to TaterLib? Well, let's say you have a mod/plugin that you want to port to a different modding API. You could go through the laborious task of implementing all the events, commands, etc. on each platform and create all your own cool fancy abstractions for each game object, or you could use TaterLib and save yourself a lot of time. (which is why I started this project in the first place)

There's two ways to use TaterLib, you can depend on the general API, then implement any missing features yourself on each platform, or if something's missing, you can start a PR with either a basic or full implementation, and we can improve TaterLib and save you a lot of time in the future. (a bit of a win-win)

Link to our support: Discord

Download

Adding to your project

repositories {
    maven {
        name = 'NeuralNexus'
        url = 'https://maven.neuralnexus.dev/releases'
    }
}

dependencies {
    compileOnly('dev.neuralnexus:taterlib-api:<version>')
}

There's also a snapshot repository available at https://maven.neuralnexus.dev/repository/snapshots

Compatibility Cheatsheet

TaterLib supports: Bukkit, BungeeCord, Fabric, Forge, Sponge, and Velocity

General notes:

No Fabric on 1.13
No Fabric/Forge below 1.7.10

Server type	Versions	Jar Name
1.20.x	1.20-1.20.4	`TaterLib-1.20.x-<version>.jar`
1.19.4	1.19.4	`TaterLib-1.19.4-<version>.jar`
1.19.2	1.19.2	`TaterLib-1.19.2-<version>.jar`
1.19	1.19	`TaterLib-1.19-<version>.jar`
1.18.2	1.18.2	`TaterLib-1.18.2-<version>.jar`
1.18	1.18	`TaterLib-1.18-<version>.jar`
1.17	1.17-1.17.1	`TaterLib-1.17-<version>.jar`
1.16	1.16-1.16.5	`TaterLib-1.16-<version>.jar`
1.15	1.15-1.15.2	`TaterLib-1.15-<version>.jar`
1.14	1.14-1.14.3	`TaterLib-1.14-<version>.jar`
1.13	1.13-1.13.2	`TaterLib-1.13-<version>.jar`
1.12	1.12-1.12.2	`TaterLib-1.12-<version>.jar`
1.11	1.11-1.11.2	`TaterLib-1.11-<version>.jar`
1.10	1.10-1.10.2	`TaterLib-1.10-<version>.jar`
1.9	1.9-1.9.4	`TaterLib-1.9-<version>.jar`
1.8	1.8-1.8.8	`TaterLib-1.8-<version>.jar`
1.7	1.7-1.7.10	`TaterLib-1.7.10-<version>.jar`
1.6.4	1.6.4	`TaterLib-1.6.4-<version>.jar`
1.2.5	1.2.5	`TaterLib-1.2.5-<version>.jar`
b1.7.3	b1.7.3	`TaterLib-b1.7.3-<version>.jar`

Dependencies

Fabric API - Required on Fabric
Legacy Fabric API - Required on Fabric 1.12.2 and below

Optional Dependencies

LuckPerms - For permissions/prefix/suffix support

Commands and Permissions

Command	Permission	Description
`/taterlib version`	`taterlib.command.version`	Get the TaterLib version
`/taterlib reload`	`taterlib.command.reload`	Reload TaterLib config
`/taterlib dump`	`taterlib.command.dump`	Dump TaterLib info
`/taterlib fulldump`	`taterlib.command.fulldump`	Dump TaterLib info