Implementation of a ViaVersion based protocol translator platform
Go to file
2023-06-18 15:31:28 +02:00
.github Initial commit 2023-01-04 01:01:32 +01:00
.idea/copyright Added copyright headers 2023-01-11 20:52:23 +01:00
gradle/wrapper Initial commit 2023-01-04 01:01:32 +01:00
src/main/java/net/raphimc/vialoader Bump version to 2.2.8-SNAPSHOT 2023-06-18 15:31:28 +02:00
.gitattributes Initial commit 2023-01-04 01:01:32 +01:00
.gitignore Added copyright headers 2023-01-11 20:52:23 +01:00
build.gradle Bump version to 2.2.8-SNAPSHOT 2023-06-18 15:31:28 +02:00
gradle.properties Bump version to 2.2.8-SNAPSHOT 2023-06-18 15:31:28 +02:00
gradlew Initial commit 2023-01-04 01:01:32 +01:00
gradlew.bat Initial commit 2023-01-04 01:01:32 +01:00
LICENSE Initial commit 2023-01-04 00:12:41 +01:00
README.md Release 2.2.6 2023-06-09 12:16:10 +02:00
settings.gradle Renamed project to ViaLoader 2023-05-28 19:19:59 +02:00

ViaLoader

Easy to use ViaVersion, (and optional ViaBackwards, ViaRewind, ViaLegacy and ViaAprilFools) platform implementation.

ViaLoader is not usable by itself as a standalone software, as it is an implementation of a ViaVersion platform.

Projects implementing ViaLoader

  • ViaProxy: Standalone proxy which allows players to join EVERY Minecraft server version (Classic, Alpha, Beta, Release, Bedrock).
  • ViaForge: Clientside ViaVersion, ViaBackwards and ViaRewind implementation for Forge.
  • ViaFabricPlus: Fabric mod to connect to EVERY Minecraft server version (Release, Beta, Alpha, Classic, Snapshots, Bedrock) with QoL fixes to the gameplay.

Releases

Gradle/Maven

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

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

dependencies {
    implementation("net.raphimc:ViaLoader:2.2.5-SNAPSHOT") // 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>ViaLoader</artifactId>
        <version>2.2.5</version> <!-- Get latest version from releases -->
    </dependency>
</dependencies>

Jar File

If you just want the latest jar file you can download it from this Jenkins.

Usage

To use ViaLoader in your project you need to decide what components of Via* you want to use. ViaLoader is split into 5 different components:

  • ViaVersion (Is the base component of ViaLoader [required])
  • ViaBackwards (Allows older clients to join to newer server versions [needs ViaVersion])
  • ViaRewind (Allows 1.8.x and 1.7.x clients to join to 1.9+ servers [needs ViaBackwards])
  • ViaLegacy (Allows clients to join to <= 1.7.10 servers [needs ViaVersion])
  • ViaAprilFools (Allows clients to join to some notable Minecraft snapshots [needs ViaBackwards])

To include the subcomponents you have to add the ViaVersion maven repository to your build script:

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

Here is an example dependency configuration for all components:

implementation "com.viaversion:viaversion:4.7.1-SNAPSHOT"
implementation("com.viaversion:viabackwards-common:4.7.0") {
    exclude group: "com.viaversion", module: "viaversion" // Exclude transitive dependency. Include manually for more control
    exclude group: "io.netty", module: "netty-all" // Don't include the outdated netty version
}
implementation "com.viaversion:viarewind-core:2.0.4-SNAPSHOT"
implementation "net.raphimc:ViaLegacy:2.2.17"
implementation "net.raphimc:ViaAprilFools:2.0.7"

Implementation

To implement ViaLoader into your project you need to initialize the Via* platforms first.
ViaLoader provides a wrapper class with default values for that. To use a default value you can just pass null to that argument. If you want to change the default value you should create your own class which extends the base class and overrides the methods you want to change.

The only default value you have to change is the VLLoader argument. The loader is used to register all the providers for the Via* platforms.
To override the default you first create a new class which extends VLLoader and overrides the load method (Make sure to call the super method).
Within the load method you have to register a VersionProvider implementation which will be used to determine the target server version of a given connection. Here is an example implementation:

Via.getManager().getProviders().use(VersionProvider.class, new BaseVersionProvider() {
    @Override
    public int getClosestServerProtocol(UserConnection connection) {
            return ProtocolVersion.v1_8.getVersion(); // Change the logic here to select the target server version
    }
});

Then you have to create a new instance of your loader class and pass it to the ViaLoader.init call.

To do this you can call the ViaLoader.init() method somewhere suitable in your project (You can do that async) with your desired argument values:

ViaLoader.init(null/*ViaPlatform*/, new CustomVLLoaderImpl(), null/*ViaInjector*/, null/*ViaCommandHandler*/, ViaBackwardsPlatformImpl::new, ViaLegacyPlatformImpl::new, ViaAprilFoolsPlatformImpl::new);

After you have initialized the Via* platforms you can start implementing ViaLoader into your project.

The most important part is the modification of your netty pipeline. This is needed for ViaVersion to translate the packets in both ways. Here is an example implementation:

final UserConnection user = new UserConnectionImpl(channel, true);
new ProtocolPipelineImpl(user);

channel.pipeline().addBefore("packet_codec", VLPipeline.VIA_CODEC_NAME, new ViaCodec(user));

If you are using ViaLegacy, you should read its README to see what changes you need to make to the netty pipeline for it to work. Depending on where you are implementing ViaLoader you might need to ensure that the pipeline is held in the correct order. Minecraft clients modify the pipeline order when adding the compression handlers. You have to ensure that the Via* handlers are always on their correct location.

Now you should have a working protocol translator implementation in your project.

Configuring the protocol translation

To change the protocol translation settings/features you can look into the ViaLoader folder. You can find 5 config files there depending on the platforms loaded:

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

Contact

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