WhitelistGate
No reviews yet
A lightweight server-side whitelist for online and offline-mode Minecraft servers.
Includes quality of life improvements and small tweaks to enhance and customize gameplay.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
CurseForge
Modrinth
Compatibility
Supported Environments
About
Project Details
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.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description
WhitelistGate
WhitelistGate is a lightweight, server-side mod that adds an independent nickname-based whitelist without using or modifying Minecraft's vanilla whitelist.json.
It is designed for server owners who want a separate, simple access list that works in both online and offline mode. Players do not need to install WhitelistGate on their clients, and the mod does not add a custom network handshake.
Features
- Fully server-side: vanilla clients and clients without the mod can connect.
- Works with both
online-mode=trueandonline-mode=false. - Checks player nicknames case-insensitively.
- Preserves vanilla bans, IP bans, player limits, and other connection checks.
- Uses its own configuration file and never touches vanilla
whitelist.json. - Saves command changes immediately.
- No accounts, passwords, registration, database, GUI, or client-side installation.
Installation
- Install Forge on the server.
- Place the WhitelistGate JAR in the server's
modsfolder. - Start the server.
- Configure the whitelist with commands or edit
config/whitelistgate/whitelist.jsonand run/whitelistgate reload.
Do not install WhitelistGate on player clients. It is intended to run only on the server.
Commands
All commands require permission level 3 and can be used by server operators or from the dedicated server console.
/whitelistgate enable
/whitelistgate disable
/whitelistgate add <nickname>
/whitelistgate remove <nickname>
/whitelistgate list
/whitelistgate reloadEnabling WhitelistGate does not kick players who are already connected. Disabling it immediately stops WhitelistGate from restricting new connections.
Offline-mode security warning
On an offline-mode server, players can choose any nickname, including a nickname belonging to another person. A nickname whitelist controls which names may connect, but it does not authenticate users or prove ownership of a Minecraft account.
WhitelistGate is licensed under the Apache License 2.0.
WhitelistGate
WhitelistGate is a lightweight, server-side mod that adds an independent nickname-based whitelist without using or modifying Minecraft's vanilla whitelist.json.
It is designed for server owners who want a separate, simple access list that works in both online and offline mode. Players do not need to install WhitelistGate on their clients, and the mod does not add a custom network handshake.
Features
- Fully server-side: vanilla clients and clients without the mod can connect.
- Works with both
online-mode=trueandonline-mode=false. - Checks player nicknames case-insensitively.
- Preserves vanilla bans, IP bans, player limits, and other connection checks.
- Uses its own configuration file and never touches vanilla
whitelist.json. - Saves command changes immediately.
- No accounts, passwords, registration, database, GUI, or client-side installation.
Installation
- Install Forge on the server.
- Place the WhitelistGate JAR in the server's
modsfolder. - Start the server.
- Configure the whitelist with commands or edit
config/whitelistgate/whitelist.jsonand run/whitelistgate reload.
Do not install WhitelistGate on player clients. It is intended to run only on the server.
Commands
All commands require permission level 3 and can be used by server operators or from the dedicated server console.
/whitelistgate enable
/whitelistgate disable
/whitelistgate add <nickname>
/whitelistgate remove <nickname>
/whitelistgate list
/whitelistgate reload
Enabling WhitelistGate does not kick players who are already connected. Disabling it immediately stops WhitelistGate from restricting new connections.
Offline-mode security warning
On an offline-mode server, players can choose any nickname, including a nickname belonging to another person. A nickname whitelist controls which names may connect, but it does not authenticate users or prove ownership of a Minecraft account.
WhitelistGate is licensed under the Apache License 2.0.
Screenshots
Gallery
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
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers