OfflinePass

OfflinePass

Secure offline servers.

by
391 Downloads
forgemanagementsocialutility
Rent Server with this Mod

About this Mod

================= SERVER GUIDE =================

  1. Locate your configuration file (/world/serverconfig/serverofflinewhitelist.toml) (ON SERVER!)

  2. 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.

  3. Format them like THIS!

[serverofflinewhitelist]

    userpasswords = ["1234:stabbyeli", "insertpasswordhere:codinghuman", "passworddd:RDJX3", "password:username"]

  1. Send your friends the passwords you generated for them! (or that they generated for you – it can work either way.)

==============================================

================= CLIENT GUIDE  =================

  1. Locate your configuration file (Modpackdir/config/clientofflinewhitelist.toml)

  2. Add the password you generated (or the one the owner of the server generated for you.)

  3. Format it like this

[yourpasscode]

    passcode = "mypasscode"

  1. 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!

maka

Available Versions

OfflinePass 1.0.0release
MC 1.20.1forge
November 27, 2024

How to Install OfflinePass on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set forge Loader

In the panel under "Egg", select the forge loader and matching Minecraft version (1.20.1).

3

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

forge

Minecraft Versions

1.20.1

Server-side

Required

Recommended 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.

Rent Modded Server

Install OfflinePass with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
LicenseRef-All-Rights-Reserved
Server-side
Required

Supported Versions

1.20.1