A lightweight API foundation for Minecraft plugins.

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

import net.blueva.foundation.BlueFoundation;

Installation

Gradle (Kotlin DSL)

repositories {
    maven("https://repo.blueva.net/releases")
}

dependencies {
    compileOnly("net.blueva.foundation:BlueFoundation:26.24")
}

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.24</version>
    </dependency>
</dependencies>

repo.blueva.net is a public Maven repository, no authentication needed to depend on it.

API structure

BlueFoundation is a small facade. Implementations live in dedicated packages, while public aliases keep usage centralized under BlueFoundation.*. Event wrappers are also split into dedicated interfaces/adapters internally.

BlueFoundation.Dependencies
BlueFoundation.Version
BlueFoundation.Reflection
BlueFoundation.Materials
BlueFoundation.Items
BlueFoundation.AdventureItems
BlueFoundation.Sounds
BlueFoundation.Music
BlueFoundation.Entities
BlueFoundation.Scheduler
BlueFoundation.Commands
BlueFoundation.Messages
BlueFoundation.Text
BlueFoundation.AdventureText
BlueFoundation.Events
BlueFoundation.Configs
BlueFoundation.NPCs
BlueFoundation.Players
BlueFoundation.Worlds
BlueFoundation.Blocks
BlueFoundation.Particles
BlueFoundation.Attributes
BlueFoundation.GameRules
BlueFoundation.BossBars
BlueFoundation.Inventories
BlueFoundation.Scoreboards

Documentation

• Runtime dependencies: BlueFoundation.Dependencies
• Version utilities: BlueFoundation.Version
• Reflection helpers: BlueFoundation.Reflection
• Materials and sounds: BlueFoundation.Materials, BlueFoundation.Sounds
• Music: BlueFoundation.Music
• Entities: BlueFoundation.Entities
• Items: BlueFoundation.Items
• Text and messages: BlueFoundation.Text, BlueFoundation.Messages
• Scheduler: BlueFoundation.Scheduler
• Commands: BlueFoundation.Commands
• Configs: BlueFoundation.Configs
• NPCs: BlueFoundation.NPCs
• Scoreboard: BlueFoundation.Scoreboards
• Multi-version events: BlueFoundation.Events
• Particles: BlueFoundation.Particles
• Attributes: BlueFoundation.Attributes
• Game rules: BlueFoundation.GameRules
• Boss bars: BlueFoundation.BossBars
• Worlds, blocks, players and inventories: BlueFoundation.Worlds, BlueFoundation.Blocks, BlueFoundation.Players, BlueFoundation.Inventories

Goal

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