Bye Bye Blacklist
Every time you click Join Server in Minecraft, the game quietly checks that address against Mojang's blocked-server list before the connection even starts. If the host appears there, the client refuses to connect, and you are left staring at an error with no way around it. Bye Bye Blacklist is a lightweight client-side mod that wraps that check and lets you reach the hosts you have explicitly chosen, without touching anything else about how the game connects.
This is a focused tool, not a server browser overhaul. It does one job, does it cleanly, and stays out of your way. If you have ever wondered why a perfectly working server refuses to appear in your multiplayer list, this mod is the answer.
What Bye Bye Blacklist Actually Does
Minecraft performs a client-side address check before connecting. Bye Bye Blacklist hooks that specific check. For hosts selected by your policy, the vanilla blocklist result is overridden to "allowed." That is the entire mechanism. The mod does not modify the server, the network protocol, or your server list entries.
It is worth being clear about the limits. The server still applies its own access rules, whitelists, and bans. This mod only affects the client-side gate that Mojang controls. Nothing about the actual connection changes beyond that one check.
Key Features at a Glance
- Client-side only: install it on your client, and nothing is needed on the server.
- Configurable allowlist supporting exact host names and *.subdomain patterns.
- Optional remote allowlist that refreshes in the background for hosts that change over time.
- One universal jar that runs on both Fabric and NeoForge.
- No GUI, no commands, and no extra libraries beyond the loader itself.
Supported Minecraft Versions and Loaders
Bye Bye Blacklist for Minecraft ships as a single universal jar that works on both Fabric and NeoForge. Supported versions are Minecraft 1.21.1, Minecraft 26.2, and Minecraft 26.3. Always use the jar that matches your Minecraft version.
Loader and Java Requirements
- Fabric Loader 0.16.14+ for 1.21.1, 0.20.1+ for 26.2, and 0.19.5+ for 26.3.
- NeoForge 21.1.235+ for 1.21.1, 26.2.0.93+ for 26.2, and 26.3.0.95+ for 26.3.
- Java 21 for 1.21.1 and Java 25 for the 26.x releases.
Fabric API is not required, which keeps your mods folder tidy. If you manage multiple instances, the foxygame.net launcher makes short work of it: its built-in add-on catalog handles Bye Bye Blacklist installation in one click and keeps version compatibility in check automatically, so you never have to hunt for the right jar.
How to Install Bye Bye Blacklist
Installation is intentionally simple, and there is no setup wizard to fight through.
- Confirm your Minecraft version and loader match the requirements above.
- Download Bye Bye Blacklist and place the jar in your mods folder.
- Launch the game once. The mod writes config/byebyeblacklist.json on first start.
- Edit the config to add your hosts, then restart the game.
Local changes take effect on the next launch. A successful remote refresh, by contrast, applies immediately.
Configuring the Allowlist
The generated config file contains four settings worth understanding:
- allowAll: when true, every server is allowed regardless of the allow list.
- allow: exact host names like example.com or suffix patterns like *.example.com. A literal asterisk allows every server.
- remote.url: an optional HTTPS endpoint returning either a JSON array of hosts or an object with an allow array and an optional allowAll boolean. Remote entries are merged with your local allow list.
- remote.refreshMinutes: minutes between remote refreshes, with a minimum of one.
The default configuration allows 6b6t.org and its subdomains, so the mod is useful out of the box for that community. Keep the file readable and back it up if you maintain a large list of hosts.
Final Thoughts
Bye Bye Blacklist is a small, honest utility with a narrow purpose: it gives you control over the client-side check that stands between you and a server you have deliberately chosen. It is unofficial and unaffiliated with Mojang, Microsoft, or any server, so use it at your own risk and respect the rules of the servers you join. If you want a no-fuss way past the blocklist without extra libraries or menu clutter, download Bye Bye Blacklist, drop it in your mods folder, and get back to playing.