HomoHttpRouter
by heerheer
HomoHttpRouter is a NeoForge server utility that lets several mods share one HTTP port and register their own API routes through an event.
What it does
Instead of each mod starting its own HTTP service, HomoHttpRouter provides a shared service that the server itself hosts. Other mods listen for the HttpServiceBuildEvent, and when it fires they register route prefixes and handlers. Route handlers receive the request and must return a RestResponse. Built on Netty and FastJSON2, the service is described by its author as lightweight, stable and extendable.
Because mounted mods share a single service, port conflicts and duplicate network resource use are avoided. The port number is adjusted in the Forge configuration, and changes take effect after the server restarts. Authentication by token or API key is available for routes. HomoHttpRouter is a dependency for other server-side mods that want to expose routes, and it has to be installed on the server alongside them. The mod is server-side only, so players join without installing it.
Key features
Shared HTTP service
Several mods mount on one HTTP service built into the server, so none has to open a port of its own.
Event-based route registration
A mod registers its route prefixes and handlers when HttpServiceBuildEvent fires, with no manual setup.
Route Center
A Route Center lists the routes that other mods have registered, and the service renders an HTML document for them.
Token authentication
Routes can be protected with an authentication token or API key.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Mod developers exposing APIs
A developer adds routes to a mod by listening for the event, instead of starting an independent HTTP server inside the mod.
Server owners limiting ports
A server that runs several API-based mods can serve them all through one configurable port.
Who it’s for: The mod is meant for Minecraft mod developers who want to expose HTTP APIs, and for server owners who run several mods that do so.
Questions
Does a player need HomoHttpRouter installed?
Which loader and versions does HomoHttpRouter support?
How is the port changed?
In the catalog
HomoHttpRouter is one of 36,990 Utility mods on ModsFinder, and one of 13,477 Utility mods for NeoForge. 32,366 mods support Minecraft 1.21.1.
Similar mods
What the author says
> 70% of the code for this module was written by GTP-5.1, and the remaining 30% was written by the "artificially-unintelligent" Heer!(me). HomoHttpRouter is a lightweight HTTP service aggregation framework designed for Minecraft Forge mod developers. It allows multiple mods to share the same HTTP port and dynamically…
Official listing
- Modrinth page
- modrinth.com/mod/homohttprouter
- Owner
- heerheer
- Published
- 2025-11-18
- Updated on Modrinth
- 2025-11-21
- Facts verified
- 2026-10-15