Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for Axxtrial

Fast GeoIP multi-language MOTD and dynamic server icons with RAM caching.

Report GeoMOTD?

GeoMOTD Banner

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 (<gradient:#hex:#hex>), 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)

Information

Category
Admin Tools
Published
November 7, 2026
License
0Downloads
0Stars
Supports Folia

Pinned Versions

  • R
    Paper1.20–26.3Waterfall1.20–1.21Velocity4.0.0–4.3.1

Members

1