Ngrok LAN is a Fabric mod that enables you to share your singleplayer world with your friends across the globe, all via clicking on the new "Open Public Server" button! This mod uses Ngrok, a free service to ease the creation of servers, as the main service to "tunnel" your connection to the internet, and will generate a link for your friends to connect to after you click on "Open Public Server".

For more on how Ngrok-LAN works, check out What is Ngrok.

The mod requires the following mods:

• Fabric Loader & Fabric API
• ClothConfig API
• ModMenu

1. Go to the FabricMC website and download the latest installer
2. Run the JAR, a window will pop up. Choose the correct version of Minecraft and loader (this mod currently requires Minecraft v1.18.2 and loader v0.13.3), and click on "Install".
3. A new game version and profile will be created in the launcher's menu, which you can now use to launch Fabric.
4. Put the mod JAR (available under Releases) into your "mods" folder, along with the ClothConfig API and ModMenu JARs. (The Fabric API JAR should already be in your mods folder from the previous section)
5. Run the newly installed profile from step 3, and Ngrok LAN should load

1. Make sure that Ngrok LAN is enabled, the auth token is valid, and the correct region is selected
2. Open a new singleplayer world, and click on Open to LAN
3. Configure the game mode and whether to allow cheats
4. Press on "Open Public Server"
5. The message "Ngrok service initiated successfully" should appear in chat, with a link highlighted in yellow
   • If not, check common issues below
6. The link is automatically copied to your clipboard, and can now be shared with your friends
7. Other people just need to put this as a server IP into their multiplayer list, and join the world

1. Go to https://ngrok.com/, and sign up for a new free account
2. On the dashboard, on your left-hand side menu, click on Getting Started > Your Auth Token
3. Copy the auth token, and put this into Ngrok LAN (don't share this token with other people)

• For more errors, error codes and their resolution, check the Ngrok docs

Please open a new issue in Issues

Ngrok is a free service that exposes your applications running locally to the internet, without port forwarding. Usually, when setting up a Minecraft server, you would have to open the server, and "forward" your port through your router. Port forwarding "publishes" your server to the internet, so anyone with you IP can join. Think of this as your router "forwarding" the network packets from your server (part of your local network) to your friends (part of the wider internet).

Using Ngrok, however, we don't need to forward the port. All the internet traffic is routed through an application ( Ngrok-LAN in this case), then their datacentres. Ngrok provides us with a link in return, that we can give to our friends to connect to our server. This doesn't require any other configuration on your side - as long as you have internet, and an Ngrok account, you can host your singleplayer world to your friends across the globe.

The mod only requires a free Ngrok account. The free tier for Ngrok allows you to have 1 free online tunnel simultaenously, which means that, with one Ngrok free account, you can only host 1 Ngrok-LAN server at the same tiume. The paid tiers allows you to have custom domains and more simultaenous online tunnels, but custom domains are not yet supported in this mod.

More pricing info please refer to Ngrok's website

• Add ModRinth and CurseForge integration
• Add meta description for CurseForge and ModMenu information
• Specify dependencies
• Add list of incompatible mods

This mod is available under the MIT license.