Skip to main content

​
Build Minecraft plugins faster

Foundation is a battle-tested framework that helps you create Minecraft plugins faster by providing time-saving APIs and reducing boilerplate code. Focus on putting your ideas out there instead of dealing with limited Spigot/Bukkit/Paper APIs. Thousands of servers have been running on Foundation since 2013, powering plugins like ChatControl, Boss, CoreArena, Confiscate, and many others.

​
Key features

Wide compatibility

Supports Minecraft 1.2.5 through 1.21.x with automatic version wrappers that work across all versions

Advanced commands

Create powerful commands without plugin.yml, with built-in tab completion and permission handling

GUI menu system

Intuitive API for creating interactive menus and inventory GUIs with automatic click handling

Smart configuration

Auto-updating YAML configs with comments support and type-safe access to settings

Library support

Automatic integration with popular plugins: ProtocolLib, Citizens, Towny, Vault, PlaceholderAPI, and more

Time-saving utilities

Databases (MySQL, HikariCP, flatfile), holograms, custom items, skulls, NBT editing, and much more

​
Quick example

Here’s how simple it is to create a plugin with Foundation: 
public class MyPlugin extends SimplePlugin {
    
    @Override
    protected void onPluginStart() {
        // Your startup logic here
        Common.log("My plugin has started!");
    }
    
    @Override
    protected void onPluginStop() {
        // Your shutdown logic here
    }
}
Compare this to traditional JavaPlugin where you need to manually register listeners, load configs, handle commands, and more.

​
Platform support

Foundation provides broad compatibility across:
  • Minecraft versions: 1.2.5 - 1.21.x (continuous updates for newer versions)
  • Server software: Bukkit, Spigot, Paper, and Folia
  • Java version: Java 8 and above
Legacy versions (1.2.5-1.6.4) have limited API support due to lack of features in those Minecraft versions.

​
Learning resources

Quick start guide

Get your first Foundation plugin running in minutes

Installation

Complete setup with Maven or Gradle including shading configuration

Project Orion

Complete training course on plugin development with Foundation

Plugin Template

Example project showing Foundation best practices

​
Getting help

Join our community:
Foundation requires proper shading configuration to work correctly. Make sure to follow the installation guide carefully to avoid including unnecessary dependencies in your plugin jar.

Build docs developers (and LLMs) love

Get started for freeTalk to us