
OfflinePass
Secure offline servers.
About this Mod
================= SERVER GUIDE =================
Locate your configuration file (/world/serverconfig/serverofflinewhitelist.toml) (ON SERVER!)
Add your users to the file and their passwords (NOT REAL PASSWORDS) Generate them here https://proton.me/pass/password-generator. Do not use special characters, only numbers and letters.
Format them like THIS!
[serverofflinewhitelist]
userpasswords = ["1234:stabbyeli", "insertpasswordhere:codinghuman", "passworddd:RDJX3", "password:username"]
- Send your friends the passwords you generated for them! (or that they generated for you – it can work either way.)
==============================================
================= CLIENT GUIDE =================
Locate your configuration file (Modpackdir/config/clientofflinewhitelist.toml)
Add the password you generated (or the one the owner of the server generated for you.)
Format it like this
[yourpasscode]
passcode = "mypasscode"
- JOIN THE SERVER!!! If your password is valid, of course!
================================================
Q/A
Q: Why would I wanna add this to my offline server?
A: Well, first of all, whitelist doesn’t work for offline servers! And if it did, it wouldn’t even matter – you can change your name to ANYTHING on offline (which means they can change their name to the server owner and get op!) With this, there’s a unique password for each user, so you can’t just become ANYONE!
Q: Why not just a /login command?
A: Login commands are for servers that don’t have mods. Yours clearly does, and login commands are ANNOYING! Once you’ve got this set up, you can completely forget about it!
Q: Will you update?
A: Maybe......
Q: How does it work?
A: To simplify it. Your client sends a packet to the server basically asking "Is this a valid password?" then the server looks at your username and the password you requested and checks if it fits any of the usernames and passwords and if it DOESNT it doesnt let you in.
Thanks for downloading my mod!

Available Versions
How to Install OfflinePass on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.20.1).
Install Mod
Open the mod browser in the dashboard and search for "OfflinePass". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
OfflinePass server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.1). You can switch loaders with one click in the panel.
Is OfflinePass compatible with forge?
OfflinePass officially supports forge for Minecraft 1.20.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with OfflinePass – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if OfflinePass consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install OfflinePass with just one click on your server.