cwhitelist
by SkyDreamLG
CWhitelist is a NeoForge server mod that controls which players may join, by player name or by IP address, with an optional centralized API.
What it does
Server owners use CWhitelist to decide which accounts can connect. It supports traditional username-based whitelisting and IP-based authentication, where addresses can be matched with wildcards such as 192.168.*. Each check type can be switched on or off separately, so a server may rely on names, addresses or both.
The mod can run in a dual mode. It first asks a remote API for the whitelist and falls back to a local list when the API cannot be reached. Several servers can share one source of truth, and updates are pushed automatically. Access to the API uses tokens with permission levels, and a separate backend repository is named by the author for hosting that service.
The mod is server-side only, so players join without installing anything. It runs on NeoForge, with files published for 17 release versions. The code is licensed under the GNU Lesser General Public License v3.0 or later and is open source, with public source code and an issue tracker.
Key features
Player name whitelist
Traditional whitelisting by username, with the player name checked against the list at login.
IP address authentication
Addresses can be allowed individually or by wildcard pattern, and each check type can be enabled independently.
API with local fallback
The server reads its whitelist from a remote API and keeps working from a local copy when the API is unavailable.
Token-based API access
API calls authenticate with tokens that carry permission levels, and the author notes describe generating new tokens for this purpose.
Real-time synchronization
Whitelist changes are pushed to connected servers automatically, and the cache clears when the configuration is modified.
Compatibility
Latest build for each game version and loader.
26.x5 of 5 versions with builds
1.21.x12 of 12 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Who it’s for: Server owners who manage access for one or more Minecraft Java servers on NeoForge. Players need nothing installed on their own side.
How it compares
Panda Command Whitelist is a Fabric-only mod released under the CC0 1.0 Universal license, and it is server-side only. WhitelistDb Mod runs on Fabric, Forge and NeoForge for 1.21.1 – 26.3 under the MIT License and is also open source. Offline Whitelist and NefAuth are NeoForge mods for 1.21.1 only, both under the MIT License, and neither is open source.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| cwhitelist | NeoForge | 1.21 – 26.3 | Server-side only | 2026-10-02 |
| Panda Command Whitelist | Fabric | 1.21 – 26.3 | Server-side only | 2026-10-04 |
| WhitelistDb Mod | Fabric, Forge and NeoForge | 1.21.1 – 26.3 | Server-side only | 2026-09-17 |
| Offline Whitelist | NeoForge | 1.21.1 | Server-side only | 2026-07-23 |
| NefAuth | NeoForge | 1.21.1 | Server-side only | 2026-08-06 |
Questions
Does CWhitelist need to be installed on the client?
Which loader does CWhitelist use?
What should be checked when the API connection fails?
In the catalog
cwhitelist is one of 8,499 Technology mods on ModsFinder, and one of 3,557 Technology mods for NeoForge. 8,071 mods support Minecraft 26.3.
More from SkyDreamLG
Similar mods
What the author says
🔒 Intelligent Whitelist System with API Integration for Modern Minecraft Servers Solution: Verify API server is running and accessible. Check network connectivity and firewall settings.
Official listing
- Modrinth page
- modrinth.com/mod/cwhitelist
- Owner
- SkyDreamLG
- Published
- 2025-02-12
- Updated on Modrinth
- 2026-10-02
- Facts verified
- 2026-10-15