Download/Build the .jar file and place it in the /mods/ folder of your Minecraft Fabric server or client folder.
The Fabric TwinSession mod enables players to connect to a Minecraft server multiple times using the same account.
This functionality is particularly useful for those who want the advantages of multiple sessions, such as managing different in-game tasks simultaneously, without needing to purchase additional Minecraft accounts. When a player connects to the server with the same account for the second time, the mod automatically modifies the player’s username by adding a numerical prefix followed by an underscore (e.g., "1_PlayerName").
Each additional session increments this number (e.g., "2_PlayerName", "3_PlayerName", etc.).
Important note: You can either install this mod as server mod or as a client mod. When installed as a server mod, clients are not required to install this mod as well.
When installed on a server environment
- First Session: Join the server as usual with your Minecraft account.
- Second Session: Open another Minecraft client and join the same server with the same account. The mod will automatically modify your username (e.g., "1_PlayerName") to allow the connection.
- Additional Sessions: Repeat the process to join the server with more clients using the same account. Each additional session will receive a sequentially numbered username (e.g., "2_PlayerName", "3_PlayerName").
When installed on a client environment
- Set Up: Start your Minecraft world and select "Open to LAN" from the pause menu.
- Connecting: Follow the same process as in Multiplayer to connect with multiple clients using the same account.
This mod is ideal for players who wish to multitask effectively, such as managing in-game farms or automation, without the need for a separate Minecraft account.
Configuration can be found under /config/twinsession.properties and contains the following confiugration:
| Property | Description | Type | Default value |
|---|---|---|---|
| maxPlayers | Max amount of re-joins per client. | int | 8 |
| autoWhitelist | Automatically whitelist if whitelist is enabled. | boolean | true |
| autoOp | Automatically op if original client is also op. | boolean | true |
| spawnNearPlayer | Spawn near the player, if false new players will join at world spawn. | boolean | true |
| spawnNearPlayerRadius | If spawnNearPlayer is enabled, this will set the radius on who close the player should spawn. | int | 10 |
| copyTexture | Copy the texture of the original player. | boolean | true |
| prefixWithNumber | Adds a $_ prefix to the username (Highly recommended to keep on true) |
boolean | true |
If you encounter any bugs or have suggestions for improvements, please create an issue on our GitHub repository. To create an issue:
- Go to the Issues tab of this repository.
- Click on "New Issue".
- Choose between "Bug report" or "Feature request" template.
- Fill out the template with as much detail as possible.
- Submit the issue.
For setup instructions, please see the Fabric wiki page relevant to your IDE.
This template is available under the CC0 license. Feel free to learn from it and incorporate it into your own projects.