!banner

📌 xBlocker Description

Example #1

!example1

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/.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/.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/.yml->disconnect.incompatible (por jugador).

Este texto queda como FALLBACK si desactivas i18n.

message: "✖ Servidor/cliente no coinciden. Usa %server_version%"

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

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

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

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

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

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

## ✨ Messanges / ES and EN

```yaml
#   _____   ____   ____   ___________      |__| ____   ______
#  /     \_/ __ \ /    \ /  ___/\__  \     |  |/ __ \ /  ___/
# |  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>"

---