Fabric mod to connect to EVERY Minecraft server version (Release, Beta, Alpha, Classic, Snapshots, Bedrock) with QoL fixes to the gameplay
Go to file
2023-03-15 00:47:06 +01:00
.github added Herobrine 2023-03-09 15:02:14 +01:00
gradle/wrapper pushed code 2023-02-19 23:17:33 +01:00
src/main recode again, updated README 2023-03-15 00:47:06 +01:00
.gitignore added git ignore 2023-02-11 16:21:11 +01:00
build.gradle recode again, updated README 2023-03-15 00:47:06 +01:00
gradle.properties recode again, updated README 2023-03-15 00:47:06 +01:00
gradlew pushed code 2023-02-19 23:17:33 +01:00
gradlew.bat pushed code 2023-02-19 23:17:33 +01:00
jitpack.yml added before_install task 2023-02-24 20:40:04 +01:00
LICENSE change license to make the project public 2023-02-23 19:31:46 +01:00
LICENSE_GENERAL_MIT Huge update: 2023-03-05 20:34:51 +01:00
LICENSE_multiconnect change license to make the project public 2023-02-23 19:31:46 +01:00
README.md recode again, updated README 2023-03-15 00:47:06 +01:00
settings.gradle removed ViaFabricPlus-Visual, changed Settings screen 2023-02-26 21:59:01 +01:00

ViaFabricPlus

Clientside ViaVersion, ViaLegacy, ViaBedrock and ViaAprilFools implementation with clientside fixes for Fabric

This project has nothing to do with the original ViaFabric and is therefore also not compact

Contact

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

Basic Features

  • ViaVersion implementation
  • ViaBackwards implementation
  • ViaLegacy implementation
  • ViaAprilFools implementation
  • (Beta) ViaBedrock implementation
  • BetaCraft implementation for MP Pass
  • Bounding boxes for all versions
  • Entity interaction and movement related packet fixes
  • Sync and async mouse/keyboard handling in <= 1.12.2
  • Mining speeds and item attributes
  • Filter item creative tabs for only available items
  • Combat system in <= 1.8
  • Tons of modifications to ViaVersion to make it more legit (Metadata fixes, broken packets, edge-cases)
  • Visual and screen related changes (newer Command Block features, GameMode selection, ...)
  • ViaAprilFools and ViaLegacy extensions to make it more legit
  • Chat signatures (secure login) for all versions (1.19.0, 1.19.1, 1.19.2)
  • Address parsing for all minecraft versions
  • PackFormats and HTTP Header for all resource pack versions
  • Raytrace related fixes in <= 1.8
  • Implementing HUD changes for <= b1.7.3
  • Chat lengths of all versions
  • Implementing non-sequenced block placement in <= 1.18.2
  • Animation related fixes (1.7 Sneaking, c0.30 walking animation, ...)
  • Fixed clientside packet handling (1.16.5 transactions, 1.19.0 tablist, ...)

TODO

  • Bedrock account auth for ViaBedrock
  • ClassiCube implementation for MP Pass
  • BetaCraft server list screen
  • More extensions for Classic Protocol Extensions protocol
  • Window click interactions in <= 1.16.5

Custom classic protocol extensions

  • WeatherType extension (version 1)

Classic protocol commands

To better control the Classic Protocol, there are a few clientside commands, the command prefix is /v:

  • /vhelp - Displays all commands, available from: c0.28-c0.30
  • /vsettime <Time (Long)> - Changes the Clientside World Time, available from: c0.28-c0.30
  • /vlistextensions - Displays all classic protocol extensions, available in: c0.30 CPE

Why?

ViaFabricPlus implements ViaLegacy/ViaAprilFools clientside and adds a ton of fixes that improve the game experience,
as does multiconnect from Earthcomputer.

Important: The focus on ViaFabricPlus is on client side fixes, so reporting bugs and contributing is welcome.

Dependencies

Dependency Download
ViaVersion https://github.com/ViaVersion/ViaVersion
ViaBackwards https://github.com/ViaVersion/ViaBackwards
Snake YAML https://mvnrepository.com/artifact/org.yaml/snakeyaml/1.33
ViaLegacy https://github.com/RaphiMC/ViaLegacy
ViaAprilFools https://github.com/RaphiMC/ViaAprilFools
ViaBedrock https://github.com/RaphiMC/ViaBedrock
MC-Structs https://github.com/Lenni0451/MCStructs
Reflect https://github.com/Lenni0451/Reflect
ViaLoadingBase https://github.com/FlorianMichael/ViaLoadingBase

Setting up a Workspace

ViaFabricPlus uses Gradle, to make sure that it is installed properly you can check Gradle's website.

  1. Clone the repository using git clone https://github.com/FlorianMichael/ViaFabricPlus.
  2. CD into the local repository.
  3. Run ./gradlew genSources.
  4. Open the folder as a Gradle project in your preferred IDE.
  5. Run the mod.

Settings

Settings are optional settings that can turn fixes on and off, originally they were used for debugging

Addons

There is no real addon base, to create addons you can simply use the Fabric system, and then interact with ViaFabricPlus via the EventDispatcher.

public class ViaFabricPlusExampleAddon implements ClientModInitializer {

  @Override
  public void onInitializeClient() {
    ChangeProtocolVersionCallback.EVENT.register(protocolVersion -> {
      System.out.println("Version changed to " + protocolVersion.getName());
    });
  }
}

ViaFabricPlus has 7 events at the moment:

Callback class name Description
ChangeProtocolVersionCallback Called when the user changes the target version in the screen
FinishMinecraftLoadCallback Called when Minecraft is finished with loading all its components
FinishViaLoadingBaseStartupCallback Called when ViaLoadingBase and Via* is loaded and ready to use
InitializeSettingsCallback Called after the default setting groups are loaded and before the setting config is loaded
LoadClassicProtocolExtensionCallback Called when the classic server sends the protocol extensions (only in c0.30 CPE)
PreLoadCallback Called before everything (Pre-pre load)
SkipIdlePacketCallback In case you need an event as soon as the idle packet is skipped in the <= 1.8

General API

In case you need the release version of a material, you can do that:

final ProtocolRange range = ItemReleaseVersionDefinition.INSTANCE.getItemMap().get(Items.WRITABLE_BOOK); // If an item does not appear in the item map, it has always existed

// The Range class then contains all versions in which the item occurs. 
// You can find out how the Range class works in the ViaLoadingBase README.
// https://github.com/FlorianMichael/ViaLoadingBase

To create a setting group, you can simply use the SettingGroup class:

public class ExampleSettingGroup extends SettingGroup {
    public final static ExampleSettingGroup INSTANCE = new ExampleSettingGroup();
    
    public final BooleanSetting test = new BooleanSetting("Test", false);
    
    public ExampleSettingGroup() {
        super("Example");
        ViaFabricPlus.INSTANCE.getSettingsSystem().addGroup(this); // should be in your onLoad method
    }
}

Implementing classic protocol commands:

public class ExampleCommand implements ICommand {

    @Override
    public String name() {
        return "example";
    }

    @Override
    public String description() {
        return null;
    }

    @Override
    public void execute(String[] args) {
    }
}

and then you register the command in your onLoad method:

// addon main [...]

@Override
public void onLoad() {
    ClassicProtocolCommands.commands.add(new ExampleCommand());
}

Implementing custom classic protocol extensions:

public class ExampleExtensionSupport implements ClientModInitializer {

  public static ClientboundPacketsc0_30cpe EXT_CLICK_DISTANCE;

  @Override
  public void onInitializeClient() {
    PreLoadCallback.EVENT.register(() -> {
      CustomClassicProtocolExtensions.allowExtension(ClassicProtocolExtension.CLICK_DISTANCE); // Register extension as supported

      EXT_CLICK_DISTANCE = CustomClassicProtocolExtensions.createNewPacket(ClassicProtocolExtension.CLICK_DISTANCE, 0x12, (user, buf) -> buf.readShort());
    });

    FinishViaLoadingBaseStartupCallback.EVENT.register(() -> {
      Via.getManager().getProtocolManager().getProtocol(Protocolc0_30toc0_30cpe.class).registerClientbound(EXT_CLICK_DISTANCE, null, new PacketHandlers() {
        @Override
        protected void register() {
          handler(wrapper -> {
            wrapper.cancel();
            final short distance = wrapper.read(Type.SHORT);
            // Do your stuff...
          });
        }
      }, true);
    });
  }
}

Alternatives

  • ClientViaVersion: Discontinued 5zig plugin.
  • multiconnect: Fabric mod for connecting to older versions: down to 1.11 (stable) and 1.8 (experimental).
  • ViaFabric: Client-side and server-side ViaVersion implementation for Fabric

WARNING

I cannot guarantee that this mod is allowed on every (or even any) server. This mod may cause problems with anti cheat plugins. USE AT OWN RISK