xBlocked

📌 xBlocker Description

Example #1

xBlocker is the ultimate plugin to control and customize the connection experience on your Minecraft server, designed for admins who want professionalism, flexibility, and full compatibility.

🔹 Version Management: Set a minimum allowed protocol (e.g. from 1.16.5 upwards) and block outdated or incompatible clients with clear, customized messages.

🔹 Custom Messages:

Server List (Ping) text to inform players about unsupported versions.

Unique disconnection screens, with dynamic placeholders like %server_version%.

Full integration with i18n (multi-language): messages automatically adapt to the player’s locale.

🔹 Internationalization (i18n): Multi-language system with support for Spanish, English, and Portuguese, among others. The plugin detects the client’s locale and shows the appropriate translation.

🔹 Compatibility & Performance:

Optimized IP → protocol caching.

Works on Spigot, Paper, and forks (for MOTD).

Proxy support (BungeeCord / Velocity) through xMotd integration.

🔹 Extra Tools for Admins:

Built-in Modrinth update notifier.

Optional usage stats via bStats.

Advanced debug mode for testing and troubleshooting.

✨ With xBlocker you gain total control over how your server appears in the client list and how version mismatches are handled — all with a professional, multi-language, hassle-free experience.

✨ Config.yml ✨

#   _________                _____.__
#  \_   ___ \  ____   _____/ ____\__| ____
#  /    \  \/ /  _ \ /    \   __\|  |/ ___\
#  \     \___(  <_> )   |  \  |  |  / /_/  >
#   \______  /\____/|___|  /__|  |__\___  /
#        \/            \/        /_____/
#  Hecho con amor por 777 Studios - xPlugins
#
# Wiki y informacion: https//xblocker.willfry.net/

# =========================
# I18N (MULTI-LENGUAJE)
# =========================
i18n:
  enabled: true                 # true = usar bundles /messages/*.yml
  default-lang: "es_ES"         # idioma por defecto
  # PLAYER_LOCALE_THEN_DEFAULT: usa el locale del cliente; si no, default
  # FIXED: fuerza el idioma en fixed-lang
  mode: "PLAYER_LOCALE_THEN_DEFAULT"
  fixed-lang: "es_ES"           # usado si mode=FIXED
  ping-lang: "es_ES"            # idioma para PING/MOTD (no hay Player)
  # Mapeos para normalizar locales reportados (ej. es -> es_ES)
  locale-map:
    es: "es_ES"
    en: "en_US"
    pt: "pt_BR"

# =========================
# Notificador de Actualizaciones (Modrinth) (No tocar)!!
# =========================
updates:  # (No tocar)!!
  modrinth: # (No tocar)!!
    enabled: true # (No tocar)!!
    project: "xblocked" # (No tocar)!!
    # Comprobar cada X horas (>=1)
    check-interval-hours: 1 # (No tocar)!!
    notify: # (No tocar)!!
      console: true
      admins-on-join: true
      permission: "xblocked.update"

# =========================
# bStats (No tocar)!!
# =========================
bstats:
  enabled: true
  plugin-id: 27316

#  --- Compatibilidad de versiones ---
# Protocolo mínimo permitido (735 = MC 1.16.5; 763 = 1.20.1; 769 = 1.21.1, etc.)
min-protocol: 735

# Texto que se muestra a la DERECHA en la lista de servidores cuando
# el cliente es más antiguo que min-protocol o no coincide con el servidor.
# Se procesa con el mismo formato indicado en motd.format (auto/legacy/mini).
# NOTA: si i18n.enabled=true, se usará messages/<lang>.yml -> serverlist.incompatible.
# Este texto queda como FALLBACK si desactivas i18n.
incompatible-message: "&c ✖️ ¡Oye! 1.19.4 - 1.21x"

# --- Caché IP -> protocolo detectado (handshake) ---
cache-ttl-seconds: 45     # Tiempo de vida de la entrada
cache-soft-limit: 1000    # Límite suave de entradas (limpieza si se excede)

# Motd ( Solo para Spigot x paper ) Para velocity/bungee Usa xMotd
motd:
  enabled: false          # true para habilitar el MOTD personalizado
  format: auto            # auto | legacy | mini
  center: true            # centra cada línea (approx. por caracteres)
  center-width: 50        # ancho usado para el centrado
  # Si i18n.enabled=true y existe messages/<lang>.yml->motd.*, se prioriza ese contenido.
  line1: "&cxBlocked &7| &fLobby"
  line2: "&f¡Bienvenido!"

# --- Mensaje de desconexión en LOGIN (Outdated server/client) ---
disconnect:
  enabled: true
  # Si es true, solo reemplaza mensajes tipo “Outdated …”.
  # Si es false, reemplaza cualquier kick de login por este mensaje.
  only-on-version-mismatch: true
  format: auto            # auto | legacy | mini
  # Placeholders disponibles:
  #   %server_version%  -> versión del servidor (ej: git-Paper-196 (MC: 1.20.1))
  # Si i18n.enabled=true, se usa messages/<lang>.yml->disconnect.incompatible (por jugador).
  # Este texto queda como FALLBACK si desactivas i18n.
  message: "<red>✖ Servidor/cliente no coinciden.</red> <gray>Usa</gray> <white>%server_version%</white>"

####  ##### ####  #   # ####   ###   #### #####  ###  #   #
#   # #     #   # #   # #   # #   # #       #   #   # ##  #
#   # ##### ####  #   # ####  ##### #       #   #   # # # #
#   # #     #     #   # #  #  #   # #       #   #   # #  ##
####  ##### #      ###  #   # #   #  #### #####  ###  #   #

debug: true               # logs de handshake/ping/disconnect
debug-force-incompatible: false  # fuerza el estado incompatible para 

✨ Messanges / ES and EN

#   _____   ____   ____   ___________      |__| ____   ______
#  /     \_/ __ \ /    \ /  ___/\__  \     |  |/ __ \ /  ___/
# |  Y Y  \  ___/|   |  \\___ \  / __ \_   |  \  ___/ \___ \
# |__|_|  /\___  >___|  /____  >(____  /\__|  |\___  >____  >
#           Hecho con amor por 777 Studios - xPlugins
# Usa colores HEX (<#RRGGBB>) o de Minecraft (&a, &b, etc.)
meta:
  name: "English (US)"
  version: 1

serverlist:
  incompatible: "<red>✖ Your version is not supported.</red> <gray>Please use</gray> <white>%server_version%</white>"

disconnect:
  incompatible: "<red>✖ Server/client mismatch.</red> <gray>Please use</gray> <white>%server_version%</white>"

motd:
  line1: "<gradient:#00C6FF:#0072FF>GhostBlocker</gradient>"
  line2: "<gray>Professional connection control</gray>"

admin:
  reloaded: "<green>Config reloaded.</green>"

---

🔥 Partner 10% discount on your purchases on Website