GeoMOTD

GeoMOTD

Fast GeoIP Multi-Language MOTD & Dynamic Server Icons

GeoMOTD detects the player's country upon server list ping and automatically serves localized MOTD lines and server icons in their native language with millisecond response times.

Features

• Location Detection: Automatically detects players from 220+ countries upon server ping.
• Dynamic Server Icons: Displays custom icons per language, country, or specific MOTD entry.
• MiniMessage Formatting: Full support for modern RGB hex gradients (``), colors, rainbow, and bold styling.
• Zero Lag & RAM Caching: High-performance RAM cache eliminates disk I/O on ping requests.
• Random MOTD Rotation: Configure multiple MOTDs per language that rotate randomly on server list refresh.
• Automatic Database Setup: Automatically downloads and updates the GeoLite2 database on first launch.
• Hot-Reloading: Reload all configurations, messages, icons, and cache in real-time without restarting the server.

Supported Platforms

• Paper / Purpur: 1.20 - 1.26+
• Folia: Native regionized multi-threading support
• Velocity Proxy: Modern proxy support
• BungeeCord / Waterfall: Legacy proxy support

Proxy Builds (Velocity & BungeeCord):

Looking for the Velocity or BungeeCord proxy versions? You can download them directly from GitHub Releases.

PlaceholderAPI Placeholders

Placeholder · Description
%geomotd_country_code% · Player's ISO-2 country code (e.g., US, ES, MX)
%geomotd_language% · Resolved language code (e.g., en, es, pt)
%geomotd_cache_size% · Total cached IP addresses in memory
%geomotd_cache_hit_rate% · In-memory cache hit rate percentage

Commands & Permissions

• /geomotd reload - Reloads configuration, messages, icons, and database cache.
• /geomotd status - Displays live engine diagnostics, database status, and cache metrics.
• /geomotd help - Shows available plugin commands.

Permission: geomotd.admin (Default: OP)