Developer API

The TNT Run API allows developers to hook into game lifecycles, track player statistics, modify double jump behavior, and react to player eliminations. All custom events in the plugin inherit from the base TNTRunEvent class.

---

Dependency Setup

To start using the API, you need to add the TNT Run JAR file to your project’s dependencies. Create a folder named libs in your project’s root directory and place the tnt-run-x.x.x.jar file inside it.

Gradle (Groovy)

dependencies {
    compileOnly files('libs/tnt-run-x.x.x.jar')
}

Gradle (Kotlin)

dependencies {
    compileOnly(files("libs/tnt-run-x.x.x.jar"))
}

Maven

<dependency>
    <groupId>dev.despical</groupId>
    <artifactId>tnt-run</artifactId>
    <version>LATEST</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/libs/tnt-run-x.x.x.jar</systemPath>
</dependency>

Caution

Don’t forget to add TNTRun to the depend or softdepend list in your plugin.yml file to ensure it loads before your plugin.

plugin.yml

name: YourPlugin
version: 1.0.0
main: your.package.Main
depend: [TNTRun]

---

Base Event Class

Every event provided by the TNT Run API extends the TNTRunEvent class. This shared base type acts as the root for all custom Bukkit events fired by the plugin.

public abstract class TNTRunEvent extends Event {
}

Concrete event classes each provide their own Bukkit HandlerList, so you should listen to the specific event you need instead of trying to listen to TNTRunEvent directly.

Next Steps

Explore the different event categories to start building your integration:

• Player Events
• Game Events