https://github.com/viaversion/viaforge
Client-side ViaVersion implementation for MinecraftForge and NeoForge
https://github.com/viaversion/viaforge
forge java minecraft minecraft-mod protocol protocol-hack protocol-translator viabackwards viaforge viamcp viarewind viaversion
Last synced: 2 days ago
JSON representation
Client-side ViaVersion implementation for MinecraftForge and NeoForge
- Host: GitHub
- URL: https://github.com/viaversion/viaforge
- Owner: ViaVersion
- License: gpl-3.0
- Created: 2021-02-16T19:12:00.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2025-10-13T13:04:17.000Z (3 months ago)
- Last Synced: 2025-10-13T19:29:51.524Z (3 months ago)
- Topics: forge, java, minecraft, minecraft-mod, protocol, protocol-hack, protocol-translator, viabackwards, viaforge, viamcp, viarewind, viaversion
- Language: Java
- Homepage: http://viaversion.com/forge
- Size: 19.6 MB
- Stars: 128
- Watchers: 7
- Forks: 33
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
ViaForge
Client-side ViaVersion implementation for MinecraftForge and NeoForge
## How to (Users)
### Supported Client versions
ViaForge can be installed on 1.8.9, 1.12.2, 1.16.5, 1.17.1, 1.18.2, 1.19.2, 1.19.4, 1.20.1, 1.20.4, 1.20.6 and 1.21.11
Forge,
and 1.20.1, 1.20.6, 1.21.11 NeoForge client versions.
## Supported Server versions
- Release (1.0.0 - 1.21.11)
- Beta (b1.0 - b1.8.1)
- Alpha (a1.0.15 - a1.2.6)
- Classic (c0.0.15 - c0.30 including [CPE](https://wiki.vg/Classic_Protocol_Extension))
- April Fools (3D Shareware, 20w14infinite, 25w14craftmine)
- Combat Snapshots (Combat Test 8c)
---
Dev builds: https://ci.viaversion.com/view/Platforms/job/ViaForge/
If you encounter any issues, please report them on either:
- [the issue tracker](https://github.com/ViaVersion/ViaForge/issues)
- [the ViaVersion Discord](https://discord.gg/viaversion)
## How to (Developers)
### How to build
1. Clone the repository with `git clone`.
2. Run `./gradlew build` in the root directory of the repository.
3. The compiled jar files can be found in `viaforge-mc/build/libs`.
Note: Build scripts are made to be run using Java 21.
### Anti cheat integration
ViaForge supports sending a custom payload to transmit player protocol version data to the server. This allows servers
to retrieve a player's protocol version via plugin messages, which can be useful for anti-cheat checks and
version-dependent logic.
This feature is enabled by default and can be disabled using the `send-connection-details` config option.
For more details on how to use this feature, see
the [Player Details Protocol wiki](https://github.com/ViaVersion/ViaVersion/wiki/Player-Details-Protocol).