mirror of https://github.com/PaperMC/Paper.git synced 2024-12-15 07:01:36 +08:00

Go to file

Mariell Hoversholm 9f8ae5cb61 Prioritise own classes where possible This adds the server property `Paper.DisableClassPrioritization` to disable prioritization of own classes for plugins' classloaders. This value is by default not present, and this will therefore break any plugins which abuse behaviour related to not using their own classes while still loading their own. This is often an issue with failing to relocate or shade properly, such as when shading plugin APIs like Vault. A plugin's classloader will first look in the same jar as it is loading in for a requested class, then load it. It does not re-use other plugins' classes if it has the chance to avoid doing so. If a class is not found in the same jar as it is loading for and it does find it elsewhere, it will still choose the class elsewhere. This is intended behaviour, as it will only prioritise classes it has in its own jar, no other plugins' classes will be prioritised in any other order than the one they were registered in. The patch in general terms just loads the class in the plugin's jar before it starts looking elsewhere for it.		2020-05-16 23:33:47 -04:00
.github/ISSUE_TEMPLATE	[CI-SKIP] Update Issue template	2018-09-26 17:22:20 -04:00
licenses	[CI-SKIP] Clarify project licensing	2018-03-06 20:41:03 -05:00
Paper-MojangAPI	Rename to AsyncPlayerSendSuggestionsEvent to be consistent in naming	2020-05-02 15:29:03 -04:00
removed	Remove some old removed 1.14 patches that are never going to be needed (fixed/already applied)	2020-04-02 00:42:15 -04:00
scripts	Speed up rebuilding patches and reduce diff	2020-05-06 05:31:08 -04:00
Spigot-API-Patches	Prioritise own classes where possible	2020-05-16 23:33:47 -04:00
Spigot-Server-Patches	Check portal restrictions when entering end gateways	2020-05-16 23:28:59 -04:00
work	Updated Upstream (Bukkit/CraftBukkit/Spigot)	2020-05-12 01:27:07 -04:00
.editorconfig	[CI-SKIP] add .editorconfig for base code style settings	2018-08-07 01:14:22 -04:00
.gitignore	Hey vscode, get your files outta my repo	2019-06-08 15:38:10 -05:00
.gitmodules	Cleanup and restructure the project	2016-04-01 23:15:41 -05:00
.travis.yml	[CI-SKIP] Have travis ensure openjdk11 builds run	2018-10-24 16:26:47 -04:00
CONTRIBUTING.md	[CI-SKIP] Passage outdated (#2776 )	2020-01-09 19:43:46 -06:00
LICENSE.md	Add API MinecraftServer#isStopping (#3129 )	2020-04-11 01:51:35 -04:00
paper	Updated Upstream (Bukkit/CraftBukkit)	2020-05-01 18:03:57 -04:00
pom.xml	Implement Brigadier Mojang API	2020-04-27 01:42:12 -04:00
README.md	[CI-SKIP] Update build badge in README to use proper job	2020-02-08 17:58:39 -06:00

README.md

Paper

High performance Spigot fork that aims to fix gameplay and mechanics inconsistencies.

Support and Project Discussion:

IRC or Discord

How To (Server Admins)

Paperclip is a jar file that you can download and run just like a normal jar file.

Download Paper from our downloads page.

Run the Paperclip jar directly from your server. Just like old times

Documentation on using Paper: paper.readthedocs.io
For a sneak peak on upcoming features, see here

How To (Plugin Developers)

See our API patches here
See upcoming, pending, and recently added API here
Paper API javadocs here: papermc.io/javadocs
Maven Repo (for paper-api):

<repository>
    <id>papermc</id>
    <url>https://papermc.io/repo/repository/maven-public/</url>
</repository>

Artifact Information:

<dependency>
    <groupId>com.destroystokyo.paper</groupId>
    <artifactId>paper-api</artifactId>
    <version>1.15.2-R0.1-SNAPSHOT</version>
    <scope>provided</scope>
 </dependency>

How To (Compiling Jar From Source)

To compile Paper, you need JDK 8, maven, and an internet connection.

Clone this repo, run ./paper jar from bash, get files.

How To (Pull Request)

See Contributing

Special Thanks To:

YourKit, makers of the outstanding java profiler, support open source projects of all kinds with their full featured Java and .NET application profilers. We thank them for granting Paper an OSS license so that we can make our software the best it can be.