Links
Tags
Creators
Details
Licensed MIT
Published 6 months ago
Updated 7 months ago
All versions
1.0.0
Release
GeoPlugin 1.0.07 months ago 110
Uploaded by
Compatibility
Minecraft: Java Edition
1.21.x
1.20.x
Platforms
Paper
Purpur
Spigot
Changes
Changelog
1.0.0 - 2026-04-07
Added
- Core GeoIP detection using local database (
countries.mmdb). - Country access control system with
whitelist/blacklistmodes. - VPN/Proxy detection via proxycheck.io with login-time checks and optional blocking.
- Country statistics tracking (total connections + unique players by country).
- Admin notifications for blocked joins, plus suspicious activity tracking.
- Discord webhook integration for block/suspicious events.
- Custom webhook integration for external automations.
- PlaceholderAPI integration (optional, auto-register when installed).
- Command suite:
help,reload,countrycheck,vpncheck,ip,list,stats,notify. - EN/ES language support with plural-aware messages.
- Paginated
/geoplugin listoutput and improved/geoplugin statsreadability. - Country/stats placeholders for scoreboards and HUDs.
- VPN bypass by player UUID (
vpn-detection.whitelist-player-uuids).
Improved
- Stronger config validation and clearer configuration comments.
- Better operational clarity around bypass permissions (
geoplugin.*,geoplugin.bypass,geoplugin.bypass.vpn). - Better compatibility testing coverage with standalone and proxy-based labs.
- Verified forwarding-based deployments with Velocity and Bungee-style setups.
Compatibility
- Designed for Spigot/Paper API (
api-version: 1.20). - Tested in local lab scenarios behind Velocity and Bungee-style proxies.
- PlaceholderAPI support is optional (
softdepend).
Removed
- In-session IP-change kick logic.
- VPN status placeholders (
is_vpn,vpn_type, and player-targeted VPN placeholders).
Optional dependencies
Any compatible version
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:y7rnOtRC:6gjmO7tr"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:y7rnOtRC:6gjmO7tr"
}

