Go to file
Aikar b6cf80ee66
Preload important classes such as Logger and JLine
This is for 2 reasons:
1) Ensuring our log4j is mostly loaded at OUR version.
   I've seen stack traces with line numbers that do not match our version. This means that some
   plugin has shaded in log4j and their loaded version is mixing with ours....
   So by at least trying to load a bunch of log4j classes before we load plugins, we can be
   more sure mixed versions are not loading.

2) If the jar file is replaced while the server is runnimg class not found errors galore
   This will preloaod a bunch of classes commonly seen to error during shutdown due to this.

   The goal here is to help let the server shutdown gracefully as possible. Some plugins will
   still blow up here if they access a class that hadn't been loaded yet, but goal is to at least
   stop freezing the shutdown process as it does with JLine and Log4j errors requiring an external kill.

   Ideally you should not replace jars while the server is running, but it is something that happens in
   development for testing.

Updated test server to do a copy though to avoid this happening in Paper development.
2020-05-24 13:19:08 -04:00
.github/ISSUE_TEMPLATE [CI-SKIP] Update Issue template 2018-09-26 17:22:20 -04:00
Paper-MojangAPI Rename to AsyncPlayerSendSuggestionsEvent to be consistent in naming 2020-05-02 15:29:03 -04:00
Spigot-API-Patches Preload important classes such as Logger and JLine 2020-05-24 13:19:08 -04:00
Spigot-Server-Patches Preload important classes such as Logger and JLine 2020-05-24 13:19:08 -04:00
licenses [CI-SKIP] Clarify project licensing 2018-03-06 20:41:03 -05: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 Preload important classes such as Logger and JLine 2020-05-24 13:19:08 -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 Fix ./paper edit continue for Windows 2020-05-19 23:14:34 -04: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 Fix path in CONTRIBUTING.md (#3406) 2020-05-19 23:08:37 -04:00
LICENSE.md Add API MinecraftServer#isStopping (#3129) 2020-04-11 01:51:35 -04:00
README.md [CI-SKIP] Update build badge in README to use proper job 2020-02-08 17:58:39 -06:00
paper Optimize sending packets to nearby locations (sounds/effects) 2020-05-23 17:17:14 -04:00
pom.xml Implement Brigadier Mojang API 2020-04-27 01:42:12 -04:00

README.md

Paper Build Status

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

Support and Project Discussion:

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

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-Logo

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.