mirror of
https://github.com/YatopiaMC/Yatopia.git
synced 2024-09-29 23:57:45 +02:00
b774a5d8a8
Upstream/An Sidestream has released updates that appears to apply and compile correctly This update has NOT been tested by YatopiaMC and as with ANY update, please do your own testing. Purpur Changes: 5cff60d Toggle for water sensitive mobs getting damaged by... water (#161) AirplaneLite Changes: 1b11269 This works, last time f763e5b Keep one patch ca87ae0 Keep empty API directory 53d0334 Rebrand as "Airplane" 1e153e0 Merge pull request #3 from DeadSteve51/patch-1 0829860 Remove actions links 12cc4d7 Adds more info to the README, mostly from the Discord a78a63c Add new downloads URL 2a05c35 Force workflow run
132 lines
4.3 KiB
Markdown
132 lines
4.3 KiB
Markdown
<img width="200" src="https://yatopiamc.org/static/img/yatopia-shiny.gif" alt="Yatopia" align="right">
|
|
<div align="left">
|
|
<h1>Yatopia</h1>
|
|
|
|
[](https://github.com/YatopiaMC/Yatopia/actions?query=workflow%3ACI)
|
|
[](https://ci.codemc.io/job/YatopiaMC/job/Yatopia/job/ver%252F1.16.5/)
|
|
[](https://discord.io/YatopiaMC)
|
|
[](https://api.yatopiamc.org/v2/latestBuild?branch=ver/1.16.5)
|
|
<h3>Blazing fast <a href="https://github.com/Spottedleaf/Tuinity">Tuinity</a> fork with best in class performance.</h3>
|
|
</div>
|
|
|
|
## So what is Yatopia?
|
|
Yatopia combines the code from many [Paper](https://github.com/PaperMC/Paper) forks and optimization mods, as well as many unique optimizations. We borrow code from the following repos:
|
|
|
|
* [Akarin](https://github.com/Akarin-project/Akarin)
|
|
* [EMC](https://github.com/starlis/empirecraft)
|
|
* [Lithium](https://github.com/jellysquid3/lithium-fabric)
|
|
* [Origami](https://github.com/Minebench/Origami)
|
|
* [Purpur](https://github.com/pl3xgaming/Purpur)
|
|
* [Airplane](https://github.com/Technove/Airplane)
|
|
* [Hydrogen](https://github.com/jellysquid3/hydrogen-fabric)
|
|
* [Krypton](https://github.com/astei/krypton)
|
|
|
|
|
|
## Try it out
|
|
The latest stable builds of Yatopia are always available over at our [downloads page](https://yatopiamc.org/download.html). You can also download the latest development build [here](https://api.yatopiamc.org/v2/latestBuild/download?branch=ver/1.16.5).
|
|
|
|
## Documentation
|
|
|
|
You can find a full explanation of the Yatopia configuration file on the [wiki](https://github.com/YatopiaMC/Yatopia/wiki). Check out the list of patches included in this project and who created them [here](PATCHES.md).
|
|
|
|
## Building and setting up
|
|
|
|
Run the following commands in the root directory:
|
|
|
|
```shell
|
|
./gradlew initGitSubmodules
|
|
./gradlew setupUpstream
|
|
./gradlew applyPatches
|
|
./gradlew paperclip
|
|
```
|
|
|
|
|
|
## Using Yatopia-API
|
|
|
|
To build your plugin against the Yatopia-API, first add the CodeMC maven repository:
|
|
|
|
# Maven
|
|
Add the CodeMC Repo:
|
|
```xml
|
|
<repositories>
|
|
<repository>
|
|
<id>codemc-repo</id>
|
|
<url>https://repo.codemc.io/repository/maven-public/</url>
|
|
</repository>
|
|
</repositories>
|
|
```
|
|
|
|
And then add the Yatopia-API dependency:
|
|
```xml
|
|
<dependencies>
|
|
<dependency>
|
|
<groupId>org.yatopiamc</groupId>
|
|
<artifactId>yatopia-api</artifactId>
|
|
<version>1.16.5-R0.1-SNAPSHOT</version>
|
|
<scope>provided</scope>
|
|
</dependency>
|
|
</dependencies>
|
|
```
|
|
|
|
# Gradle
|
|
|
|
> Groovy DSL
|
|
|
|
Add the CodeMC Repo:
|
|
```groovy
|
|
repositories {
|
|
maven {
|
|
url 'https://repo.codemc.io/repository/maven-public/'
|
|
}
|
|
}
|
|
```
|
|
|
|
And then add the Yatopia-API dependency:
|
|
```groovy
|
|
dependencies {
|
|
compileOnly 'org.yatopiamc:yatopia-api:1.16.5-R0.1-SNAPSHOT'
|
|
}
|
|
```
|
|
|
|
> Kotlin DSL
|
|
|
|
Add the CodeMC Repo:
|
|
```kotlin
|
|
repositories {
|
|
maven("https://repo.codemc.io/repository/maven-public/")
|
|
}
|
|
```
|
|
|
|
And then add the Yatopia-API dependency:
|
|
```kotlin
|
|
dependencies {
|
|
compileOnly("org.yatopiamc:yatopia-api:1.16.5-R0.1-SNAPSHOT")
|
|
}
|
|
```
|
|
|
|
## Why aren't there many API additions?
|
|
|
|
(Modified from [starlis/empirecraft](https://github.com/starlis/empirecraft/))
|
|
<p>
|
|
APIs are tough to design. In projects such as Bukkit, Spigot, Sponge, Paper, etc once an API is commited, it's almost forever. You can't go breaking it without solid justification. This is the politics game.
|
|
|
|
With that in mind, much thought has to be given to the API in now and future use cases and applications to ensure it can be extended without breaking.
|
|
|
|
This is a lot of politics that we don't have time in our lives to deal with.
|
|
|
|
That being said we make light API additions when requested.
|
|
</p>
|
|
|
|
## License
|
|
|
|
License information can be found [here](../Licensing/LICENSE.md).
|
|
|
|
## Security
|
|
|
|
Security information can be found found [here](../SECURITY.md).
|
|
|
|
## Statistics
|
|
[](https://bstats.org/plugin/server-implementation/Yatopia)
|
|
|
|
Made with <span style="color: #e25555;">♥</span> on Earth.
|