Paper plugin generator for modern PaperMC servers

A large share of public Minecraft servers run Paper or one of its forks. Paper keeps the Bukkit and Spigot API, fixes many gameplay and performance issues, and adds an API of its own. A plugin written specifically for Paper can use that extra API, at the cost of no longer loading on plain Spigot.

If every server you run is Paper, Purpur, Pufferfish or Leaf, the trade is usually worth it: cleaner text handling, more events to listen to, and helpers that Spigot simply does not have.

Text is the most visible difference. Paper ships the Adventure library, where chat messages, titles, action bars and item names are components instead of strings full of color codes. Components carry hover text, click actions and hex colors without string tricks, and on recent Paper versions MiniMessage tags such as <green> or <gradient> make them easy to write from a config file.

Paper also fires events that Spigot lacks. PlayerJumpEvent lets a parkour plugin react to every jump, AsyncChatEvent handles chat as components, and PlayerArmorChangeEvent tells you when a piece of armor goes on or comes off. Name them in your description and the AI builds on them.

Newer releases keep adding API. Paper's data component API for items only exists from 1.21.4, for instance. Since the AI knows your target version, it will not reach for it in a 1.21.1 project, where it could not compile.

The 1.21 line shipped eleven patch releases, and several of them changed the API: constants were renamed, item components appeared, some methods moved. Compiling everything against a single "1.21" would build against the wrong API for a lot of servers.

That is why the generator lists 1.21 through 1.21.11 separately. Pick the exact version your server reports with /version, and the plugin is compiled against the matching API.

After 1.21.11, Minecraft Java moved to year-based version numbers. Spaleforce offers 26.1.1, 26.1.2, 26.2 and 26.3. For these versions, the Paper API is published under a build-numbered scheme instead of the old snapshot naming, which breaks build files that still expect the old format.

The compiler looks up the Paper API build that matches the 26.x version you picked, prefers a stable build when one exists, and compiles against it. If Paper has not published a build for that version yet, the plugin is compiled against the Spigot API instead, so the project still builds.

Purpur, Pufferfish and Leaf are built on Paper. Purpur adds a long list of configurable gameplay options and some API of its own, while Pufferfish and Leaf focus on performance for busy servers. A plugin written for Paper normally loads on all three.

You can also pick them directly as the server type. Purpur projects are compiled against the Purpur API, so Purpur-specific calls are available, while Pufferfish and Leaf projects use the Paper API they are built on. Before going live, start a test server from the editor and try the plugin in game.