mirror of
https://github.com/ViaVersion/ViaProxy.git
synced 2024-11-25 12:25:41 +01:00
Updated README
This commit is contained in:
parent
e7dba42792
commit
b91b3f3b2b
53
README.md
53
README.md
@ -1,5 +1,10 @@
|
|||||||
# ViaProxy
|
# ViaProxy
|
||||||
Standalone proxy which uses ViaVersion to translate between minecraft versions.
|
Standalone proxy which uses ViaVersion to translate the protocol between minecraft versions.
|
||||||
|
|
||||||
|
ViaProxy allows you to join to essentially any minecraft version server from a modern client.
|
||||||
|
To download the latest version, go to the [Releases section](#executable-jar-file) and download the latest version.
|
||||||
|
Using it is very simple, just run the jar file, and it will start an user interface where everything can be configured.
|
||||||
|
For a full user guide go to the [Usage for Players](#usage-for-players) section or the [Usage for Server Owners](#usage-for-server-owners) section.
|
||||||
|
|
||||||
## Supported Server versions
|
## Supported Server versions
|
||||||
- Classic (c0.0.15 - c0.30 including [CPE](https://wiki.vg/Classic_Protocol_Extension))
|
- Classic (c0.0.15 - c0.30 including [CPE](https://wiki.vg/Classic_Protocol_Extension))
|
||||||
@ -11,15 +16,51 @@ Standalone proxy which uses ViaVersion to translate between minecraft versions.
|
|||||||
|
|
||||||
## Supported Client versions
|
## Supported Client versions
|
||||||
- Release (1.7.2 - 1.19.3)
|
- Release (1.7.2 - 1.19.3)
|
||||||
- April Fools (3D Shareware)
|
|
||||||
|
|
||||||
## Releases
|
## Releases
|
||||||
|
### Executable Jar File
|
||||||
|
If you want the executable jar file you can download a stable release from [GitHub](https://github.com/RaphiMC/ViaProxy/releases/latest) or the latest version from this [Jenkins](https://build.lenni0451.net/job/ViaProxy/).
|
||||||
|
|
||||||
### Gradle/Maven
|
### Gradle/Maven
|
||||||
To use ViaProxy with Gradle/Maven you can use this [Maven server](https://maven.lenni0451.net/#/releases/net/raphimc/ViaProxy) or [Jitpack](https://jitpack.io/#RaphiMC/ViaProxy).
|
To use ViaProxy with Gradle/Maven you can use this [Maven server](https://maven.lenni0451.net/#/releases/net/raphimc/ViaProxy) or [Jitpack](https://jitpack.io/#RaphiMC/ViaProxy).
|
||||||
You can also find instructions how to implement it into your build script there.
|
You can also find instructions how to implement it into your build script there.
|
||||||
|
|
||||||
### Jar File
|
## Usage for Players (GUI)
|
||||||
If you just want the latest jar file you can download it from this [Jenkins](https://build.lenni0451.net/job/ViaProxy/).
|
![ViaProxy GUI](https://i.imgur.com/N2JCvEp.png)
|
||||||
|
1. Download the latest version from the [Releases section](#executable-jar-file)
|
||||||
|
2. Put the jar file into a folder (ViaProxy will generate config files and store some data there)
|
||||||
|
3. Run the jar file
|
||||||
|
4. Fill in the required fields like server address and version
|
||||||
|
5. Click on "Start"
|
||||||
|
6. Join with your minecraft client on the displayed address
|
||||||
|
7. Have fun!
|
||||||
|
|
||||||
## Usage
|
## Usage for Server owners (CLI)
|
||||||
TODO
|
1. Download the latest version from the [Releases section](#executable-jar-file)
|
||||||
|
2. Put the jar file into a folder (ViaProxy will generate config files and store some data there)
|
||||||
|
3. Run the jar file (Using java -jar ViaProxy-whateverversion.jar --help)
|
||||||
|
4. Look at the available config options and use those you need just like you would in the GUI
|
||||||
|
5. Start the proxy using the start command and test whether it works (Join using the server's public address and the bind port you configured)
|
||||||
|
6. Have fun!
|
||||||
|
|
||||||
|
Here is an example command to allow players to join on yourserverip:25568 and connect to a beta 1.7.3 server running on port 25565:
|
||||||
|
``java -jar ViaProxy-whateverversion.jar --bind_port 25568 --target_ip 127.0.0.1 --target_port 25565 --version b1.7-b1.7.3``
|
||||||
|
|
||||||
|
## Advanced Usage
|
||||||
|
### Online Mode
|
||||||
|
If you want to join online mode servers you need to install the [OpenAuthMod](https://modrinth.com/mod/openauthmod) mod.
|
||||||
|
When you have the mod installed and select "OpenAuthMod" as authentication type in the GUI / CLI.
|
||||||
|
|
||||||
|
### Configuring the protocol translation
|
||||||
|
To change the protocol translation settings/features you can look into the ViaProtocolHack folder.
|
||||||
|
You will find 4 config files there:
|
||||||
|
- viaversion.yml (ViaVersion)
|
||||||
|
- config.yml (ViaBackwards)
|
||||||
|
- viarewind.yml (ViaRewind)
|
||||||
|
- vialegacy.yml (ViaLegacy)
|
||||||
|
|
||||||
|
## Contact
|
||||||
|
If you encounter any issues, please report them on the
|
||||||
|
[issue tracker](https://github.com/RaphiMC/ViaProxy/issues).
|
||||||
|
If you just want to talk or need help using ViaProxy feel free to join my
|
||||||
|
[Discord](https://discord.gg/dCzT9XHEWu).
|
Loading…
Reference in New Issue
Block a user