Run Bukkit, Spigot, and Paper plugins on PumpkinMC
Go to file
Purdze 2dc589830e implement event cancelling for java plugins
propagate cancellation state from java bukkit events back to pumpkin
events. when a java plugin calls event.setCancelled(true), the
cancellation is now properly applied to the underlying pumpkin event.

- add Cancellable trait bound to PatchBukkitEventHandler
- call event.set_cancelled(true) when java event is cancelled
2026-02-03 13:16:02 +00:00
.github Add in issue template to support plugin 2026-02-01 12:53:08 -07:00
examples/BasicPlugin Add in BasicPlugin for testing 2026-01-22 09:21:24 -07:00
java Fix cancel checking causing errors 2026-02-02 16:53:54 -07:00
rust implement event cancelling for java plugins 2026-02-03 13:16:02 +00:00
.gitattributes Initial commit 2026-01-21 19:20:07 +01:00
.gitignore Add in BasicPlugin for testing 2026-01-22 09:21:24 -07:00
ARCHITECTURE.md Add ARCHITECTURE to README.md 2026-02-01 14:31:24 -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 Add ARCHITECTURE to README.md 2026-02-01 14:31:24 -07:00

PatchBukkit

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

Installation

Important

Currently PatchBukkit is in heavy development, as such releases are not yet available.

  1. Requirement: Install Java 25 or newer.
  2. Download: Grab the library matching your operating system from the Releases page:
  • patchbukkit-windows-x86.dll (Windows)
  • patchbukkit-linux-x86.so (Linux x86_64)
  • patchbukkit-linux-aarch64.so (Linux ARM64/ Raspberry Pi)
  • patchbukkit-mac.dylib (macOS)
  1. Deploy: Place the downloaded file into your PumpkinMC plugins/ directory. (Run PumpkinMC once to generate this folder if it doesn't exist).
  2. Initialize: Restart PumpkinMC. This creates a new patchbukkit/ directory in your server root.
  3. 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.