Frequently Asked Questions
Where to download??!1?🔗
We have a downloads page on our website that's almost as majestic as my beard . It is our user friendly front-end for our downloads API: https://purpurmc.org/downloads
If you'd rather use the downloads API directly (for automation, scripts, or whatever) you can find the API endpoints listed on the home page.
What are the best purpur options?🔗
It's hard to summarize Purpur because then it wouldn't be fully representative of everything it can do.
Take a look at the most liked features poll over on reddit.
But that list is hardly exhaustive, so do make sure to check out all the available options, there's something for everyone \o/
Can I make a feature request or report a bug?🔗
Of course you can! That's what makes Purpur better and better ^_^
If you need to report a bug, please let us know about it. Remember, we can't fix what we don't know is broke
Bug Reports: https://github.com/PurpurMC/Purpur/issues/new
If you have a feature request or suggestion, please keep in mind that we try to stay away from niche features that may only help 1 or 2 servers. Things like that are best suited to plugins or datapacks. If you are unsure, open a ticket anyways and we'll let you know \o/
Feature Request: https://github.com/PurpurMC/Purpur/discussions/new
Purpur has permissions? 🔗
Purpur adds a few permissions for a few features and commands that it has added. Some permissions for specific features will not work unless you enable that feature in purpur.yml, too, so keep an eye out for those
What does <insert random config option> do?🔗
No seriously, we get asked this quite a lot. We built this wiki to answer all these questions so we wouldn't have to repeat them daily.
I promise, this wiki covers every single option in purpur.yml - you won't find any missing entries. (the only exception is when a new option gets added; it might take a day or two before the wiki updates)
Does Purpur have a Discord?🔗
Yes! It's where the Purpur community resides. Don't be afraid to poke your head in and take a peek! https://purpurmc.org/discord
What does Purpur add/change from upstream?🔗
Quite a lot, actually. But none of it goes into effect unless you enable it in
purpur.yml. We set everything we change to the default behaviors. If you don't edit anything in
purpur.yml, running this JAR is no different than running Pufferfish.
For the curious, you can view all the code changes on GitHub here: https://github.com/PurpurMC/Purpur/tree/master/patches
Don't worry if you can't read code. Most people can't. We have this nice wiki that covers every single option in
purpur.yml and all the new permission nodes added for some new features/commands.
Does Purpur have feature X from Paper?🔗
Yes, that's how forks work. All features from upstream are inherited by design
Vanilla -> CraftBukkit -> Spigot -> Paper -> Pufferfish -> Purpur
We have it all ^_^
Do CraftBukkit/Spigot/Paper/Pufferfish plugins work on Purpur?🔗
Yes. The only time there's incompatibility is due to authors hard-coding support for CraftBukkit/Spigot, ignoring the existence of Paper and its forks. If you run into any bugs that you know are because of Purpur, create a ticket and/or join our Discord server so we can take a look.
Is there a Purpur for MC
insert random version here?🔗
Maybe. Check the downloads page.