Links
Tags
Creators
Details
Licensed MIT
Published 6 months ago
Updated 6 months ago
All versions
1.0.0-beta.1
Beta
GeoBlock 1.0.0-beta.16 months ago 78
Compatibility
Minecraft: Java Edition
26.1.2
Platforms
Paper
Purpur
Changes
GeoBlock 1.0.0-beta.1 — first public beta
Initial release. All core features present, in beta channel until real-world feedback validates them as stable.
Features
- Country filtering in blacklist or whitelist mode (ISO 3166-1 alpha-2)
- IP and UUID bypass list with full IPv4/IPv6 CIDR support
- Free GeoIP through db-ip.com — no account required (CC-BY 4.0)
- Optional MaxMind GeoLite2 provider (free account, weekly updates)
- LuckPerms integration with
/opfallback - Async Discord webhook for connection denials and lookup failures
- Hot reload via
/geoblock reload, on-demand database refresh via/geoblock update
Notes
- The db-ip database is refreshed once per month upstream; the plugin auto-falls back to the previous month if the new file is not yet published
- Discord webhook is fully optional and granular (per-event toggle, IP hiding)
Requirements
- Paper or Purpur 1.21.x (API target 26.1.2)
- Java 25
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:ernJj3m9:S8To2MAh"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:ernJj3m9:S8To2MAh"
}
