

Modrinth · Fabric, Quilt
Custom LAN on your Minecraft server
Custom LAN runs on Minecraft servers with Fabric or Quilt. Order your server, set the loader in the panel and install the mod with one click in the mod browser.
Gives you more control over your integrated server through the Open to LAN menu.
- Downloads
- 301.0K
- Author
- DimiDimit
- Loader
- Fabric, Quilt
- Minecraft
- 1.14 – 1.21.8
- Updated
- –
Setup
Install Custom LAN on your server
The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.
- 01
Configure
4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.
- 02
Set the loader
In the panel, set the server software to Fabric or Quilt and choose the matching Minecraft version, for example 1.21.8.
- 03
Install the mod
Search the mod browser for “Custom LAN” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.
- 04
Connect
Every player installs the same Custom LAN release locally and connects using the server address from the panel.
- On the server
- Required
- On the client
- Required
- Loader
- Fabric, Quilt
- Minecraft
- 1.21.8, 1.21.7, 1.21.6 +37 more
- License
- MIT License
The panel
Install mods, find errors.
Real screenshots from the Mado panel. Both come with every Minecraft server.
Mod browser
Modrinth and CurseForge, right in the panel.
The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

AI crash analysis
When a mod crashes, the analyzer reads the log.
Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Releases
Published releases
Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.
Custom LAN · Modrinth- [1.21.6-1.21.8] Custom LAN 2.3.2July 26, 2025Minecraft 1.21.6, 1.21.7, 1.21.8 · Fabric, Quilt
- [1.21.5] Custom LAN 2.3.2April 14, 2025Minecraft 1.21.5 · Fabric, Quilt
- [1.21.4] Custom LAN 2.3.2January 2, 2025Minecraft 1.21.4 · Fabric, Quilt
- [1.21.2-1.21.3] Custom LAN 2.3.2November 25, 2024Minecraft 1.21.2, 1.21.3 · Fabric, Quilt
- [1.21-1.21.1] Custom LAN 2.3.2October 20, 2024Minecraft 1.21, 1.21.1 · Fabric, Quilt
Original description by the project author

A Fabric mod that allows you to:
- Customize more of your integrated server (Online Mode, PvP, Max Players, MOTD)
- Use ampersands (
&) for formatting codes instead of section signs (§) and variables (e.g.${username},${world}) in the MOTD - Change the settings mid-game (including the port) and stop the server without quitting the world
- Save the settings globally or per-world (they are loaded automatically with per-world settings taking priority over the global ones, which take priority over the system defaults)
- Change who can use cheats individually using the
/opand/deopcommands and cheat in singleplayer without opening to LAN (replaces the Allow Cheats button) - Manage bans with
/ban,/ban-ip,/banlist,/pardonand/pardon-ip, and whitelist players with/whitelist(use/whitelist on/offto enable/disable) - Expose your server outside of your LAN without port forwarding using tunnels (currently only ngrok is supported)
It also allows you to start the LAN world by pressing Enter, doesn't force the gamemode (e.g. anyone who left in Creative mode will still be in Creative when they join even if the world is set to Survival), and extends the /publish command, which can now change settings mid-game as well (use a port of -1 to randomize it):
/publish [<port>] [<onlineMode>] [<pvpEnabled>] [<maxPlayers>] [<defaultGameMode>] [<tunnel>] [<motd>]
/publish [perworld|global|system] [<port>] [<onlineMode>] [<pvpEnabled>] [<maxPlayers>] [<defaultGameMode>] [<tunnel>] [<motd>]
/publish stop
It requires Fabric Loader and Cloth Config API, but Fabric API is not required.
It has been backported to all Minecraft versions supported by Fabric (except the snapshots)!
I'm not planning on porting it to Forge myself for now, but you're more than welcome to send me a pull request.
Explanation of MOTD formatting codes and variables
In the MOTD, ampersands (&) are replaced with section signs (§) to allow you to enter formatting codes (e.g. &9Hello, &a&lworld! makes Hello, blue and world! green and bold).
You can use two ampersands in a row (&&) to get an actual ampersand (&).
The following variables will be expanded using Apache Commons Text's StringSubstitutor:
${username}– the host's username (e.g. “DimiDimit”)${world}– the world's name (e.g. “New World”)
Explanation of saved settings
The settings can be saved per-world or globally. When the Open to LAN screen is opened, the settings are loaded automatically in that order, and they can also be loaded manually using the Load buttons.
Using the /publish command without specifying which saved settings to use (perworld, global or system) uses the same order if the world hasn't been opened to LAN, or the current values instead of any saved settings if it has.
Specifying the saved settings uses those particular settings or the system defaults if they haven't been saved, without checking any others, even if the world has been opened to LAN (e.g. if perworld is specified and no per-world settings are saved, the system defaults will be used even if there are saved global settings).
The settings specified as arguments will override the saved settings or current values (e.g. /publish perworld 12345 false will use the per-world settings, except that the port will be 12345 and online mode will be disabled).
The global settings are stored in .minecraft/config/customlan.toml, while the per-world ones are stored in data/customlan.dat in the respective world's directory.
Explanation of /op and /deop
/op and /deop work like in dedicated servers.
You can also use them on yourself, the host. Doing this will add/remove the “Cheats” label on the world (as if you've NBT edited the allowCommands field), and you can use these commands without opening to LAN as well, replacing the Vanilla method of opening to LAN, cheating, quitting the world and entering it again.
Operators are persisted per-world in an ops.json file inside that world's directory. To allow operators to assign and remove other operators, as well as ban and whitelist players, change their level in the ops.json file to 3 or higher (the default is 2, while level 4 allows them to use /publish). You, as the host, can always assign and remove operators, even if you're not an operator yourself.
Explanation of bans and whitelists
These commands also work like in dedicated servers, though you cannot ban or whitelist the host.
Enabling the whitelist does not kick all non-whitelisted players (i.e. enforce-whitelist is always false).
The files used are also per-world and the same as on dedicated servers—banned-players.json, banned-ips.json, whitelist.json—though whether the whitelist is enabled is stored in data/customlan.dat.
Custom LAN server crashes on startup – what to do?
Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.
Which loader does Custom LAN run on?
According to Modrinth, Custom LAN supports Fabric, Quilt for Minecraft 1.21.8, 1.21.7, 1.21.6.
How much RAM does a server with Custom LAN need?
As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.
Similar mods
Popular mods in the same category
Server-ready
FerriteCore
by malte0811
Memory usage optimizations
Client only
Mod Menu
by Prospector
Adds a mod menu to view the list of mods you have installed.
Server-ready
YetAnotherConfigLib (YACL)
by isxander
A builder-based configuration library for Minecraft!
Server-ready
Xaero's Minimap
by thexaero
Displays a map of the nearby world terrain, players, mobs, entities in the corner of your screen. Lets you create waypoints which help you find the locations you've marked.
Ready for your server with Custom LAN?
4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.