pasta 🍝

Patch Bukkit/Paper plugins for Folia.

pasta is an open-source bytecode patcher that transforms existing Minecraft plugins for Folia compatibility — without requiring access to their source code.

Give pasta a plugin .jar. It analyzes the bytecode, rewrites supported Bukkit/Paper operations for Folia's regionized threading model, and produces a patched JAR.

Patch it your way

Web — Drop a plugin JAR into the browser and patch it locally.

CLI — Patch plugins from your terminal, scripts, or build pipeline.

Peperoncino 🌶️ — Automate patching with GitHub Actions.

Server Plugin — Patch plugins from your Minecraft server environment.

What pasta does

pasta uses ASM bytecode transformation to rewrite supported operations such as:

• Bukkit scheduler calls → Folia schedulers
• Region, entity, global, and async scheduling
• Selected world/block operations requiring region-thread execution
• Plugin metadata for Folia
• Runtime bridge calls required by transformed plugins

No source code modification is required.

Built for automation

pasta isn't just a one-off converter.

The same patching engine can be used from the browser, CLI, GitHub Actions, and automated pipelines—making Folia-targeted builds reproducible.

With Peperoncino, plugin developers can add pasta directly to CI and produce patched artifacts automatically.

Important

Patched does not mean proven thread-safe.

pasta can transform many common Bukkit/Paper patterns, but it cannot prove that arbitrary plugin logic is fully region-safe.

Reflection, third-party libraries, application-specific concurrency assumptions, unsupported APIs, and dynamic behavior may still require manual work.

Always test patched plugins before production use.

Open source

pasta is developed openly on GitHub.

Legacy plugin in. Folia-ready patch out. 🍝