mirror of https://github.com/PaperMC/Paper.git synced 2024-10-24 18:07:11 +02:00

High performance Spigot fork that aims to fix gameplay and mechanics inconsistencies https://papermc.io/

bukkit craftbukkit hacktoberfest java minecraft minecraft-api minecraft-performance minecraft-server paper paper-api papermc spigot-fork tacos

Find a file

Aikar 97b1cc361b Allow shutting down server during a watchdog hang gracefully If the request to shut down the server is received while we are in a watchdog hang, immediately treat it as a crash and begin the shutdown process. Shutdown process is now improved to also shutdown cleanly when not using restart scripts either. If a server is deadlocked, a server owner can send SIGUP (or any other signal the JVM understands to shut down as it currently does) and the watchdog will no longer need to wait until the full timeout, allowing you to trigger a close process and try to shut the server down gracefully, saving player and world data. Previously there was no way to trigger this outside of waiting for a full watchdog timeout, which may be set to a really long time...		2020-04-12 15:56:03 -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
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	Update test server startup script	2020-04-09 20:45:38 -04:00
Spigot-API-Patches	Disable Sync Events firing Async errors during shutdown	2020-04-11 23:22:40 -04:00
Spigot-Server-Patches	Allow shutting down server during a watchdog hang gracefully	2020-04-12 15:56:03 -04:00
work	Updated Upstream (CraftBukkit/Spigot)	2020-04-09 21:33:10 -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-04-02 17:09:17 -04:00
pom.xml	Fix up maven stuff hopefully	2018-09-22 12:58:09 -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.