Run Bukkit, Spigot, and Paper plugins on PumpkinMC
Go to file
Purdze 338717143a add conformance test plugin and fix command registration panic
- new patchbukkit-test-plugin gradle subproject with 69 tests across
  10 categories (server, plugin_manager, command_system, event_system,
  permissions, registry, entity, console_sender, unsafe_values, stubs)
- test framework with reflection-based discovery, ansi-colored output,
  and ci-parseable [PBTEST_SUMMARY] line
- /pbtest [category|all] command for manual test execution
- fix .unwrap() panic in command_manager.rs register_permission that
  crashed the jvm worker thread when plugins declared commands
2026-02-12 12:13:42 -07:00
.github Fix output artifacts missing 2026-02-11 20:41:33 -07:00
java add conformance test plugin and fix command registration panic 2026-02-12 12:13:42 -07:00
proto/patchbukkit use tracing for logging instead 2026-02-12 12:04:33 -07:00
rust add conformance test plugin and fix command registration panic 2026-02-12 12:13:42 -07:00
.gitattributes Initial commit 2026-01-21 19:20:07 +01:00
.gitignore Remove ffi class 2026-02-03 23:05:40 -07:00
ARCHITECTURE.md Fix all clippy lints 2026-02-04 00:07:45 -07:00
build.sh Make build.sh only build jar 2026-02-01 14:31:04 -07:00
LICENSE Initial commit 2026-01-21 19:17:13 +01:00
README.md Update the readme to have releases 2026-02-11 22:56:09 -07:00

PatchBukkit

A plugin for PumpkinMC that adds support for PaperMC, Spigot, and Bukkit plugins.

Installation

  1. Requirement: Install Java 25 or newer.
  2. Download: Grab the library matching your operating system from the Releases page:
  3. Deploy: Place the downloaded file into your PumpkinMC plugins/ directory. (Run PumpkinMC once to generate this folder if it doesn't exist).
  4. Initialize: Restart PumpkinMC. This creates a new patchbukkit/ directory in your server root.
  5. Add Plugins: Drop your .jar plugin files (Paper/Spigot/Bukkit) into the newly created patchbukkit/patchbukkit-plugins/ folder and restart.

Development

If you wish to contribute to PatchBukkit, follow the following steps:

Note

Your PumpkinMC server must be built with the same nightly toolchain as PatchBukkit.

  1. Run ./build.sh
  2. Copy the target/debug/patchbukkit binary to the plugins directory in your PumpkinMC server.

There is also an architecture guide available.