Shared HostingFirst month freeShared web hosting from $2.99/mo — $0 today, and the price you sign up at is the price you renew at.See hosting plans →
Source-checkedLibraries & compatibility

BKCommonLib

by TeamBergerhealer · for Minecraft

Common utility library adding unique new features and API's

220KDownloads
12d agoLast updated
Spigot · PaperLoaders
26.2Latest game version
Add to my serverDownload from SpigotMC

About BKCommonLib

From SpigotMC

Common utility library adding unique new features and API's

[​IMG]

〚 ⤓ Jenkins Dev Builds / Source on GitHub / Javadocs / Discord 〛

About BKCommonLib
⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺
BKCommonLib is a Paper/Spigot/Bukkit server plugin and library which houses a large selection of utilities, API's, frameworks and performance-critical code. It was made to eliminate all use of Minecraft Server Code (aka NMS) from plugins themselves, improving their stability.

It made it so that when Minecraft updates, only this library has to be updated. Plugins using it generally don't require updates anymore, except to stay compatible with BKCommonLib itself.

Compatible Servers

  • Spigot, PaperMC, Pufferfish, Purpur, Tuinity, TacoSpigot
  • Most other forks of the above should work fine
  • Forge Paper hybrids, with limitations:
    • Mohist 1.12.2 and 1.16.5
    • Magma 1.12.2
    • Arclight 1.12.2, 1.15.2, 1.16.5 and 1.18.2
    • CatServer 1.12.2
Backwards-Compatible

The latest version of BKCommonLib is compatible with all Minecraft versions 1.8 and above. This means version 1.19 of BKCommonLib should work on Spigot 1.12.2, Paper 1.16.5, Pufferfish 1.18.2 and so on.

Do not install an older version of BKCommonLib for older versions of Minecraft.

Support
⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺⎺
If Minecraft just updated or Spottedleaf made some ground-breaking optimizations in Paper, you might find that BKCommonLib stops working. Bergerkiller is probably on the case, and there might already be development builds available that fix your problem over at our build server:

Development Builds: https://ci.mg-dev.eu/job/BKCommonLib/

Report any problems to us on the GitHub Issue Tracker or join our Discord Server for assistance. Issue reports for older server versions are welcome too.

Tutorials and example projects are lacking a bit, but you can ask for API help on the discord. We'll help.

Features
<button type="button" class="button bbCodeSpoilerButton ToggleTrigger Tooltip JsOnly" title="Click to reveal or hide spoiler" data-target="> .SpoilerTarget">Spoiler: Includes Mountiplex General Purpose Java Reflection Library</button>
Mountiplex is core to BKCommonLib's ability to support so many different Minecraft Server versions and even forge at the same time. It combines the strengths of ASM, Javassist and Objenesis with a Template Engine to generate compatible code at runtime. To achieve this it supports template declarations for macros, reflection and remapping and molds this into a compiletime-generated interface.

This means you don't have to compile different classes for every different permutation of paper/spigot/forge/version and the millions of forks people create. If someone changes something, add an #if - #endif block and you're set!

Here is an example template for various packets to demonstrate the power of this approach

  • At-runtime class generation with Handles, reflection, template engine
  • Dynamic type/name remapping to support forge/multi-version/Mojang Mappings
  • Parse version strings, compare them. Also inside templates.
  • Detect existence of types, methods and fields and generate an appropriate compatible implementation
  • Access private members with #require and call them with #name anywhere in the code
  • Maven Mojo tasks to generate the interfaces or convert block comments into strings (jdk8 multiline string back-support)
  • Type Conversion
    • Automatically convert one value type to another using a type &lt;&gt; type registry

Read the full description on SpigotMC →

Highlights

From source data

Game versions

Supports 17 Minecraft versions, the newest being 26.2.

Loaders

Runs on Spigot and Paper.

Footprint

Rated a light load on a server.

BKCommonLib on Nxeon

From our catalogue
One-click install
Supported on Nxeon Minecraft servers, for Paper servers. We download it from SpigotMC, place it, and restart the server.
Server side
Required on the server
Server type needed
Spigot, Paper
Server load
light
Smallest plan we suggest
Minecraft — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
2.0.4, released 2026-10-03

Game versions by loader

LoaderGame versionsNewest
Paper1.8 to 26.2 (17 versions)26.2
Spigot1.8 to 26.2 (17 versions)26.2

From 11 recorded builds of BKCommonLib.

Recent builds

BuildReleasedGame versionsLoaders
2.0.42026-10-031.8 to 26.2 (17 versions)Spigot, Paper
2.0.32026-09-16n/aSpigot, Paper
2.0.22026-08-08n/aSpigot, Paper
2.0.12026-07-03n/aSpigot, Paper
2.0.02026-07-01n/aSpigot, Paper
1.21.11-v12025-12-25n/aSpigot, Paper

Run BKCommonLib on a Minecraft server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on SpigotMC as “Core”

Libraries & compatibility

Foundations and fixes other mods build on. Usually installed because something else needs it.

Runs on your server

From source side support

SpigotMC lists BKCommonLib as required on the server. Check its SpigotMC page to see whether players need it too.

Compatibility

Game
Minecraft
Loaders
SpigotPaper
Runs on
Serverrequired on the server
Game versions
26.2 and 16 earlier
Requires
One-click install needs a Paper server.

Verified at the source

  • ✓SpigotMCOfficial listing, checked 2026-10-04Open ↗
  • ✓AuthorTeamBergerhealer, as published on SpigotMC
  • ✓LicenseNot published by the sourceFree

BKCommonLib, answered

Generated from the mod’s own source data.

Do my players need to install BKCommonLib?

SpigotMC lists BKCommonLib as required on the server. Check its SpigotMC page to see whether players need it too.

Which loaders does it support?

Spigot and Paper.

Is it free?

Yes. BKCommonLib is free to download from SpigotMC.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run BKCommonLib on a Minecraft server.

Deploy in about a minute from $4.99 a month, then add BKCommonLib in one click.

Deploy a Minecraft serverMore Minecraft mods