Download or build the .jar file and place it in the /mods/ folder of your Minecraft Fabric server directory.
⚠️ This mod is server-side only and will not run on the client.
You can download this mod from the GitHub Releases or Modrinth.
InvalidPlayerBypassList allows specific players to join a Minecraft server even when the server is in online mode, regardless of Mojang authentication. This is particularly useful for private testing, LAN setups, or fallback scenarios where certain usernames (and optionally IPs) should be allowed to bypass authentication checks.
This mod works only if the server is in online-mode=true, and it will intercept login attempts and allow access if the player's name and IP match entries in a configurable bypass list.
When a player tries to join the server, the mod checks if they are present in the bypass list. This list is defined by pairs of:
- Username
- Optional IP address
If IP enforcement is enabled via config, the player must match both the name and IP. Otherwise, just the name is sufficient if "none" is specified.
You can manage the bypass list directly using Minecraft server commands:
- Adds a player (with optional IP) to the bypass list.
- If IP checking is enabled, the IP must be provided.
- Removes a specific player from the bypass list.
- If the IP is not provided, all entries for the player will be removed.
- Lists all current entries in the bypass list with their associated IPs.
- Enables the bypass list at runtime.
- Disables the bypass list at runtime.
All commands require a permission level of
2or higher (e.g., server operators).
Configuration can be found under invalidplayerbypasslist.properties and includes the following settings:
| Property | Description | Type | Default |
|---|---|---|---|
ip-required |
If true, players must match both username and IP to bypass authentication. | boolean | true |
enforce-bypasslist |
If true, the bypass list is active on server startup. | boolean | true |
This mod is ideal for:
- Whitelisted development environments
- Testing servers with known usernames/IPs
- Offline access fallback while still in
online-mode - Controlled security bypass for known players
If you find a bug or want to request a feature:
- Go to the Issues tab of the repository.
- Click New Issue.
- Use the appropriate template (Bug Report or Feature Request).
- Fill in all relevant details.
- Submit the issue.
For mod development or building from source, please refer to the Fabric wiki setup guide for your IDE (IntelliJ, Eclipse, or VSCode).
This template is available under the CC0 license. Feel free to learn from it and incorporate it into your own projects.