2018-07-25 08:17:56 +08:00
|
|
|
# Velocity
|
|
|
|
|
|
2021-09-01 17:03:49 +08:00
|
|
|
[](https://ci.velocitypowered.com/job/velocity-3.0.0/)
|
2021-11-19 02:49:54 +08:00
|
|
|
[](https://discord.gg/papermc)
|
2018-08-01 03:03:13 +08:00
|
|
|
|
2018-09-21 04:58:38 +08:00
|
|
|
A Minecraft server proxy with unparalleled server support, scalability,
|
|
|
|
|
and flexibility.
|
2018-08-27 11:42:01 +08:00
|
|
|
|
2021-04-01 08:36:08 +08:00
|
|
|
Velocity is licensed under the GPLv3 license.
|
2018-07-25 08:17:56 +08:00
|
|
|
|
|
|
|
|
## Goals
|
|
|
|
|
|
2018-08-27 11:42:01 +08:00
|
|
|
* A codebase that is easy to dive into and consistently follows best practices
|
|
|
|
|
for Java projects as much as reasonably possible.
|
2018-07-25 08:17:56 +08:00
|
|
|
* High performance: handle thousands of players on one proxy.
|
2018-08-27 11:42:01 +08:00
|
|
|
* A new, refreshing API built from the ground up to be flexible and powerful
|
|
|
|
|
whilst avoiding design mistakes and suboptimal designs from other proxies.
|
2018-07-27 02:02:13 +08:00
|
|
|
* First-class support for Paper, Sponge, and Forge. (Other implementations
|
|
|
|
|
may work, but we make every endeavor to support these server implementations
|
|
|
|
|
specifically.)
|
2018-08-01 03:48:52 +08:00
|
|
|
|
|
|
|
|
## Building
|
|
|
|
|
|
|
|
|
|
Velocity is built with [Gradle](https://gradle.org). We recommend using the
|
|
|
|
|
wrapper script (`./gradlew`) as our CI builds using it.
|
|
|
|
|
|
|
|
|
|
It is sufficient to run `./gradlew build` to run the full build cycle.
|
2018-07-25 08:17:56 +08:00
|
|
|
|
2018-08-07 21:34:31 +08:00
|
|
|
## Running
|
|
|
|
|
|
|
|
|
|
Once you've built Velocity, you can copy and run the `-all` JAR from
|
|
|
|
|
`proxy/build/libs`. Velocity will generate a default configuration file
|
|
|
|
|
and you can configure it from there.
|
|
|
|
|
|
2022-03-07 02:20:44 +08:00
|
|
|
Alternatively, you can get the proxy JAR from the [downloads](https://papermc.io/downloads#Velocity)
|
2021-04-01 08:36:08 +08:00
|
|
|
page.
|
