Goal

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.).

How to Use

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.

Multiplayer Servers

When installed on a server environment

1. First Session: Join the server as usual with your Minecraft account.
2. 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.
3. 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").

Singleplayer (LAN)

When installed on a client environment

1. Set Up: Start your Minecraft world and select "Open to LAN" from the pause menu.
2. 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.

Config

Configuration can be found under /config/twinsession.properties and contains the following settings:

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 how 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

Reporting Issues

If you encounter any bugs or have suggestions for improvements, please create an issue on our GitHub repository. To create an issue:

1. Go to the Issues tab of this repository.
2. Click on "New Issue".
3. Choose between "Bug report" or "Feature request" template.
4. Fill out the template with as much detail as possible.
5. Submit the issue.