Add page documenting gameplay changes and how to reset them #21
Comments
|
Would also need to keep track of every single Bukkit and Spigot change. |
In an ideal world, it would be great if all those changes were listed, but yes, I know what you mean in that it isn't feasible to keep track of all those changes and it's also not the responsibility of the Paper team. So I see your point (please correct me if I am misunderstanding) of "this list would not encompass all changes to vanilla since Paper is built on top of Bukkit & Spigot which have their own changes" and I agree with it. In other words, "what elements of gameplay would be different on a Paper server compared to a Spigot server, both with default configurations". Edit: I've edited the first sentence of my original message to clarify this (added "on top of Spigot"). |
|
Here's the list I could find (but IDK how I would put it in the docs, because I don't know what style guides exist, etc.): World settings
Additional notes
|
|
I don't think documenting the differences to spigot is relevant. we want to document the changes needed to make it behave as closely as possible to vanilla. it will however, never be perfect, by design, we aren't vanilla. looking at the changes you found, you actually did that, so I guess just remove references to spigot and say vanilla instead. |
|
The docs only cover 1.17, and we generally don't support old versions, so for inclusion here only the latest version. Regarding style, we currently don't have a super set style guide. Even within one page the style changes a decent bit at points (looking at the configuration page). if you would like to PR something for this, really, just look at the other pages and have it decently match. This is something I hope to standardize more in the future. A page like this would go under the Another thing to consider, and part of why having a section like this is a lot harder than it seems, is a lot of changes made have no config options, are inherited from upstream, or are bugs. However, just having the config changes documented is more than a good start. |
|
Thanks for the encouragement 😄 |
|
I'd also love this, my primary complaint over recommending people using paper by default over spigot, is the large amount of changes + default configs that enact changes to vanilla by default. One way I propose that this information could be conveyed, is on the configuration section, for each option,
The other major thing that the config options need, is the common reason or justification of why someone would want to change the setting. e.g.
As a user I immediately understand the implications of changing this value, but I don't immediately know
That information is critical in making an informed decision about whether to use the vanilla behavior, or to correct it. |
|
I made a list of differences, along with the changed config files: |
Incredible thank you. I will modify my PR the upcoming days. |
Uh oh!
There was an error while loading. Please reload this page.
This is a request to list all (major) changes PaperMC makes to gameplay on top of Spigot (i.e. that players would notice versus a vanilla server or that break adventure maps/farms made for vanilla servers) that are enabled by default.
I have looked through the docs and while these are listed in the configuration page, it would be very, very helpful to have these listed separately, for example, on the FAQ page (https://paper.readthedocs.io/en/latest/about/faq.html).
This way, instead of looking though the configuration docs/file and figuring out if each setting should be true or false (basically having to read the all the config options and debate if they are different from the vanilla behaviour), it would be a simple glance at the FAQ to figure out which setting(s) to change.
Not only would this benefit first-time setup, but it would also benefit in the case people (like many) have not updated in a while and notice a new build of PaperMC made a gameplay change so they now have to go through several (possibly lots of) commit messages to track down what has changed.
In fact, this issue was prompted by the "Don't apply cramming damage to players" patch (PaperMC/Paper#5903) which changes gameplay by default but can be hard to notice, especially as time passes and this build/commit message is not displayed on the downloads page anymore.
A list of the changes I can think of that should be listed:
Note that the above list is probably incomplete because (and this illustrates my point) I am not 100% sure if any of the other settings can impact gameplay/break some adventure maps/farms.
Also, just to be clear, I am not asking for any of these settings to be removed/changed back to the setting that would match vanilla by default, but to simply point them out in a single location (the FAQ page).
This would also help clear up the confusion that some people have which sometimes leads to server owners choosing Spigot because "Paper changes vanilla too much" but they are not sure exactly what or what setting to change.
TL;DR - please list all the (major) changes PaperMC makes to vanilla with the default configuration in the FAQ.
The text was updated successfully, but these errors were encountered: