Waterfall/README.md

82 lines
2.9 KiB
Markdown
Raw Normal View History

2021-01-06 15:21:09 +01:00
Waterfall
2016-12-09 19:51:02 +01:00
=========
Waterfall is a fork of the well-known [BungeeCord](https://github.com/SpigotMC/BungeeCord) server teleportation suite.
Waterfall focuses on three main areas:
2016-12-09 19:51:02 +01:00
- **Stability**: Waterfall aims to be stable. We will achieve this through making the code base testable and discouraging practices that lead to proxy lag.
- **Features**: Waterfall aims to include more features than canonical BungeeCord.
- **Scalability**: Waterfall should be able to handle a large number of concurrent players, given a reasonably modern CPU, memory, and good network connection.
## Why fork BungeeCord?
Think of Waterfall as a principles fork.
Waterfall was forked because of the fact that upstream does not accept many contributions that are intended to better the ecosystem. Simply put, Waterfall aims to better
the ecosystem by allowing changes to be exposed to a wider audience more quickly.
Waterfall will still track upstream BungeeCord and merge changes as needed.
2016-12-09 19:51:02 +01:00
## How To (Server Admins)
2021-01-06 15:21:09 +01:00
Download a copy of Waterfall.jar from our homepage here: [Waterfall](https://papermc.io/downloads#Waterfall)
2016-06-30 00:42:20 +02:00
Waterfall requires **Java 8** or above.
## How To (Plugin Developers)
------
* See our API patches [here](BungeeCord-Patches)
* Waterfall API JavaDocs here: [papermc.io/javadocs/waterfall](https://papermc.io/javadocs/waterfall)
* Maven repository (for `waterfall-api`):
```xml
<repository>
<id>papermc</id>
<url>https://papermc.io/repo/repository/maven-public/</url>
</repository>
```
* Artifact information:
```xml
<dependency>
<groupId>io.github.waterfallmc</groupId>
<artifactId>waterfall-api</artifactId>
2021-06-09 10:25:10 +02:00
<version>1.17-R0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
```
**Or alternatively, with Gradle:**
* Repository:
```groovy
repositories {
maven {
url 'https://papermc.io/repo/repository/maven-public/'
}
}
```
* Artifact:
```groovy
dependencies {
2021-06-09 10:25:10 +02:00
compileOnly 'io.github.waterfallmc:waterfall-api:1.17-R0.1-SNAPSHOT'
}
```
2016-12-09 19:51:02 +01:00
## How To (Compiling From Source)
2016-06-30 00:42:20 +02:00
To compile Waterfall, you need JDK8, git, bash, maven, and an internet connection.
2016-11-26 22:33:41 +01:00
Clone this repo, run `./waterfall b` from *bash*, get jar from Waterfall-Proxy/bootstrap/target/
2016-06-30 00:42:20 +02:00
## Join us
* Feel free to open a PR! We accept contributions.
2021-01-13 21:48:18 +01:00
* Join us on IRC (irc.esper.net #waterfall, [webchat](https://webchat.esper.net/?channels=waterfall)) or [Discord](https://discord.gg/papermc).
2018-10-29 06:48:18 +01:00
* Visit our forums (https://papermc.io/forums).
2016-12-09 19:51:02 +01:00
## Special Thanks To
![YourKit-Logo](https://yourkit.com/images/yklogo.png)
[YourKit](https://yourkit.com/), makers of the outstanding Java profiler, supports open source projects of all kinds with their full-featured [Java](https://yourkit.com/features/) and [.NET](https://yourkit.com/dotnet/features/) application profilers. We thank them for granting Waterfall an OSS license so that we can make our software the best it can be.