
================= 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!

- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.20.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as offline_whitelist-1.0.0-forge-1.20.1.jar — drop this file into the mods folder
- Download size: 14 KB
- Download link checked 6 Sept 2026 — working
These come from our own check of the pack file, not from the source page.