NetwatchZ

⭐ — (2 endorsements) 📥 364 downloads 📌 v1.1.1 📅 9/29/2025
🟡 Updated this year

By KartoffelChipss · management

⬇ Download Mod Source: Modrinth ↗ 📅 Updated: 9/29/2025 📅 Created: 9/29/2025

🔍 Analysis

  • 🏆 #164 of 171 management mods in this game by downloads

📋 About This Mod

✅ ✅ IP lookup (e.g. Geolite2, ip-api.com)
✅ ✅ IP blacklists
✅ ✅ Dynamically fetch IP lists
✅ ✅ Geoblocking
✅ ✅ Configure any IP information service
✅ ✅ Automatically download and refresh Geolite2 database

!(https://cdn.modrinth.com/data/cached_images/074c056c721895b3f579093a106515ef471abf4b.png)

!(https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/supported/spigot_vector.svg) !(https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/supported/paper_vector.svg) !(https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/supported/purpur_vector.svg) !(https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/supported/velocity_vector.svg) [!(https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/github_vector.svg)](https://github.com/ZetaPlugins/NetwatchZ) [!(https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/modrinth_vector.svg)](https://modrinth.com/plugin/netwatchz) [!(https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/social/discord-plural_vector.svg)](https://strassburger.org/discord) [!(https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/documentation/gitbook_vector.svg)](https://docs.zetaplugins.com/netwatchz)

NetwatchZ is a Minecraft plugin for Spigot, Paper, and Velocity that helps protect your server against bots and other malicious activity through IP blocking, geoblocking, and VPN detection.

## Features

  • ✅ IP lookup (e.g. Geolite2, ip-api.com)
  • ✅ IP blacklists
  • ✅ Dynamically fetch IP lists
  • ✅ Geoblocking
  • ✅ Configure any IP information service
  • ✅ Automatically download and refresh Geolite2 database
  • ✅ VPN blocking (e.g. vpnapi.io, proxycheck.io)

## Permissions

  • `netwatchz.ipinfo` - Get the IP and IP information from a player
  • `netwatchz.admin.debug` - Generate debug reports

## Configuration

You can find the configuration files in the plugins/NetwatchZ folder. The main configuration file is config.yml.

config.yml

```yml # # _ _ _ _ _ ______ # | \ | | | | | | | | |___ / # | \| | ___| |___ ____ _| |_ ___| |__ / / # | . ` |/ _ \ __\ \ /\ / / _` | __/ __| '_ \ / / # | |\ | __/ |_ \ V V / (_| | || (__| | | | / /__ # |_| \_|\___|\__| \_/\_/ \__,_|\__\___|_| |_| /_____| #

# Set the language to any code found in the "lang" folder (don't add the .yml extension) # You can add your own language files. Use https://github.com/ZetaPlugins/NetwatchZ/tree/main/src/main/resources/lang/en-US.yml as a template # If you want to help translating the plugin, please refer to this article: https://docs.zetaplugins.com/localization # | en-US | de-DE | lang: "en-US"

# If set to true, OP players will always be allowed to join always_allow_ops: true

ip_list: # Enable or disable the IP list feature. enabled: true

# If the mode is "blacklist", the IPs in the lists will be blocked. # If the mode is "whitelist", only the IPs in the lists will be allowed. mode: "blacklist"

# Set the list of IPs or CIDR ranges to block or allow. # These are files inside the "plugins/NetwatchZ/ipLists" folder. lists: - "vpn_list.txt" # - "another_list.txt"

fetch_jobs: vpn_list: # Set the URL to fetch the IP list from. url: "https://raw.githubusercontent.com/X4BNet/lists_vpn/refs/heads/main/output/vpn/ipv4.txt"

# Set the filename to save the fetched list as. This file will be saved in the "plugins/NetwatchZ/ipLists" folder. filename: "vpn_list.txt"

# Set how often the list should be fetched (in hours). # The minimum is 1 hour. update_interval_hours: 24

# You can add more fetch jobs here. e.g. # another_list: # url: "https://example.com/another_list.txt" # filename: "another_list.txt" # update_interval_hours: 12

geo_blocking: # Enable or disable geo-blocking. enabled: false

# Wether or not the following list should be a blacklist or a whitelist. # If set to true, the countries in the list will be blocked. # If set to false, only the countries not in the list will be blocked. blacklist: true

# Set the list of countries to block or allow. # The format of the country code depends on the IP info provider, but usually it is a two-letter country code (ISO 3166-1 alpha-2). # Example: ["US", "CA", "GB"] countries: []

ip_info_provider: # Set the IP info provider to use. # Possible values are: # - "ip-api" (https://ip-api.com) # - "ipwhois" (https://ipwhois.app) # - "geolite2" (MaxMind GeoLite2 databases - recommended) # - "custom" (Uses the custom IP info provider defined below) provider: "ip-api"

geolite2: # Set the urls to the GeoLite2 databases. These are refreshed automatically every 7 days. # These can be links to tar.gz files of the official MaxMind GeoLite2 databases with your license key included or links to your own hosted databases (downloading .mmdb files directly is also supported). # You can get a free

🤖 AI-enhanced — based on mod data

📊 Mod Details

Game
Minecraft Plugins
Author
KartoffelChipss
Version
1.1.1
Downloads
364
Endorsements
2
Category
management
Created
9/29/2025
Updated
9/29/2025
Game Versions
1.17, 1.17.1, 1.18, 1.18.1, 1.18.2
Tags
management, technology, utility

🔧 How to Install Minecraft Plugins Mods

Download from Modrinth. Use Prism Launcher or drop into your mods folder.

📖 Full step-by-step install guide for Minecraft Plugins →

Visit the official mod page for specific installation instructions for this mod.

🎮 Need cheat codes or console commands? Check ur gaming wiki for Minecraft Plugins commands, item IDs, and more.

❓ Frequently Asked Questions

Which Minecraft Plugins versions does NetwatchZ support?

The author lists 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19. Other versions may work but are untested by the author.

What is the latest version of NetwatchZ?

Version 1.1.1, published 2025-09-29 with 364 downloads recorded at the source.

Keep browsing — more Minecraft Plugins mods await

📋 All Minecraft Plugins Mods 🏆 Top 25 📂 More management 👤 More by KartoffelChipss 🔎 Similar Mods 🌐 Best management (All Games) 🔀 Check Compatibility ⚖️ Compare Mods 🆕 New Mods