ZentrixAPI

Developer API for creating Zentrix Battle Royale addons.

Resources

• Developer API Wiki - Full documentation
• Javadocs - API reference
• Example Addon - Working example

Features

• Query games, players, teams, phases, and stats
• React to gameplay via events
• Register custom recipes with craft limits
• Store addon data under plugins/Zentrix/addons/<addon-id>/
• Resolve copied game-* instances and their waiting, Nether, End, and deathmatch worlds
• Query and control Nether/End access, revival, deathmatch startup, force-start, and dynamic game rules
• Manage Cornucopia and per-world game-loot pools, loot-table imports, validation, and recovery
• Control Cornucopia placement, corpse lifecycle, teammate compasses, dragon buses, and block mechanics
• Open and extend every built-in menu, and register or resolve runtime GUI layouts
• Use party and runtime-game-scoped chat services

Installation

Gradle (Kotlin DSL)

repositories {
    maven("https://jitpack.io")
}

dependencies {
    compileOnly("com.github.ItsHarshXD:ZentrixAPI:1.6.0")
}

Gradle (Groovy)

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    compileOnly 'com.github.ItsHarshXD:ZentrixAPI:1.6.0'
}

Maven

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.github.ItsHarshXD</groupId>
    <artifactId>ZentrixAPI</artifactId>
    <version>1.6.0</version>
    <scope>provided</scope>
</dependency>

Quick Start

1. Create Your Addon

public final class MyAddon extends ZentrixAddon {
    @Override
    protected void onAddonEnable() {
        // Get the API
        ZentrixAPI api = ZentrixAPI.get();
        
        // Use a service
        api.getGameService().getActiveGames();
        
        // Register listeners
        getServer().getPluginManager().registerEvents(new MyListener(), this);
    }
}

2. Add plugin.yml

name: MyAddon
version: 1.0.0
main: com.example.myaddon.MyAddon
depend: [Zentrix]
api-version: '1.21'

3. Use the API Anywhere

// Get the API from one place
ZentrixAPI api = ZentrixAPI.get();
api.getGameService().getActiveGames();
api.getCurrencyService().getBalance(player);

Requirements

• Java 21+
• Paper 1.21.9-.1.21.10
• Zentrix plugin

License

All Rights Reserved