InvalidPlayerBypassList

Goal

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.

How It Works

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.

Commands

You can manage the bypass list directly using Minecraft server commands:

/bypasslist add <player> [ip]

• Adds a player (with optional IP) to the bypass list.
• If IP checking is enabled, the IP must be provided.

/bypasslist remove <player> [ip]

• Removes a specific player from the bypass list.
• If the IP is not provided, all entries for the player will be removed.

/bypasslist list

• Lists all current entries in the bypass list with their associated IPs.

/bypasslist on

• Enables the bypass list at runtime.

/bypasslist off

• Disables the bypass list at runtime.

All commands require a permission level of 2 or higher (e.g., server operators).

Config

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

Use Cases

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

Reporting Issues

If you find a bug or want to request a feature:

1. Go to the Issues tab of the repository.
2. Click New Issue.
3. Use the appropriate template (Bug Report or Feature Request).
4. Fill in all relevant details.
5. Submit the issue.