From 00508729505f47c0e88e496390434915b184d85c Mon Sep 17 00:00:00 2001 From: Nassim Jahnke Date: Fri, 11 Aug 2023 21:06:10 +1000 Subject: [PATCH] Update README --- README.md | 71 +++++++++++++++++++++++++++++-------------------------- 1 file changed, 38 insertions(+), 33 deletions(-) diff --git a/README.md b/README.md index 3c223f7d1..5755e4d0c 100644 --- a/README.md +++ b/README.md @@ -1,61 +1,49 @@ -# ViaVersion - Spigot, Sponge, BungeeCord, Velocity +# ViaVersion [![Latest Release](https://img.shields.io/github/v/release/ViaVersion/ViaVersion)](https://viaversion.com) [![Build Status](https://github.com/ViaVersion/ViaVersion/actions/workflows/gradle.yml/badge.svg?branch=master)](https://github.com/ViaVersion/ViaVersion/actions) [![Discord](https://img.shields.io/badge/chat-on%20discord-blue.svg)](https://viaversion.com/discord) -**Allows the connection of higher client versions to lower server versions** +**Allows the connection of higher client versions to lower server versions - +it works on any platform you can think of.** + +The base ViaVersion jar runs on Paper, Velocity, Bungee, and Sponge. We also have projects integrating ViaVersion to run +on Fabric, Forge, or as a standalone proxy to join from basically any client version on any server version from the +past decade. **See [HERE](https://github.com/ViaVersion) for an overview of the different Via\* projects.** Supported Versions: ![Table (https://i.imgur.com/sTrVnC2.png)](https://i.imgur.com/sTrVnC2.png) -On Paper you may also use ProtocolSupport, but ensure you have the right build for your server version. - **User Docs:** https://docs.viaversion.com/display/VIAVERSION/ -Sources +Releases/Dev Builds -------- -**[OpenNBT](https://github.com/ViaVersion/OpenNBT)** +You can find official releases in the following places: -**[Via Mappings Generator](https://github.com/ViaVersion/Mappings)** +- **Hangar (for our plugins)**: https://hangar.papermc.io/ViaVersion/ViaVersion +- **Modrinth (for our mods)**: https://modrinth.com/mod/viaversion +- **GitHub**: https://github.com/ViaVersion/ViaVersion/releases -**[Mojang mappings](https://minecraft.fandom.com/wiki/Obfuscation_map)** (Thank you, Mojang, very cool) +Dev builds for **all** of our projects are on our Jenkins server: -**[wiki.vg](https://wiki.vg)** (Used for historic information regarding packet structure, we also contribute back) - -**[Burger](https://github.com/Pokechu22/Burger)** (See [PAaaS](https://github.com/Matsv/Paaas)) - - - -Releases / Dev Builds --------- -You can find official releases here: - -https://www.spigotmc.org/resources/viaversion.19254/history +- **Jenkins**: https://ci.viaversion.com +ViaVersion as a Dependency ---------- -You can find official dev builds here: - -**Jenkins:** https://ci.viaversion.com - **JavaDocs:** https://jd.viaversion.com -**Maven Repository:** +**Maven:** ```xml - viaversion-repo https://repo.viaversion.com ``` -**API-artifact:** - ```xml - com.viaversion viaversion-api @@ -64,7 +52,17 @@ You can find official dev builds here: ``` -Replace the version depending on your needs. +**Gradle:** + +```kotlin +repositories { + maven("https://repo.viaversion.com") +} + +dependencies { + compileOnly("com.viaversion:viaversion-api:VERSION") // Replace the version +} +``` If you need access to the existing protocol or platform implementations, use the parent artifact `viaversion`. Please note the [differences in licensing](#license). @@ -73,8 +71,7 @@ Please note the [differences in licensing](#license). Building -------- After cloning this repository, build the project with Gradle by running `./gradlew build` and take the created jar out -of -the `build/libs` directory. +of the `build/libs` directory. Mapping Files @@ -82,13 +79,21 @@ Mapping Files Mapping files are generated and managed in our [Mappings repository](https://github.com/ViaVersion/Mappings). +Resources +-------- + +- **[Via Mappings Generator](https://github.com/ViaVersion/Mappings)** +- **[Mojang mappings](https://minecraft.fandom.com/wiki/Obfuscation_map)** (Thank you, Mojang, very cool) +- **[wiki.vg](https://wiki.vg)** (Used for historic information regarding packet structure, we also contribute back) +- **[Burger](https://github.com/Pokechu22/Burger)** (See [PAaaS](https://github.com/Matsv/Paaas)) + License -------- The entirety of the [API directory](api) (including the legacy API directory) is licensed under the MIT License; see [licenses/MIT.md](licenses/MIT.md) for details. -Everything else, unless explicitly stated otherwise, is licensed under the GNU General Public License, including the end -product as a whole; see [licenses/GPL.md](licenses/GPL.md) for details. +Everything else, unless explicitly stated otherwise, is licensed under the GNU General Public License v3, including the +end-product as a whole; see [licenses/GPL.md](licenses/GPL.md) for details. Special thanks to all our [Contributors](https://github.com/ViaVersion/ViaVersion/graphs/contributors).