PaperMC/README.md

85 lines
3.4 KiB
Markdown
Raw Normal View History

Paper ![GitHub Workflow Status (branch)](https://img.shields.io/github/workflow/status/PaperMC/Paper/Build%20Paper/master) ![Read the Docs (version)](https://img.shields.io/readthedocs/paper/latest) ![version](https://img.shields.io/badge/version-1.17.1-9fc) ![Sonatype Nexus (Query Options)](https://img.shields.io/nexus/maven-snapshots/io.papermc.paper/paper-api?label=repo&server=https%3A%2F%2Fpapermc.io%2Frepo)
[![Discord](https://img.shields.io/discord/289587909051416579.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/papermc)
===========
2014-07-04 22:34:50 +02:00
High performance Spigot fork that aims to fix gameplay and mechanics inconsistencies.
2014-08-19 20:56:57 +02:00
2013-06-16 21:45:21 +02:00
**Support and Project Discussion:**
- [IRC](https://webchat.esper.net/?channels=paper) or [Discord](https://discord.gg/papermc)
2014-08-19 20:56:57 +02:00
2016-01-26 19:53:16 +01:00
How To (Server Admins)
2014-11-29 22:12:04 +01:00
------
2016-03-29 05:59:04 +02:00
Paperclip is a jar file that you can download and run just like a normal jar file.
Download Paper from our [downloads page](https://papermc.io/downloads).
2014-08-19 20:56:57 +02:00
Run the Paperclip jar directly from your server. Just like old times
2013-06-16 21:45:21 +02:00
* Documentation on using Paper: [paper.readthedocs.io](https://paper.readthedocs.io/)
* For a sneak peak on upcoming features, [see here](https://github.com/PaperMC/Paper/projects)
How To (Plugin Developers)
------
* See our API patches [here](patches/api)
* See upcoming, pending, and recently added API [here](https://github.com/PaperMC/Paper/projects/6)
* Paper API javadocs here: [papermc.io/javadocs](https://papermc.io/javadocs/)
* Maven Repo (for paper-api):
```xml
<repository>
<id>papermc</id>
<url>https://papermc.io/repo/repository/maven-public/</url>
</repository>
```
* Artifact Information:
```xml
<dependency>
2021-06-19 21:03:18 +02:00
<groupId>io.papermc.paper</groupId>
<artifactId>paper-api</artifactId>
<version>1.17.1-R0.1-SNAPSHOT</version>
<scope>provided</scope>
2020-07-02 23:44:14 +02:00
</dependency>
```
2016-01-26 19:53:16 +01:00
**Or alternatively, with Gradle:**
* Repository:
```groovy
repositories {
maven {
url 'https://papermc.io/repo/repository/maven-public/'
}
}
```
* Artifact:
```groovy
dependencies {
compileOnly 'io.papermc.paper:paper-api:1.17.1-R0.1-SNAPSHOT'
}
```
2016-03-29 05:59:04 +02:00
How To (Compiling Jar From Source)
2016-01-26 19:53:16 +01:00
------
2021-06-19 21:03:18 +02:00
To compile Paper, you need JDK 16 and an internet connection.
2016-01-26 19:53:16 +01:00
2021-06-19 21:03:18 +02:00
Clone this repo, run `./gradlew applyPatches`, then `./gradlew reobfJar` from your terminal. You can find the compiled jar in the `Paper-Server/build/libs` directory.
To get a full list of tasks, run `./gradlew tasks`.
2016-01-26 19:53:16 +01:00
2016-03-29 05:59:04 +02:00
How To (Pull Request)
------
2016-03-29 06:07:27 +02:00
See [Contributing](CONTRIBUTING.md)
2016-03-29 05:59:04 +02:00
2016-01-26 19:53:16 +01:00
Special Thanks To:
-------------
[![YourKit-Logo](https://www.yourkit.com/images/yklogo.png)](https://www.yourkit.com/)
2016-01-26 19:53:16 +01:00
[YourKit](https://www.yourkit.com/), makers of the outstanding java profiler, support open source projects of all kinds with their full featured [Java](https://www.yourkit.com/java/profiler) and [.NET](https://www.yourkit.com/.net/profiler) application profilers. We thank them for granting Paper an OSS license so that we can make our software the best it can be.
[<img src="https://user-images.githubusercontent.com/21148213/121807008-8ffc6700-cc52-11eb-96a7-2f6f260f8fda.png" alt="" width="150">](https://www.jetbrains.com)
[JetBrains](https://www.jetbrains.com/), creators of the IntelliJ IDEA, supports Paper with one of their [Open Source Licenses](https://www.jetbrains.com/opensource/). IntelliJ IDEA is the recommended IDE for working with Paper, and most of the Paper team uses it.