xBlocked
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.
📌 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>"
