CraftBukkit and Bukkit modifications that improve stability and add new features
Alternatives To Sportbukkit
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
a day ago1December 14, 2021495otherJava
High performance Spigot fork that aims to fix gameplay and mechanics inconsistencies
2 days ago337mitJava
A bridge/proxy allowing you to connect to Minecraft: Java Edition servers with Minecraft: Bedrock Edition.
2 days ago152otherJava
🗺️ Minecraft map editor and mod
11 days ago16gpl-3.0Kotlin
Fork of Paper which adds regionised multithreading to the dedicated server.
a day ago167apache-2.0Java
1.19.3 Lightweight Minecraft server
a month ago63otherJava
A fast, customizable and compatible open source server for Minecraft: Java Edition
Luckperms1,75418 days ago5February 09, 202254mitJava
A permissions plugin for Minecraft servers.
3 days ago41lgpl-3.0Java
高性能和高兼容性的1.12.2/1.16.5/1.18.2版本Forge+Bukkit+Spigot服务端 (A high performance and high compatibility 1.12.2/1.16.5/1.18.2 version Forge+Bukkit+Spigot server)
5 days ago3
📝Minecraft developer Chinese guide,我的世界开发者中文指南
19 hours ago170gpl-3.0Java
The modern Essentials suite for Spigot and Paper.
Alternatives To Sportbukkit
Select To Compare

Alternative Project Comparisons


CraftBukkit modifications and Bukkit API additions that fix bugs, add new features, and improve the quality of life

NOTE: This repository is no longer maintained, but a popular fork is still active. If you are looking to also support Minecraft 1.8, a new project called SportPaper has that additional functionality.

File Structure

SportBukkit is a fork of CraftBukkit, starting from the submodules in the base folder. The differences between CraftBukkit and SportBukkit are represented by the sequential patches in the Bukkit and CraftBukkit folders. Conceptually, these differences are divided into fixes and features.

Fixes are relatively small and have the potential to change or go away with future upstream changes. Every patch except the final one in each list contains a fix.

Feature changes are improvements and extensions to the Bukkit API, intended to be permanent. These are contained entirely in a single patch at the end of each sequence, called simply "SportBukkit".

For readability purposes, a copy of the final patched SportBukkit source code is stored in the snapshot folder. This code is updated automatically by scripts, and should not be manually edited or compiled.


To build SportBukkit, the following will need to be installed and available from your shell:

  • JDK 8 version 121 or later (older versions might work, but some are known not to)
  • Git
  • Maven
  • Ruby version 2.1 or later

To build on Windows you'll need to use the git bash console.

How To

See all available tasks: rake -T

Build everything: rake The SportBukkit binary will be located in build/CraftBukkit/target

Generate patched SportBukkit source code: rake apply Generated source will be in build/Bukkit and build/CraftBukkit

Compile SportBukkit from source: rake compile

Rebuild SportBukkit patches from source: rake generate

Remove all intermediate files: rake clean


This is roughly the process used to rebase SportBukkit to an updated upstream CraftBukkit.

  • Create a branch of this repo called rebase-(version) e.g. rebase-1.2.3.
  • Checkout the upstream branch of build/Bukkit and build/CraftBukkit and ensure they have clean work trees.
  • Delete the work folder.
  • Reset the submodules builddata, base/Bukkit, and base/CraftBukkit to the latest upstream master.
  • In version.rb, update NMS_VERSION and NMS_MD5 to the latest values (running rake deobf with the wrong MD5 will show you the right one).
  • Run rake deobf, rake decompile, and rake craftbukkit, in that order. These should all run without any conflicts.
  • At this stage, you have the latest CraftBukkit present and are ready to start the actual rebasing. This is a good time to create an initial commit on the rebase branch, with just the submodule and version.rb changes.
  • Run rake apply. This will attempt to apply the SportBukkit patches in the Bukkit and CraftBukkit folders to the new CraftBukkit. Assuming there have been upstream changes, many of these patches will fail and you will need to resolve the conflicts.
  • For each conflict, one of the repos build/Bukkit or build/CraftBukkit will be in a git am session, waiting on conflict resolution. Use the standard git merge process to resolve the conflict, and type git am --continue to continue applying patches.
  • Along the way, you can run rake generate to capture your progress in the patch files.
  • When you get to the end of the Bukkit patches, rebuild them and then run rake apply again to continue with the CraftBukkit patches.
  • The first CraftBukkit patch is strictly for importing NMS files verbatim. To recreate this patch, just copy the latest NMS version of each file in the patch from work/nms-src to build/CraftBukkit/src/main/java. This patch should always be updated, even if there are no merge conflicts.
  • The second CraftBukkit patch is strictly for fixing decompile errors. This patch should only make minimal changes to the files in the first patch to make them compile.
Popular Bukkit Projects
Popular Minecraft Projects
Popular Games Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.