Country Flags

Let players wear their nation's flag as a head cosmetic. ShyamDuels bundles player-head textures for every country below.

Commands

/countryflags              # Opens the flag selection GUI
/countryflags <country>    # Selects by full name or ISO code
/countryflags reset        # Resets to the default head
/flags flag <country>      # Alias syntax

All aliases (/countryflags, /countryflag, /flags, /country) require the shyamduels.country permission (default: all players). Selections persist per player and can be displayed in tab lists, scoreboards, and duels via the Country placeholders.

Auto-Detection

Resolution priority is cache → player_stats.country_code → player_country table → MaxMind GeoIP → UNKNOWN. Manual GUI selections are never overwritten by join resolves (country.update-on-join, default true). Private/loopback IPs are skipped, Velocity getClientAddress (with ::ffff: unwrap) is used behind proxies, and every change fires PlayerCountryChangeEvent (SELECT / RESET / GEOIP / JOIN_RESOLVE). Toggle visibility per player in /settings (flag-hidden set).

Supported Countries (224)

The list below contains the exact display names shown in-game. Each name can be used directly with /countryflags <name>, or its two-letter code: