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 ✨

```yaml

_________ _____.__

_ ___ ____ _____/ ______| ____

/ / / _ / __| |/ ___

___( <> ) | | | / // >

______ /____/|___| /__| |_____ /

/ / /_____/

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

```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>" ``` ---