UPNP for dedicated servers
by Panzimy
UPNP for dedicated servers opens a server's port through the router with UPnP when the server starts and closes it when the server stops.
What it does
On dedicated Minecraft servers, the mod uses UPnP to open the port automatically, so the server can accept players from outside the local network without manual router setup. The port is opened when the server starts and closed when it stops, and a server owner can check from an online port checker that the port is reachable. The mod is aimed at dedicated servers and is an alternative to LAN-style hosting, which is different from how single-player worlds are shared.
The mod primarily wraps the WaifUPnP library and binds its functions to the server lifecycle and to a command. The bundled library was modified slightly to log errors and to implement some pending pull requests from the original project, and the project includes bugfixes that forks did not carry over. Fabric API is required, and the mod is published for Fabric and NeoForge.
It runs on the server only, so players join without installing anything. Files cover game versions 1.21.11 – 26.2 across five release versions, and the mod is released under the MIT License, so the source is open. Public links exist for the source code and the issue tracker. The latest Fabric and NeoForge builds, 4.0.0, target 26.2 and do not support 26.1 or 26.2 mappings in the way earlier notes suggested; check the file list for the exact version.
Key features
Automatic port opening
The server requests a UPnP port mapping when it starts, so no manual port forwarding is needed.
Port closing on stop
When the server stops, the mapping is removed, so the port is not left open afterward.
Command for lifecycle control
A command ties the port mapping to the server lifecycle, letting administrators see and manage the state.
Modified WaifUPnP library
The bundled library logs errors and includes pending fixes from the original project, along with its own bugfixes.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Hosting for friends off the local network
A server owner who wants friends from other networks to join can open the port without editing router settings.
Checking reachability
After the server starts, the owner can confirm with an online port checker that the mapping is working.
Who it’s for: Server owners running dedicated Fabric or NeoForge servers who want UPnP-based port opening rather than manual router configuration. Players need nothing installed.
Questions
Does UPNP for dedicated servers need Fabric API?
Does a player need to install this mod?
Which game versions does the latest build support?
In the catalog
UPNP for dedicated servers is one of 36,990 Utility mods on ModsFinder, and one of 25,772 Utility mods for Fabric. 13,894 mods support Minecraft 26.2.
More from Panzimy
Similar mods
What the author says
WARNING, because I'm COMPLETE dumb person and I forgot about 26.1 that has NO MAPPINGS, ALL RELEASES before 4.0.0 DON'T SUPPORT 26.1/26.2 UPNP for dedicated Fabric/NeoForge Minecraft Servers (as opposed to LAN servers, which there are plenty of other equivalent mods for). Opens ports when the server starts, and…
Official listing
- Modrinth page
- modrinth.com/mod/upnp-for-dedicated-servers
- Owner
- Panzimy
- Published
- 2026-04-25
- Updated on Modrinth
- 2026-06-23
- Facts verified
- 2026-10-15
