Bye Bye Blacklist
A client-side Fabric and NeoForge mod that lets you connect to Minecraft servers that Mojang has placed on its blocked-server list.
Minecraft checks every server address against Mojang's blocklist before connecting. Bye Bye Blacklist wraps that check and allows the hosts you configure, without changing anything else about the connection. The server still applies its own access rules.
Features
- Client-side only. Install it on the client; nothing is needed on the server.
- Configurable allowlist with exact hosts and
*.subdomain patterns. - Optional remote allowlist, refreshed in the background, for hosts that change over time.
- One universal jar for Fabric and NeoForge.
- No GUI, no commands, and no extra libraries beyond the loader.
Supported versions
- Minecraft 1.21.1
- Minecraft 26.2
- Minecraft 26.3
Use the jar that matches your Minecraft version. The universal jar works on both Fabric and NeoForge.
Requirements
- Fabric Loader 0.16.14+ for 1.21.1, 0.20.1+ for 26.2, 0.19.5+ for 26.3
- NeoForge 21.1.235+ for 1.21.1, 26.2.0.93+ for 26.2, 26.3.0.95+ for 26.3
- Java 21 for 1.21.1, Java 25 for 26.x
Configuration
The first launch writes config/byebyeblacklist.json:
{
"allowAll": false,
"allow": ["6b6t.org", "*.6b6t.org"],
"remote": {
"url": "",
"refreshMinutes": 60
}
}
allowAll- when true, every server is allowed regardless ofallow.allow- exact host names (example.com) or suffix patterns (*.example.com). A literal*also allows every server.remote.url- optional HTTPS endpoint returning either a JSON array of hosts or an object with anallowarray and an optionalallowAllboolean. Remote entries are merged withallow.remote.refreshMinutes- minutes between remote refreshes (minimum 1).
The default configuration allows 6b6t.org and its subdomains. Local changes take effect on the
next launch. A successful remote refresh applies immediately.
How it works
The mod hooks the client-side address check Minecraft performs before connecting. For hosts selected by the policy, the vanilla blocklist result is overridden to "allowed". It does not modify the server, the network protocol, or the server list.
Original code and build tools
All mod code in this project is original. No Minecraft source code is included, copied, or redistributed; the mod compiles against the official Minecraft artifacts supplied by the mod loaders. No AnarchyMod source code, binaries, or assets are used.
Built with Gradle 9.5.1, Fabric Loom 1.9.2/1.17.21, NeoGradle userdev 7.1.38, ModDevGradle 2.0.148, Java 21/25 toolchains, Fabric Loader, NeoForge, Mixin, and Gson. Release tooling uses Python 3. Fabric API is not required.
Inspiration and credits
This mod was inspired by AnarchyMod, a client mod that bypasses Mojang's blocked-server list for the 6b6t community.
No AnarchyMod source code, binaries, or assets are used in this project. The implementation here was written independently.
Disclaimer
This is an unofficial community mod. It is not affiliated with Mojang Studios, Microsoft, or any Minecraft server. Use it at your own risk and follow the rules of the servers you connect to.
License
MIT