Go to file
Aikar ab74bb4514
Speed up processing of chunk loads and generation
Credit to Spotted for the idea

A lot of the new chunk system requires constant back and forth the main thread
to handle priority scheduling and ensuring conflicting tasks do not run at the
same time.

The issue is, these queues are only checked at either:

A) Sync Chunk Loads
B) End of Tick while sleeping

This results in generating chunks sitting waiting for a full tick to
complete before it will even start the next unit of work to do.

Additionally, this also delays loading of chunks until this same timing.

We will now periodically poll the chunk task queues throughout the tick,
looking for work to do.
We do this in a fair method that considers all worlds, not just the one being
ticked, so that each world can get 1 task procesed each before the next pass.

We also cap the throughput of these task processes to 1 per world per 0.1ms or
200 max per tick, to ensure that high volume of tasks do not overload the current
tick time.

In a view distance of 15, chunk loading performance was visually faster on the client.

Flying at high speed in spectator mode was able to keep up with chunk loading (as long as they are already generated)
2020-04-09 02:25:18 -04:00
.github/ISSUE_TEMPLATE [CI-SKIP] Update Issue template 2018-09-26 17:22:20 -04:00
Spigot-API-Patches Updated Upstream (Bukkit/CraftBukkit) 2020-04-08 03:49:15 -04:00
Spigot-Server-Patches Speed up processing of chunk loads and generation 2020-04-09 02:25:18 -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 Updated Upstream (Bukkit/CraftBukkit) 2020-04-02 17:09:17 -04:00
work Updated Upstream (Bukkit/CraftBukkit) 2020-04-08 03:49:15 -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 Change the reserved channel check to be sensible (#1610) 2018-11-30 19:08:31 -05:00
README.md [CI-SKIP] Update build badge in README to use proper job 2020-02-08 17:58:39 -06: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

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.