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> ` * Adds a player (with optional IP) to the bypass list. * If IP checking is enabled, the IP must be provided. ### `/bypasslist remove <player> ` * 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 (https://github.com/TheMisterFish/Fabric_InvalidPlayerBypassList/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.