NetherLink

Minecraft 26.2-snapshot-7 introduced P2P networking and friend-list support. This project aims to enhance this feature.

Client Features

• (For Minecraft 26.1.2 or older) This mod just adds full official P2P feature :)
• Add an Integrated Server sharing mode for single-player worlds.
• Stop Minecraft from broadcasting presence status except "In a joinable world" to avoid conflicts with server features.

Server Features

• Link a dedicated server with a Microsoft/Minecraft account.
• Publish dedicated server availability to the owner's Minecraft friend list.

How to use

Client

1. Install NetherLink on the client.
2. Launch the game and open a single-player world.
3. Open the multiplayer sharing screen.
4. Select Integrated Server as the sharing mode.

When this mode is active, friends in your Minecraft friend list can join the world without a manual approval prompt. The world is still hosted by the integrated server in your client, so it closes when you leave the world or stop sharing it.

NetherLink also suppresses normal client presence updates for accounts that are configured as hosted server accounts. This keeps the hosted server presence from being overwritten by the same account playing on a client.

Server

1. Install NetherLink on the server.

2. [Optional] If you want to use your own APP ID used for authentication, set it with environment variable NETHERLINK_CLIENT_ID.

3. Start the server and run:

   /nli add

4. Open the login URL shown in chat or the server console, complete Microsoft authentication, and wait for NetherLink to store the Minecraft account.

5. Check configured accounts:

   /nli list

6. Publish the server to the account owner's Minecraft friend list:

   /nli publish

After publishing, friends of the linked account should see it as a joinable hosted world. Incoming P2P join requests are accepted by NetherLink and routed into the running server.

Server Commands

• /nli add or /netherlink add: add a Microsoft/Minecraft account through device-code login.
• /nli list: show configured accounts and token status.
• /nli refresh [all|<name>]: refresh stored account tokens.
• /nli publish [all|<name>]: publish server presence and start accepting P2P joins.
• /nli revoke [all|<name>]: revoke server presence and stop accepting P2P joins for the account.
• /nli toggle <name>: enable or disable an account.
• /nli remove <name>: remove a stored account.

Account data is stored under netherlink/accounts. Treat these files as credentials; do not share them publicly.