Skip to content

Multi-Platform Minecraft Plugin & Mod SDK (api/*)

General-purpose, MIT-licensed, Java 17+ multi-platform Minecraft plugin and mod SDK. Every module under api/ is usable standalone on Spigot, Paper, Folia, Fabric, NeoForge, and Velocity without depending on rtp-core or rtp-api.

All 14 modules uphold four shared architectural guarantees: - Java 17 bytecode baseline (ADR-113) so artifacts load on every modern server runtime from Minecraft 1.18+ through 26.x+. - Zero rtp-core or rtp-api dependency, enforced at bytecode level by ArchUnit package-boundary tests. - Zero raw thread creation (new Thread / Executors.new*ThreadPool); asynchronous and regional work routes through caller-supplied executors or TaskScheduler. - Fail-closed contracts on untrusted disk, YAML, JSON, and command inputs.


Architecture Overview (5 Functional Layers)

1. Runtime & Platform Abstraction

2. Configuration, Units & Self-Testing (PBIT / CBIT / IBIT)

3. Stochastic Control, Allocation & Telemetry

4. World Storage, Persistence & Data Decode

5. Cartography & Diagnostics Rendering


Module Catalog

Module Gradle Path Maven Artifact ID Package Root Runtime Dependencies Guide
server-api :server-api server-api io.github.dailystruggle.server.api Zero (JDK 17 only) server-api/README.md
commands-api :commands-api commands-api io.github.dailystruggle.commandsapi Zero at runtime (brigadier compileOnly) commands-api/README.md
menu-api :menu-api menu-api io.github.dailystruggle.menu.api :server-api, :commands-api menu-api/README.md
effects-api :effects-api effects-api io.github.dailystruggle.effectsapi Zero on common SPI (spigot-api compileOnly for .bukkit) effects-api/README.md
yaml-api :yaml-api yaml-api io.github.dailystruggle.rtp.common.configuration.yaml Zero (JDK 17 only) yaml-api/README.md
units-api :units-api units-api io.github.dailystruggle.rtp.common.selection.region.util Zero (JDK 17 only) units-api/README.md
bit-api :bit-api bit-api io.github.dailystruggle.bit Zero (JDK 17 only) bit-api/README.md
config-bit-api :config-bit-api config-bit-api io.github.dailystruggle.rtp.common.bit.config :yaml-api, :bit-api, :units-api config-bit-api/README.md
bytecode-api :bytecode-api bytecode-api io.github.dailystruggle.bytecode :yaml-api, :server-api, :config-bit-api bytecode-api/README.md
predict-api :predict-api predict-api io.github.dailystruggle.rtp.common.predict Zero (JDK 17 only) predict-api/README.md
metrics-api :metrics-api metrics-api io.github.dailystruggle.metrics.api Zero (JDK 17 only) metrics-api/README.md
bstats-api :bstats-api bstats-api io.github.dailystruggle.bstats.api Zero (JDK 17 only) bstats-api/README.md
database-api :database-api database-api io.github.dailystruggle.database.api Zero (JDK 17 only) database-api/README.md
anvil-api :anvil-api anvil-api io.github.dailystruggle.anvil :bit-api (JDK 17 only) anvil-api/README.md
tags-api :tags-api tags-api io.github.dailystruggle.rtp.tags, io.github.dailystruggle.rtp.api.{block,safety} Zero (JDK 17 only) tags-api/README.md
schematics-api :schematics-api schematics-api io.github.dailystruggle.rtp.api.schematic, io.github.dailystruggle.rtp.api.platform :tags-api, :server-api (JDK 17 only) schematics-api/README.md
maps-api :maps-api maps-api io.github.dailystruggle.mapsapi Zero on core/image (spigot-api compileOnly for .bukkit) maps-api/README.md

Flat Gradle project paths: On disk, these modules live under api/<module>, while settings.gradle keeps their Gradle project paths flat (:<module>, e.g. ./gradlew :predict-api:build).


Standalone Consumption (Maven Central & JitPack)

Standalone plugin and mod authors can pull individual SDK modules from Maven Central (io.github.dailystruggle:<module>:<version>) or JitPack (com.github.DailyStruggle.RTP:<module>:<tag>):

Gradle (build.gradle)

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

dependencies {
    // Maven Central coordinates
    implementation 'io.github.dailystruggle:server-api:3.3.1'
    implementation 'io.github.dailystruggle:yaml-api:3.3.1'
    implementation 'io.github.dailystruggle:units-api:3.3.1'
    implementation 'io.github.dailystruggle:bit-api:3.3.1'
    implementation 'io.github.dailystruggle:config-bit-api:3.3.1'
    implementation 'io.github.dailystruggle:predict-api:3.3.1'

    // Or via JitPack tag / branch snapshot
    // implementation 'com.github.DailyStruggle.RTP:predict-api:3.3.1'
}