Yowsef Flags

How it works
Try this product in game with a hosted Minecraft server!
1. Click 'Request test server'
2. Join the provided IP address
3. Try out the product for up to 30 minutes
4. Stop the server when you're done
Requesting a test server will duplicate the original files and provide you a new server for you to join and experiment with for up to 30 minutes. Any changes you make will not be served so feel free to play around!

There are no limits to the number of servers you may start, but you can only have one test server active at a time. You must stop any active test servers in order to start up a new one.
Features
- Completely free
- Instant setup
- Full operator permissions
- Invite friends
- No usage limits
Testing servers provided by PebbleHost.
Visit PebbleHost.com

YowsefFlags - The Ultimate Geolocation Country Flags Plugin

Make your server truly global and visually stunning! YowsefFlags is a premium, high-performance Minecraft plugin that displays players' real-time country flags in chat, tablists, nametags, scoreboards, and more based on their IP address geolocation.

Designed with high-traffic servers in mind, it operates entirely asynchronously with zero overhead, ensuring absolute maximum server performance.

Key Features

Automatic Resource Pack Generation
The holy grail of custom flags! Drop any .png flag image (e.g. US.png, EG.png) into the plugin folder, and YowsefFlags will automatically compile them into a custom, optimized, server-side resource pack. Players will see pixel-perfect custom flags in chat and menus!

Zero Performance Overhead
IP geolocations are fetched asynchronously on join and cached locally. Absolutely no impact on server TPS.

Universal PlaceholderAPI Integration
Works natively with all your favorite plugins. Display flags anywhere PAPI is supported (TAB, LuckPerms prefixes, EssentialsX chat, ChatControl, DeluxeChat, CMI, etc.).

Smart Image Downscaling & Compatibility
Built-in support for rendering-optimized flag dimensions (11x11 pixels) for maximum compatibility with performance mods like Sodium, EntityCulling, and Essential Mod, preventing any black boxes or blank symbols.

Privacy-First Design
Features a permission-based bypass allowing players to hide their flag, or toggle flag visibility globally or individually.

Complete Country Coverage
Automatic fallback to standard Unicode Regional Indicator symbols (flag emojis) if no custom texture exists.

Instant Setup Guide (3 Simple Steps)

1. Drop YowsefFlags.jar into your plugins/ directory.
2. Make sure PlaceholderAPI is installed on your server.
3. Restart your server and you are ready to customize!

How the Custom Texture Pack Feature Works

YowsefFlags makes setting up high-definition custom flags incredibly easy:
1. Put your desired flag PNGs into the plugins/YowsefFlags/flags/ directory.
2. Name each file with its standard 2-letter ISO country code (e.g., US.png, EG.png, DE.png).
3. Run /yflags reload.
4. The plugin automatically compiles a custom resource pack, generates a new secure SHA-1 hash, and serves it to players. Perfect, seamless, and automated!

TIP: Standard country flags are rendered beautifully in chat at 11x11 or 22x22 pixels for a sleek, compact, and modern look.

PlaceholderAPI Placeholders

Use these placeholders in any plugin (TAB, LuckPerms, EssentialsX, etc.) to show custom flags or country details:

%yowsefflags_flag% ➡ Custom/Unicode Flag (e.g.,

)
%yowsefflags_code% ➡ 2-Letter Country Code (e.g., US)
%yowsefflags_flag_code% ➡ Combined Flag + Code (e.g.,

US)
%yowsefflags_code_flag% ➡ Combined Code + Flag (e.g., US

)
%yowsefflags_flag_EG% ➡ Static Flag lookup (e.g.,

)
%yowsefflags_cached% ➡ Cache state (e.g., true)

Chat & Tablist Examples
TAB Plugin Config: playerlist-objective-value: "%yowsefflags_flag% %player%"
LuckPerms Prefix: /lp user <player> meta setprefix "%yowsefflags_flag% "
EssentialsX Chat Format: format: "%yowsefflags_flag% {DISPLAYNAME}: {MESSAGE}"

Commands & Permissions

YowsefFlags comes with a simple and intuitive command suite.

Commands
/yowsefflags reload - Instantly reload configurations and regenerate resource packs.
/yowsefflags info - Show current version and count of loaded custom flags.
/yowsefflags lookup <player> - Check a player's detected flag and IP lookup.
/yowsefflags setflag <player> <code> - Override a player's flag manually.
/yowsefflags clearflag <player> - Reset and clear a player's cached flag.
Command aliases: /yflags and /yf are available.

Permissions
yowsefflags.admin - Full access to all administrative commands. (Default: OP)
yowsefflags.see - Permission to view country flags. (Default: true)
yowsefflags.bypass - Allows a player to hide their country flag from being displayed. (Default: false)

Premium Configuration Options

YAML:

# ======================================================
#            YowsefFlags Premium Configuration
# ======================================================

enabled: true

# ============================================================
#  RESOURCE PACK (Built-in Auto-Hosting)
# ============================================================
resource-pack:
  auto-host: true           # Automatically hosts the pack on a built-in web server!
  server-ip: ""             # Your server's public IP (auto-detected if blank)
  server-port: 8765         # The port for the pack host (must be open)
  required: false           # Require players to accept the pack or get kicked
  prompt: "&6YowsefFlags &7— Country flag textures"
  pack-format: 34           # Compatible with modern versions (1.20 - 1.21+)
  glyph-height: 10          # The vertical height of the flag in chat
  glyph-ascent: 9           # The baseline height alignment

# ============================================================
#  DISPLAY
# ============================================================
display:
  tablist: true
  chat: true
  nametag: true

# ============================================================
#  GEOIP CACHING & API
# ============================================================
geoip:
  enabled: true
  cache-duration: 30        # Cache player IP results for 30 minutes to reduce API limits
  api-endpoint: "http://ip-api.com/json/{ip}?fields=countryCode"

# ============================================================
#  OVERRIDES & FALLBACKS
# ============================================================
custom-flags:
  yowsef: EG                # Manually force a country code for specific players

default-flag: "NONE"        # Fallback flag when a country cannot be detected (e.g. "US" or "NONE")

# ============================================================
#  PRIVACY & PERMISSIONS
# ============================================================
permissions:
  require-permission: false # Require 'yowsefflags.see' to view flags
  permission-node: "yowsefflags.see"
  allow-bypass: true        # Let players hide their flags using 'yowsefflags.bypass'

# ============================================================
#  CUSTOMIZABLE MESSAGES
# ============================================================
messages:
  reload-success:   "&aYowsefFlags reloaded successfully!"
  lookup-result:    "&aPlayer &e{player} &ais from &e{country} &a{flag}"
  lookup-unknown:   "&aCountry for &e{player} &acould not be determined."

How to get my license ?

1 - sync your discord account in BBB to get Customer role.
2 - go to cmd channel and type /generate.
3 - Our discord bot will dm your license.
Note : If you did the command multiple times only last key will be work ![/SIZE][/FONT]

Need Support or Have Questions?
Join our official Discord server for fast support, bug reports, and feature requests!

CLICK HERE TO JOIN DISCORD

Yowsef Flags v1.2

Overview Dependencies Updates (2) History Discord Server

How it works

Features