A lightweight API foundation for Minecraft (Bukkit/Spigot/Paper/Folia, Velocity, BungeeCord) and Hytale servers.

BlueFoundation focuses on keeping reusable plugin infrastructure small, explicit, and easy to access from a single namespace:

import net.blueva.foundation.BlueFoundation;

Multi-module Gradle project: one jar per platform, plus a shared common core pulled in transitively.

common/       -> BlueFoundation-Common
bukkit/       -> BlueFoundation            (Bukkit/Spigot/Paper/Folia)
velocity/     -> BlueFoundation-Velocity
bungeecord/   -> BlueFoundation-BungeeCord
hytale/       -> BlueFoundation-Hytale

Feature matrix

✅ full · ⚠️ partial · ❌ not applicable / not attempted. See each platform's docs page for the details behind a ⚠️.

Facade	Bukkit	Velocity	BungeeCord	Hytale
Dependencies	✅	✅	✅	✅
Reflection	✅	⚠️ generic only	⚠️ generic only	⚠️ generic only
Configs	✅	✅	✅	⚠️ standalone
Version	✅	⚠️ proxy/protocol	⚠️ proxy/protocol	⚠️ manifest semver
Text / Messages	✅	✅	✅	✅
Commands	✅	⚠️ basic	⚠️ basic	⚠️ basic
Scheduler	✅ incl. Folia	✅	✅	✅
BossBars	✅	✅	❌	❌
Scoreboards	✅	❌	❌	⚠️ experimental
Sounds	✅	❌	❌	✅
Music	✅	❌	❌	⚠️ MIDI only
Players	✅	⚠️ partial	⚠️ partial	❌
Materials, Items, Entities, NPCs, Particles, Attributes, GameRules, Inventories, Hologram, Blocks, Worlds	✅	❌	❌	❌

Installation

repo.blueva.net is a public Maven repository, no authentication needed.

Platform	Artifact
Bukkit / Spigot / Paper	net.blueva.foundation:BlueFoundation:26.32
Velocity	net.blueva.foundation:BlueFoundation-Velocity:26.32
BungeeCord	net.blueva.foundation:BlueFoundation-BungeeCord:26.32
Hytale	net.blueva.foundation:BlueFoundation-Hytale:26.32

repositories { maven("https://repo.blueva.net/releases") }
dependencies { compileOnly("net.blueva.foundation:BlueFoundation:26.32") } // swap the artifact id above for other platforms

Maven

<repositories>
    <repository>
        <id>blueva</id>
        <url>https://repo.blueva.net/releases</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>net.blueva.foundation</groupId>
        <artifactId>BlueFoundation</artifactId>
        <version>26.32</version>
    </dependency>
</dependencies>

Documentation

• Common module - shared core, pulled in transitively

Bukkit / Spigot / Paper

Dependencies · Version · Reflection · Materials and sounds · Music · Entities · Items · Text and messages · Scheduler · Commands · Configs · NPCs · Scoreboard · Multi-version events · Particles · Attributes · Game rules · Boss bars · Worlds, blocks, players and inventories

Proxies and Hytale

• Velocity
• BungeeCord
• Hytale

Goal

BlueFoundation aims to be a common foundation for Blueva plugins: small, clear, and ready to grow with multiversion tools and reusable systems - across Bukkit/Spigot/Paper, Velocity, BungeeCord, and Hytale.

License

GPL-3.0. See LICENSE.