Go to file
Shane Freeder 5eb61dd432
Buffer OOB setBlock calls
lets debug mode throw a trace in order to potentially see where
such calls are cascading from easier, but, generally, if you see one setBlock
call, you're gonna see more, and this just potentially causes a flood of logs
which can cause issues for slower terminals, etc.

We can limit the flood by just allowing one for a single gen region,
we'll also only gen a trace for the first one, I see no real pressing need
to generate more, given that that would *massively* negate this patch otherwise
2022-03-19 12:35:56 +00:00
.github [ci-skip] Fix typo in feature request issue template (#7593) 2022-03-13 21:41:05 +00:00
Paper-MojangAPI [ci skip] sync dependency versions in paper-mojangapi with paper-api 2021-12-25 15:12:28 -08:00
build-data Add get/set wait time for fish hooks. (#5595) 2022-03-13 22:33:01 +00:00
gradle/wrapper [ci skip] Update gradle wrapper 2022-03-13 14:25:04 -07:00
licenses [CI-SKIP] Clarify project licensing 2018-03-06 20:41:03 -05:00
patches Buffer OOB setBlock calls 2022-03-19 12:35:56 +00:00
scripts Updated Upstream (Bukkit/CraftBukkit) (#7604) 2022-03-16 16:57:51 +01:00
test-plugin [ci skip] Update Gradle wrapper to 7.4 2022-02-21 13:44:17 -07:00
work Updated Upstream (CraftBukkit) (#7624) 2022-03-19 10:33:49 +01:00
.editorconfig Update editorconfig 2021-06-14 21:02:20 -07:00
.gitattributes Fix patch, fix .gitattributes file name 2021-06-12 14:09:11 +02:00
.gitignore [ci skip] Add a test plugin (#6133) 2021-07-09 03:04:33 -07:00
.gitmodules Remove Paperclip submodule 2021-06-15 01:44:13 -05:00
CONTRIBUTING.md Update readme and contributing guidelines 2021-11-30 19:26:33 +01:00
LICENSE.md Add configurable height for slime spawn per world (#6310) 2022-01-10 18:27:16 -08:00
README.md Update README for new docs (#7561) 2022-03-09 10:10:59 +01:00
build.gradle.kts Add printPaperVersion task 2022-03-04 09:41:03 +00:00
gradle.properties Initial 1.18 update 2022-02-28 22:52:35 -07:00
gradlew [ci skip] Bump paperweight to 1.1.11, update Gradle wrapper script (#6421) 2021-08-18 13:34:52 -05:00
gradlew.bat gradlew.bat crlf fix (#5810) 2021-06-12 22:34:05 +01:00
settings.gradle.kts lowercase root project name as well 2021-11-30 19:26:33 +01:00
todo.txt Add dropped hunk from mid-tick tasks (#7034) 2021-12-05 13:58:01 -08:00

README.md

Paper Paper Build Status Discord GitHub Sponsors Open Collective

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>io.papermc.paper</groupId>
    <artifactId>paper-api</artifactId>
    <version>1.18.2-R0.1-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>

Or alternatively, with Gradle:

  • Repository:
repositories {
    maven {
        url = uri("https://papermc.io/repo/repository/maven-public/")
    }
}

dependencies {
    compileOnly("io.papermc.paper:paper-api:1.18.2-R0.1-SNAPSHOT")
}

java {
    toolchain.languageVersion.set(JavaLanguageVersion.of(17))
}

How To (Compiling Jar From Source)

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

Clone this repo, run ./gradlew applyPatches, then ./gradlew createReobfBundlerJar from your terminal. You can find the compiled jar in the project root's build/libs directory.

To get a full list of tasks, run ./gradlew tasks.

How To (Pull Request)

See Contributing

Support Us

First of all, thank you for considering helping out, we really appreciate that!

PaperMC has various recurring expenses, mostly related to infrastructure. Paper uses Open Collective via the Open Source Collective fiscal host to manage expenses. Open Collective allows us to be extremely transparent, so you can always see how your donations are used. You can read more about finanically supporting PaperMC on our website.

You can find our collective here, or you can donate via GitHub Sponsors here, which will also go towards the collective.

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.

JetBrains, creators of the IntelliJ IDEA, supports Paper with one of their Open Source Licenses. IntelliJ IDEA is the recommended IDE for working with Paper, and most of the Paper team uses it.

All our sponsors!
Sponsor Image