InvalidPlayerBypassList
No reviews yet
InvalidPlayerBypassList allows specific players - added to a configurable bypass list - to join a server even when online-mode is set to true, without passing Mojang authentication.
Fabric is a mod loader for versions 1.14+ of Minecraft, particularly popular for client side and optimization mods.
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
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
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
2or 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:
- 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.
Screenshots
Gallery
-
Bypass list enabled After the bypass list is enabled and the test user with ip was added, the user can join with a invalid account while online-mode is set to true. -
Bypass list disabled When the bypass list is disabled, the user cannot join with a invalid account.
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