Need help with multiconnect?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

Earthcomputer
146 Stars 27 Forks MIT License 506 Commits 29 Opened issues

Description

A mod to connect to multiple Minecraft server versions

Services available

!
?

Need anything else?

Contributors list

# 179,717
C
intelli...
bungeec...
Gradle
402 commits
# 141,340
Git
c-sharp
Groovy
astar
42 commits
# 532,700
factori...
HTML
PHP
Shell
3 commits
# 662,650
C#
Java
2 commits
# 549,520
Java
velocit...
bungeec...
1 commit
# 128,340
HTML
Kotlin
fdroid
Gradle
1 commit
# 185,082
Java
Shell
bungeec...
C
1 commit
# 502,981
C++
Shell
C
Android
1 commit

Project icon

multiconnect

GitHub license GitHub issues GitHub tag

Connect to many different server versions from your Fabric client!

Discord

https://discord.gg/Jg7Bun7

Why another protocol translator?

Multiconnect distinguishes itself from similar projects such as ViaVersion and ProtocolSupport in that it is very much client-side. Crucially, this means it can (and does) fix many version differences on the client; such issues are unfixable on the server. As of the time of writing, multiconnect is the only mod which fixes 1.12 swimming mechanics, parkour differences, and re-adds removed features such as command syntax on the client.

On the other hand, multiconnect supports only the latest Minecraft client version, and only on Fabric. It also does not have as much version coverage as ViaVersion and ProtocolSupport (yet).

Usage with ViaFabric

If you want to connect to servers older than what multiconnect can currently support, you can install ViaFabric alongside multiconnect, the two are compatible - multiconnect will translate as much as it can, ViaFabric will take you the rest of the way. Follow the instructions in the ViaFabric readme for details on how to do this.

Other alternatives

Installation for Players

  1. Download and run the Fabric installer.
    • Click the "vanilla" button, leave the other settings as they are, and click "download installer".
    • Note: this step may vary if you aren't using the vanilla launcher or an old version of Minecraft.
  2. Download multiconnect from the releases page and move it to the mods folder (
    .minecraft/mods
    ).

Installation for Mod Developers

This section is for when you are developing your own mod and want to use the multiconnect API, or run multiconnect alongside your mod in the IDE. Aside from the first step, you ONLY need to follow the steps applicable to you and your mod. 1. Add a

repositores {}
block in your
build.gradle
(if there isn't already one), and add Earthcomputer's Bintray mods repository:
groovy
   repositories {
      maven {
         url 'https://dl.bintray.com/earthcomputer/mods'
      }
   }
- Note: this repositories block is NOT the same as the one inside the
buildscript {}
block. 1. If you want to use the API inside your mod, you will have to jar-in-jar it for the release and add it to the classpath. To do this, add the following to your
dependencies {}
block:
groovy
   dependencies {
      // ...
      modImplementation 'net.earthcomputer:multiconnect::api'
      include 'net.earthcomputer:multiconnect::api'
   }
- Note: replace
 with the version of multiconnect you want to depend on.
   - Note: SKIP the 
include
part if your mod is NOT using the API in any way. 1. If you want to run multiconnect in the IDE alongside your mod, add the following to your
dependencies {}
block:
groovy
   dependencies {
      // ...
      modRuntime 'net.earthcomputer:multiconnect::slim'
   }
- Note: the previous step should also be done alongside this step. - Note: this step is only necessary if you want to run the full mod in the IDE. Otherwise you can skip this step.

Contributing

  1. Clone the repository
    git clone https://github.com/Earthcomputer/multiconnect
    cd multiconnect
    
  2. Generate the Minecraft source code
    ./gradlew genSources
    
    • Note: on Windows, use
      gradlew
      rather than
      ./gradlew
      .
  3. Import the project into your preferred IDE.
    1. If you use IntelliJ (the preferred option), you can simply import the project as a Gradle project.
    2. If you use Eclipse, you need to
      ./gradlew eclipse
      before importing the project as an Eclipse project.
  4. Edit the code.
  5. After testing in the IDE, build a JAR to test whether it works outside the IDE too
    ./gradlew build
    
    The mod JAR may be found in the
    build/libs
    directory
  6. Create a pull request so that your changes can be integrated into multiconnect
    • Note: for large contributions, create an issue before doing all that work, to ask whether your pull request is likely to be accepted

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.