mirror of
https://github.com/ViaVersion/ViaFabricPlus.git
synced 2024-06-28 10:44:58 +02:00
252 lines
14 KiB
Markdown
252 lines
14 KiB
Markdown
<div align="center">
|
|
<img src="https://raw.githubusercontent.com/FlorianMichael/ViaFabricPlus/main/src/main/resources/assets/viafabricplus/icon.png" width="150">
|
|
<h1>ViaFabricPlus</h1>
|
|
<a href="https://fabricmc.net"><img src="https://img.shields.io/badge/Mod%20Loader-Fabric-lightyellow?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAACXBIWXMAAAsTAAALEwEAmpwYAAAFHGlUWHRYTUw6Y29tLmFkb2JlLnhtcAAAAAAAPD94cGFja2V0IGJlZ2luPSLvu78iIGlkPSJXNU0wTXBDZWhpSHpyZVN6TlRjemtjOWQiPz4gPHg6eG1wbWV0YSB4bWxuczp4PSJhZG9iZTpuczptZXRhLyIgeDp4bXB0az0iQWRvYmUgWE1QIENvcmUgNS42LWMxNDIgNzkuMTYwOTI0LCAyMDE3LzA3LzEzLTAxOjA2OjM5ICAgICAgICAiPiA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPiA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIiB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIgeG1sbnM6cGhvdG9zaG9wPSJodHRwOi8vbnMuYWRvYmUuY29tL3Bob3Rvc2hvcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RFdnQ9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZUV2ZW50IyIgeG1wOkNyZWF0b3JUb29sPSJBZG9iZSBQaG90b3Nob3AgQ0MgMjAxOCAoV2luZG93cykiIHhtcDpDcmVhdGVEYXRlPSIyMDE4LTEyLTE2VDE2OjU0OjE3LTA4OjAwIiB4bXA6TW9kaWZ5RGF0ZT0iMjAxOS0wNy0yOFQyMToxNzo0OC0wNzowMCIgeG1wOk1ldGFkYXRhRGF0ZT0iMjAxOS0wNy0yOFQyMToxNzo0OC0wNzowMCIgZGM6Zm9ybWF0PSJpbWFnZS9wbmciIHBob3Rvc2hvcDpDb2xvck1vZGU9IjMiIHBob3Rvc2hvcDpJQ0NQcm9maWxlPSJzUkdCIElFQzYxOTY2LTIuMSIgeG1wTU06SW5zdGFuY2VJRD0ieG1wLmlpZDowZWRiMWMyYy1mZjhjLWU0NDEtOTMxZi00OTVkNGYxNGM3NjAiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6MGVkYjFjMmMtZmY4Yy1lNDQxLTkzMWYtNDk1ZDRmMTRjNzYwIiB4bXBNTTpPcmlnaW5hbERvY3VtZW50SUQ9InhtcC5kaWQ6MGVkYjFjMmMtZmY4Yy1lNDQxLTkzMWYtNDk1ZDRmMTRjNzYwIj4gPHhtcE1NOkhpc3Rvcnk+IDxyZGY6U2VxPiA8cmRmOmxpIHN0RXZ0OmFjdGlvbj0iY3JlYXRlZCIgc3RFdnQ6aW5zdGFuY2VJRD0ieG1wLmlpZDowZWRiMWMyYy1mZjhjLWU0NDEtOTMxZi00OTVkNGYxNGM3NjAiIHN0RXZ0OndoZW49IjIwMTgtMTItMTZUMTY6NTQ6MTctMDg6MDAiIHN0RXZ0OnNvZnR3YXJlQWdlbnQ9IkFkb2JlIFBob3Rvc2hvcCBDQyAyMDE4IChXaW5kb3dzKSIvPiA8L3JkZjpTZXE+IDwveG1wTU06SGlzdG9yeT4gPC9yZGY6RGVzY3JpcHRpb24+IDwvcmRmOlJERj4gPC94OnhtcG1ldGE+IDw/eHBhY2tldCBlbmQ9InIiPz4/HiGMAAAAtUlEQVRYw+XXrQqAMBQF4D2P2eBL+QIG8RnEJFaNBjEum+0+zMQLtwwv+wV3ZzhhMDgfJ0wUSinxZUQWgKos1JP/AbD4OneIDyQPwCFniA+EJ4CaXm4TxAXCC0BNHgLhAdAnx9hC8PwGSRtAFVMQjF7cNTWED8B1cgwW20yfJgAvrssAsZ1cB3g/xckAxr6FmCDU5N6f488BrpCQ4rQBJkiMYh4ACmLzwOQF0CExinkCsvw7vgGikl+OotaKRwAAAABJRU5ErkJggg=="></a>
|
|
<img src="https://img.shields.io/badge/Enviroment-Client-purple">
|
|
<a href="https://discord.gg/BwWhCHUKDf"><img src="https://img.shields.io/discord/1033745845809586356?color=0098DB&label=Discord&logo=discord&logoColor=0098DB"></a> <br />
|
|
<a href="https://modrinth.com/mod/viafabricplus"><img src="https://img.shields.io/badge/dynamic/json?color=158000&label=downloads&prefix=+%20&query=downloads&url=https://api.modrinth.com/v2/project/rIC2XJV4&logo=modrinth"></a>
|
|
<a href="https://curseforge.com/minecraft/mc-mods/viafabricplus"><img src="https://cf.way2muchnoise.eu/full_830604_downloads.svg"></a>
|
|
|
|
#### 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
|
|
</div>
|
|
|
|
## Why?
|
|
ViaFabricPlus is supposed to be an alternative to [multiconnect](https://github.com/Earthcomputer/multiconnect) that offers more compactness and more clientside improvements,
|
|
as ViaFabricPlus implements all Via platforms (ViaVersion, ViaBackwards, ViaLegacy, ViaAprilFools, ViaBedrock) and adds tons of clientside fixes and QoL improvements like old rendering for all platforms.
|
|
|
|
## Issues and Contributions
|
|
If you encounter any issues, please report them on the
|
|
[issue tracker](https://github.com/FlorianMichael/ViaFabricPlus/issues).
|
|
Contributions in the form of pull requests are always welcome, please just stick to my code style and make sure your code is easy to update and compatible with other mods.
|
|
|
|
## Translations
|
|
Translations for other languages are always welcome, in ~/resources/assets/viafabricplus/lang you can find all translations,
|
|
if you know a language well, feel free to make a PR and add translations for that language <br>
|
|
|
|
**Currently supported languages**:
|
|
- English
|
|
|
|
## Compatibility
|
|
ViaFabricPlus is structured to interfere with mods as little as possible.
|
|
It should work fine with most if not all mods and modpacks.
|
|
|
|
### Known incompatibilities:
|
|
- ***[ViaFabric](https://github.com/ViaVersion/ViaFabric)***
|
|
- ***[multiconnect](https://github.com/Earthcomputer/multiconnect)***
|
|
- ***[Krypton](https://github.com/astei/krypton)***
|
|
- ***[Raknetify](https://github.com/RelativityMC/raknetify/tree/master)***
|
|
|
|
## Basic Features
|
|
- [x] ViaVersion implementation
|
|
- [x] ViaBackwards implementation
|
|
- [x] ViaLegacy implementation
|
|
- [x] ViaAprilFools implementation
|
|
- [x] ViaBedrock implementation
|
|
- [x] BetaCraft implementation for MP Pass
|
|
|
|
## Clientside related Fixes
|
|
- [x] Bounding boxes for all versions
|
|
- [x] Entity interaction and movement related packet fixes
|
|
- [x] Sync and async mouse/keyboard handling in <= 1.12.2
|
|
- [x] Mining speeds and item attributes
|
|
- [x] Filter item creative tabs for only available items
|
|
- [x] Combat system in <= 1.8
|
|
- [x] Tons of modifications to ViaVersion to make it more legit (Metadata fixes, broken packets, edge-cases)
|
|
- [x] Visual and screen related changes (newer Command Block features, GameMode selection, ...)
|
|
- [x] ViaAprilFools and ViaLegacy extensions to make it more legit
|
|
- [x] Chat signatures (secure login) for all versions (1.19.0, 1.19.1, 1.19.2)
|
|
- [x] Address parsing for all minecraft versions
|
|
- [x] PackFormats and HTTP Header for all resource pack versions
|
|
- [x] Raytrace related fixes in <= 1.8
|
|
- [x] Implementing HUD changes for <= b1.7.3
|
|
- [x] Chat lengths of all versions
|
|
- [x] Implementing non-sequenced block placement in <= 1.18.2
|
|
- [x] Animation related fixes (1.7 Sneaking, c0.30 walking animation, ...)
|
|
- [x] Fixed clientside packet handling (1.16.5 transactions, 1.19.0 tablist, ...)
|
|
|
|
## TODO
|
|
- [ ] ClassiCube implementation for MP Pass
|
|
- [ ] BetaCraft server list screen
|
|
- [ ] More extensions for Classic Protocol Extensions protocol
|
|
- [ ] Window click interactions in <= 1.16.5
|
|
|
|
## Backports
|
|
Basically there are no backports, the last version of ViaFabricPlus that supported a specific Minecraft version is also the last one that exists for that Minecraft version. <br>
|
|
However, if a version between two Minecraft versions is too unstable, I will definitely make backports, you can find them only on modrinth/curseforge, <br>
|
|
they do not have their own releases, current backports (named after their branch):
|
|
- [1.19.3](https://modrinth.com/mod/viafabricplus/version/0.0.0)
|
|
|
|
## Dependencies
|
|
| Dependency | Download |
|
|
|------------------------|------------------------------------------------------------|
|
|
| Fabric API | https://github.com/fabricMC/fabric |
|
|
| 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 |
|
|
| Netty-transport-RakNet | https://github.com/CloudburstMC/Network/tree/develop |
|
|
|
|
## Setting up a Workspace
|
|
ViaFabricPlus uses Gradle, to make sure that it is installed properly you can check [Gradle's website](https://gradle.org/install/).
|
|
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 and GUI
|
|
In the multiplayer screen you will find the ViaFabricPlus button in the upper left corner by default, it is the main button, <br>
|
|
click on it, and you will see the Protocol selection, there you can choose the Minecraft version you want to connect to, <br>
|
|
in the upper left corner you can go to the Settings.
|
|
|
|
|
|
|
|
|
|
### Settings are optional settings that can turn fixes on and off, originally they were used for debugging<br>
|
|
|
|
|
|
## Bedrock edition
|
|
Keep in mind that the Java -> Bedrock support is still in beta phase, and therefore many things are not implemented <br>
|
|
yet and there is no guarantee that everything will work as it should.
|
|
|
|
|
|
|
|
To log in to a Bedrock account you can press the button **"Click to set account for Bedrock edition"** in the settings, <br>
|
|
then you can log in via device login, the account logged in there will be stored in **~/ViaFabricPlus/bedrock.account**.
|
|
|
|
## Classic stuff
|
|
### Custom protocol extensions
|
|
ViaFabricPlus implements new Classic Extensions into the CPE protocol of ViaLegacy which are rather client side. <br>
|
|
- **WeatherType** extension (version **1**)
|
|
|
|
### Protocol commands
|
|
To better control the Classic Protocol, there are a few clientside commands, the command prefix is **/v**: <br>
|
|
- **/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**
|
|
|
|
## Addons
|
|
There is no real addon base, to create addons you can simply use the event system, which uses Fabric's Event-API.
|
|
```java
|
|
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 | Called as soon as the idle packet is skipped in the <= 1.8 |
|
|
|
|
### General API
|
|
#### Get the release version of an material:
|
|
```java
|
|
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
|
|
```
|
|
|
|
#### Creating own settings for the settings screen:
|
|
```java
|
|
public class ExampleSettingGroup extends SettingGroup {
|
|
public final static ExampleSettingGroup INSTANCE = new ExampleSettingGroup();
|
|
|
|
public final BooleanSetting test = new BooleanSetting("Test", false);
|
|
|
|
public ExampleSettingGroup() {
|
|
super("Example");
|
|
}
|
|
}
|
|
```
|
|
and then you register the setting group in your onLoad method:
|
|
```java
|
|
PreLoadCallback.EVENT.register(() -> {
|
|
ViaFabricPlus.INSTANCE.getSettingsSystem().addGroup(ExampleSettingGroup.INSTANCE);
|
|
});
|
|
```
|
|
|
|
#### Implementing classic protocol commands:
|
|
```java
|
|
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:
|
|
```java
|
|
PreLoadCallback.EVENT.register(() -> {
|
|
ClassicProtocolCommands.commands.add(new ExampleCommand());
|
|
});
|
|
```
|
|
|
|
#### Implementing custom classic protocol extensions:
|
|
```java
|
|
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](https://github.com/Gerrygames/ClientViaVersion): Discontinued 5zig plugin.
|
|
- [multiconnect](https://www.curseforge.com/minecraft/mc-mods/multiconnect): Fabric mod for connecting to older
|
|
versions: down to 1.11 (stable) and 1.8 (experimental).
|
|
- [ViaFabric](https://www.curseforge.com/minecraft/mc-mods/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**
|