Skip to content

TCPShield

A simple configurable IP allowlist. Made for servers using TCPShield.

FabricNeoForgeForge
Loaders
FabricNeoForgeForge
Downloads on Modrinth
1.4K
Followers on Modrinth
8
versions
7
Updated
July 25, 2026Jul 25
Published
in 2024

At a glance

Runs on Fabric, NeoForge and Forge
For Minecraft 1.20–26.2
Server only — players don't need to install it
Latest version — 2.0.0-neoforge-1.20.5-26.2 from July 25, 2026
License GPL-3.0-or-later — free
Where it's needed
In gamenot neededOn serverrequired

Install on the server only; players don't need it

Game versions1.20–26.2

TCPShield

A server-side mod that blocks direct connections to Minecraft servers behind TCPShield.

It downloads TCPShield's IP ranges at startup and closes connections from addresses outside the allow-list before the Minecraft handshake.

Configuration

While made to work with TCPShield, you can use this as a general ip allow-list

source.1=https://tcpshield.com/v4/
source.2=https://tcpshield.com/v4-cf/

allow-insecure-http=false
cache-max-age-hours=168
connect-timeout-ms=5000
request-timeout-ms=10000
minimum-ipv4-prefix=8
minimum-ipv6-prefix=16

Add trusted addresses or CIDRs with allow.* entries:

allow.1=127.0.0.1/32
allow.2=10.20.0.0/16
allow.3=2001:db8:1234::/48

Custom source.* URLs may also be used. Each source must return plain text with one numeric IP or CIDR per line. Remove the default sources if you want a manual-only allow-list.

This mod was made primarily for personal use. It is not a replacement for an actual firewall. Netty channels are as early as a mod can realistically block connections, but you know.. you should probably use an actual firewall when possible.

This project is not endorsed by or affiliated with the TCPShield service. The TCPShield logo and trademark used in the project icon and name are the intellectual property of DatPixel Entertainment, Inc.

FAQ

How to install TCPShield?

Install Fabric for your Minecraft version, download TCPShield for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does TCPShield support?

TCPShield has builds for Minecraft 1.20–26.2.

Is TCPShield needed on the server?

Server only — players don't need to install it

License and source
GNU General Public License v3.0 or laterfree to use and share; changes to the mod itself must be published under the same license
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More