Offline Whitelist — Nickname-Based Whitelist

Quick rating

Offline Whitelist — Nickname-Based Whitelist

No reviews yet

Simple mod that secures offline-mode servers by allowing access strictly based on player usernames.

QoL & Tweaks
Bug Fixes
Mod Loaders
NeoForge
Minecraft

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.

Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Compatibility

Supported Environments

Dev Environment
Client Unsupported
Server Required

About

Project Details

Type
Mod
License
MIT License
Latest Version
offlinewhitelist-1.0.1.jar
Authors
CurseForge
Modrinth

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID
Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

JOIN OUR DISCORD

Offline Whitelist is a server-side mod designed specifically for servers running with online-mode=false. It validates players by nickname, ensuring that only approved users can access your server. Because it operates entirely server-side, it requires no client installation and works seamlessly with vanilla clients. The mod intercepts connections early, preventing undesirable players from entering the server.

Supported Languages

Features

  • Offline-Mode Support: Validates players purely by their username, making it perfect for cracked/offline servers.
  • Seamless Connection Blocking: Disconnects players during the connection phase before they spawn, leaving no trace in the server chat.
  • Localized Kick Messages: Automatically detects the player's client language and displays the kick reason accordingly (e.g., English clients get English text, Russian clients get Russian). You can add unlimited custom languages in the config file config/offlinewhitelist.json .
  • Operator Bypass: An optional setting (enabled by default) that allows server operators to join the server even if they are not explicitly added to the whitelist.
  • Clean File Structure: All player lists and configuration files are neatly organized in the config/ directory as simple, editable JSON files.

Commands

All commands require Operator permission. You can use either /offwhitelist or the shorter alias /owh.

  • /owh add — Adds a player to the whitelist.
  • /owh remove — Removes a player from the whitelist.
  • /owh getall — Lists all players currently in the whitelist.
  • /owh on — Enables the whitelist.
  • /owh off — Disables the whitelist.
  • /owh opbypass on — Allows operators to bypass the whitelist.
  • /owh opbypass off — Requires operators to be in the whitelist to join.
  • /owh status — Shows the current whitelist status.
  • /owh reload — Reloads the whitelist players and configuration messages.

JOIN OUR DISCORD

Offline Whitelist is a server-side mod designed specifically for servers running with online-mode=false. It validates players by nickname, ensuring that only approved users can access your server. Because it operates entirely server-side, it requires no client installation and works seamlessly with vanilla clients. The mod intercepts connections early, preventing undesirable players from entering the server.

Supported Languages

Features

  • Offline-Mode Support: Validates players purely by their username, making it perfect for cracked/offline servers.
  • Seamless Connection Blocking: Disconnects players during the connection phase before they spawn, leaving no trace in the server chat.
  • Localized Kick Messages: Automatically detects the player's client language and displays the kick reason accordingly (e.g., English clients get English text, Russian clients get Russian). You can add unlimited custom languages in the config file config/offlinewhitelist.json .
  • Operator Bypass: An optional setting (enabled by default) that allows server operators to join the server even if they are not explicitly added to the whitelist.
  • Clean File Structure: All player lists and configuration files are neatly organized in the config/ directory as simple, editable JSON files.

Commands

All commands require Operator permission. You can use either /offwhitelist or the shorter alias /owh.

  • /owh add — Adds a player to the whitelist.
  • /owh remove — Removes a player from the whitelist.
  • /owh getall — Lists all players currently in the whitelist.
  • /owh on — Enables the whitelist.
  • /owh off — Disables the whitelist.
  • /owh opbypass on — Allows operators to bypass the whitelist.
  • /owh opbypass off — Requires operators to be in the whitelist to join.
  • /owh status — Shows the current whitelist status.
  • /owh reload — Reloads the whitelist players and configuration messages.

Screenshots

Gallery

  • You are not whitelisted!
    You are not whitelisted!
  • You are not whitelisted!
    You are not whitelisted!

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Total Downloads
CurseForge
<1,000
Modrinth
<1,000
Last Updated
CurseForge
Created
CurseForge
Modrinth
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works