TwinSession

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.