Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
August 4, 2020 20:07
August 21, 2023 11:24
September 30, 2022 07:16
December 6, 2023 13:45

Make Minecraft plugins faster, save boilerplate code to focus on putting your ideas out there instead of dealing with limited Spigot/Bukkit/Paper APIs.

Some features include:

  • Folia, Bukkit/Spigot/Paper support (1.2.5 - 1.20.x) - automatic version wrappers (i.e. call one method to send title/animation packets on all Minecraft versions)
  • GUI menu APIs
  • Advanced commands without using plugin.yml
  • Auto-updating configuration with comments support
  • Automatic libraries support: Packets, Discord, Citizens, Towny, etc.
  • Time-saving wrappers: Databases (flatfile SQL, HikariCP, MySQL), holograms API, custom items and skulls API, and so much more!

Thousands of servers are running on Foundation since 2013. It has been battle tested and proven in plugins ChatControl, Boss, CoreArena, Confiscate, AutoPlay, Puncher, Winter, AnimeX and others.

Quick Start

  1. Import Foundation using Maven/Gradle (see the Importing section).
  2. Change "extends JavaPlugin" to "extends SimplePlugin" (we need that to register things and listeners on our end automatically)
  3. Change onEnable() to onPluginStart() and onDisable() to onPluginStop() (we occupy these methods to perform logic)
  4. If you use a static getInstance() method in your main plugin's class, change it to return (T) SimplePlugin.getInstance() where T is your plugin instead. Delete the instance of your plugin from your class if you use it (if you have myPlugin = this anywhere, remove it).

For a sample plugin, see PluginTemplate.

A complete tutorial on how to use this library is a part of our Project Orion training available here

If you just want a quick start into Minecraft plugin development, check out this guick gist.


We use JitPack to automatically compile and host the latest release of Foundation for you.

a) Method 1 - (Recommended) JitPack:

To install Foundation with Maven, open your pom.xml, locate the <repositories> section and place this repository within it:


Then locate the <dependencies> section of your pom.xml and place the following inside of it. Replace the "REPLACE_WITH_LATEST_VERSION" string with the latest version from:


For more information, including how to use Foundation with other tools than Maven, please visit:

b) Method 2 - Downloading to disk:

This is great if you want to make changes to Foundation to suit your needs. After you downloaded and compiled Foundation (run maven "clean install" goal), do not place any repository to your pom.xml file, instead, only place the following dependency. Notice the groupId is different. You can use the LATEST keyword to automatically synchronize changes you make to your local copy of Foundation with your plugin source code.



We aim to provide broad compatibility layer enabling the below Minecraft versions to work:

  • 1.2.5 (from 2012) - Limited, see for setup instructions.
  • 1.3.2, 1.4.7, 1.5.2, 1.6.4 - Many APIs are missing due to lack of features/access.
  • 1.7.10
  • 1.8.8
  • 1.9.x, 1.10.x, 1.11.x, 1.12.x
  • 1.13.x, 1.14.x, 1.15.x, 1.16.x, 1.17.x, 1.18.x, 1.19.x, 1.20.x
  • We continously update for newer versions but sometimes forget to update it here, but it does not mean that the library is incompatible!

Foundation works on Bukkit, Spigot, Paper and as of recently also Folia (see the Wiki).

Licencing Information


  1. If you are a paying student of then you are granted full unlimited licence to use, modify and reproduce Foundation both commercially and non-commercially for yourself, your team or network without stating that you are using this library.

  2. If you are not a paying student of then you may use this library as stated above however you must clearly attribute that you are using Foundation in your software by linking to this GitHub page.

In both of the above cases, do not sell or claim any part of this library as your own.

No guarantee - this software is provided AS IS, without any guarantee on its functionality. We made our best efforts to make Foundation an enterprise-level solution for anyone looking to accelerate his coding however we are not taking any responsibility for the success or failure you achieve using it.