Standalone proxy which allows players to join EVERY Minecraft server version (Classic, Alpha, Beta, Release, Bedrock)
Go to file
2023-10-17 06:24:36 +00:00
.github Initial commit 2023-01-04 20:58:09 +01:00
.idea/copyright Added copyright headers 2023-01-11 20:46:23 +01:00
gradle/wrapper Migrated project to Java 17 and use JavaDowngrader gradle plugin to target Java 8 2023-09-04 19:36:24 +02:00
src/main Added the ability to use microsoft accounts in CLI 2023-10-16 19:47:59 +02:00
.gitattributes Initial commit 2023-01-04 20:58:09 +01:00
.gitignore Added copyright headers 2023-01-11 20:46:23 +01:00
build.gradle Bump org.apache.logging.log4j:log4j-core from 2.20.0 to 2.21.0 2023-10-17 06:24:31 +00:00
gradle.properties Bump version to 3.0.22-SNAPSHOT 2023-09-21 19:39:10 +02:00
gradlew Initial commit 2023-01-04 20:58:09 +01:00
gradlew.bat Initial commit 2023-01-04 20:58:09 +01:00
LICENSE Initial commit 2023-01-04 00:09:15 +01:00
README.md Bump version to 3.0.22-SNAPSHOT 2023-09-21 19:39:10 +02:00
settings.gradle Updated JavaDowngrader build script usage 2023-10-14 16:35:38 +02:00

ViaProxy

Standalone proxy which allows players to join EVERY Minecraft server version (Classic, Alpha, Beta, Release, Bedrock)

To download the latest version, go to the Releases section and download the latest version.
Using it is very simple, just run the jar file, and it will start a user interface where everything can be configured.
For a full user guide go to the Usage for Players section or the Usage for Server Owners section.

Supported Server versions

  • Classic (c0.0.15 - c0.30 including CPE)
  • Alpha (a1.0.15 - a1.2.6)
  • Beta (b1.0 - b1.8.1)
  • Release (1.0.0 - 1.20.2)
  • April Fools (3D Shareware, 20w14infinite)
  • Combat Snapshots (Combat Test 8c)
  • Bedrock Edition 1.20.30 (In development)

Supported Client versions

  • Release (1.7.2 - 1.20.2)
  • Bedrock Edition (Needs the Geyser plugin)
  • Classic, Alpha, Beta, Release 1.0 - 1.6.4 (Only passthrough)

ViaProxy supports joining to any of the listed server version from any of the listed client versions.

Special Features

  • Support for joining online mode servers
  • Support for joining on servers which have chat signing enabled from all listed client versions.

Releases

Executable Jar File

If you want the executable jar file you can download a stable release from GitHub or the latest dev version from this Jenkins.

Gradle/Maven

To use ViaProxy with Gradle/Maven you can use the ViaVersion maven server:

repositories {
    maven { url "https://repo.viaversion.com" }
}

dependencies {
    implementation("net.raphimc:ViaProxy:3.0.19") // Get latest version from releases
}
<repositories>
    <repository>
        <id>viaversion</id>
        <url>https://repo.viaversion.com</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>net.raphimc</groupId>
        <artifactId>ViaProxy</artifactId>
        <version>3.0.19</version> <!-- Get latest version from releases -->
    </dependency>
</dependencies>

Usage for Players (GUI)

ViaProxy GUI

  1. Download the latest version from the Releases section
  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 for Server owners (CLI)

  1. Download the latest version from the Releases section
  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

Configuring the protocol translation

To change the protocol translation settings/features you can look into the ViaProtocolHack folder. You will find 5 config files there:

  • viaversion.yml (ViaVersion)
  • config.yml (ViaBackwards)
  • viarewind.yml (ViaRewind)
  • vialegacy.yml (ViaLegacy)
  • viabedrock.yml (ViaBedrock)

Developer Plugin API

ViaProxy has a plugin API which allows you to create plugins for ViaProxy.
Documentation and examples:

Contributing

Contributions in the form of pull requests are always welcome. Please make sure to keep your code style consistent with the rest of the project and that your code is easily maintainable. If you plan to make a large scale changes, please open an issue first or join my discord to discuss it.

Translations

If you want to help translating ViaProxy you can do so by creating a pull request with your language file. The language files are located in the language folder. You can find the guidelines for creating a language file in the en_US language file.

Contact

If you encounter any issues, please report them on the issue tracker.
If you just want to talk or need help using ViaProxy feel free to join the ViaVersion Discord.