Configuración de AuthMe
Configura el inicio de sesión y el registro para tu servidor y obtén líneas listas para config.yml con una explicación para cada uno.
Presets
Qué cambiar en config.yml: 0
Por ahora todo coincide con la configuración predeterminada. Elige un preset o cambia los ajustes de abajo, y las líneas para pegar aparecerán aquí.
Datos básicos
Idioma de mensajes y modo de cuenta
settings.messagesLanguageEl idioma que usa AuthMe para decir a los jugadores «regístrate» y «escribe tu contraseña». Inglés por defecto; para un servidor ruso pon ru.
settings.perPlayerLocaleCada jugador recibe los mensajes en el idioma de su juego, y el idioma de arriba se usa como alternativa.
settings.serverNameSe inserta en los mensajes y correos del plugin.
settings.enablePremiumLos jugadores con una cuenta oficial de Minecraft entran sin escribir contraseña, el resto como siempre. El plugin elige solo el método de verificación.
settings.preventOtherCaseSi Xephi está registrado, XEPHI y xephi no podrán entrar. Protege contra suplantaciones usando mayúsculas y minúsculas distintas.
Registro
Cómo crea un jugador una cuenta por primera vez
settings.registration.enabledDesactívalo y los jugadores nuevos no podrán crear una cuenta.
settings.registration.forceSin registrarse ni iniciar sesión el jugador no puede hacer nada. Las excepciones se configuran en la sección de restricciones de abajo.
settings.registration.typePASSWORD: el jugador elige su propia contraseña. EMAIL: se genera una contraseña y se envía al correo que indique.
settings.registration.secondArgNONE: la contraseña se escribe una vez. CONFIRMATION: hay que repetirla como segunda palabra. EMAIL_OPTIONAL y EMAIL_MANDATORY: el segundo argumento es un correo, opcional u obligatorio.
settings.registration.messageIntervalCon qué frecuencia repite el plugin el mensaje «inicia sesión o regístrate» al jugador.
settings.restrictions.maxRegPerIpCuántas veces se puede registrar desde una misma dirección. 0 significa sin límite. Uno es duro con quienes juegan juntos desde la misma casa.
settings.restrictions.registerTimeoutCuántos segundos tiene un jugador para registrarse. 0 significa no expulsar nunca.
settings.registration.forceLoginAfterRegisterTras registrarse correctamente el jugador debe iniciar sesión otra vez con el comando.
settings.registration.forceKickAfterRegisterEl jugador es expulsado justo después de registrarse para que vuelva a entrar. No lo actives junto con el requisito de /login de arriba.
Iniciar sesión
Qué pasa cuando un jugador escribe la contraseña
settings.restrictions.loginTimeoutCuántos segundos tiene un jugador para escribir la contraseña. 0 significa no expulsar nunca.
settings.restrictions.kickOnWrongPasswordEl jugador es expulsado del servidor justo tras un error. Ayuda contra la fuerza bruta pero molesta a los jugadores habituales.
settings.restrictions.kickNonRegisteredUn jugador sin cuenta es expulsado nada más entrar. Este es el modo de servidor privado.
settings.restrictions.ForceSingleSessionUn jugador conectado no puede ser expulsado por alguien que entre con el mismo nick («Logged in from another Location»). Cierra un agujero conocido de robo de sesión.
settings.restrictions.maxLoginPerIpCuántos jugadores pueden estar conectados desde una misma dirección. 0 significa sin límite.
settings.restrictions.maxJoinPerIpCuántas conexiones se permiten desde una misma dirección. 0 significa sin límite.
Sesiones
Para no escribir la contraseña tras cada desconexión
settings.sessions.enabledEl plugin recuerda el nick y la IP. Si el jugador se reconecta desde la misma dirección antes de que caduque, no se le pide contraseña.
settings.sessions.timeoutTras cuántos minutos se vuelve a pedir la contraseña. La sesión también termina cuando cambia la IP.
Antes de iniciar sesión
Qué puede hacer un jugador antes de introducir la contraseña
settings.restrictions.allowChatDesactivado significa que el invitado no puede chatear. Todos los comandos excepto los indicados abajo también se bloquean.
settings.restrictions.hideChatUn jugador que no ha iniciado sesión no puede ver el chat de otros jugadores.
settings.restrictions.allowCommandsTodo lo demás se bloquea. Quitar /login o /register de aquí deja a todos fuera.
settings.restrictions.allowMovementEl invitado puede moverse. El radio se define abajo.
settings.restrictions.allowedMovementRadiusCuánto puede alejarse un invitado desde el punto de entrada. 0 significa sin límite.
settings.restrictions.teleportUnAuthedToSpawnAntes de iniciar sesión el jugador permanece en el spawn, y al iniciar sesión vuelve a donde estaba. Así nadie puede espiar la base de otro desde su vista.
settings.restrictions.ProtectInventoryBeforeLogInEl invitado no puede ver el contenido de su inventario hasta que inicie sesión. Requiere PacketEvents.
Solo funciona con PacketEvents instalado, según la documentación del plugin.
settings.restrictions.DenyTabCompleteBeforeLoginEl invitado no puede espiar apodos ni comandos mediante el autocompletado. Requiere PacketEvents.
settings.applyBlindEffectHasta que el jugador inicie sesión, la pantalla se oscurece con el efecto Ceguera.
settings.restrictions.noTeleportAuthMe nunca mueve a los jugadores. Necesario si otro plugin gestiona los teletransportes y entran en conflicto.
Contraseña
Longitud, contraseñas prohibidas y método de almacenamiento
settings.security.minPasswordLengthLas contraseñas más cortas no se aceptarán.
settings.security.passwordMaxLengthEl límite superior de la longitud de la contraseña.
settings.security.passwordHashEl algoritmo de hash. BCRYPT y ARGON2 son deliberadamente lentos, lo cual es bueno: forzar la contraseña se vuelve costoso. Los demás valores de la lista son necesarios cuando la base de datos de contraseñas proviene de un motor de foro.
¿Cambias el algoritmo en un servidor activo? Añade el antiguo a settings.security.legacyHashes, si no, la gente no podrá iniciar sesión con sus contraseñas.
settings.security.unsafePasswordsEstas no se pueden usar como contraseñas. Escríbelas en minúsculas. Asegúrate de mantener help: la documentación advierte de un conflicto con el comando.
settings.restrictions.allowedPasswordCharactersUna expresión regular. El valor por defecto [!-~] significa todos los caracteres ASCII visibles, que es lo que recomiendan los autores.
Nombres de usuario
Qué nombres se permiten en el servidor
settings.restrictions.minNicknameLengthLos apodos más cortos no se admitirán.
settings.restrictions.maxNicknameLengthEl límite estándar de Minecraft es 16.
settings.restrictions.allowedNicknameCharactersUna expresión regular. El valor por defecto son letras latinas, dígitos y guion bajo, lo mismo que permite el propio juego.
Bots y fuerza bruta
Protección contra entradas masivas y adivinación de contraseñas
Protection.enableAntiBotEl plugin activa la protección por sí solo cuando entran demasiados jugadores en poco tiempo.
Protection.antiBotSensibilityCuántas entradas por intervalo cuentan como un ataque.
Protection.antiBotIntervalLa ventana de tiempo en la que se cuentan las conexiones.
Protection.antiBotDurationCuántos minutos sigue activa la protección después de activarse.
Protection.quickCommands.denyCommandsBeforeMillisecondsSi un comando llega antes de este tiempo tras conectarse, es un bot y el jugador es expulsado.
Security.captcha.useCaptchaTras varios intentos fallidos se muestra al jugador un código para introducir.
Security.captcha.maxLoginTryCuántos errores se permiten antes de solicitar un código.
Security.captcha.captchaLengthCuántos caracteres tiene el código.
Security.tempban.enableTempbanLa dirección se bloquea si se introduce una contraseña incorrecta desde ella demasiadas veces.
Security.tempban.maxLoginTriesCuántos errores tolera el plugin antes de banear la dirección.
Security.tempban.tempbanLengthCuántos minutos dura el ban temporal de la dirección.
Protection.enableProtectionEl inicio de sesión y el registro solo se permiten desde direcciones de la lista de países de abajo. Requiere una base de datos GeoIP.
Protection.countriesCódigos de país de dos letras. LOCALHOST es para iniciar sesión desde la propia máquina del servidor.
FAQ
¿Dónde pego estas líneas?
En el archivo plugins/AuthMe/config.yml del servidor. El generador solo muestra las claves modificadas, manteniendo su anidación: busca la misma ruta en tu archivo y pon el valor. No hace falta reemplazar el archivo entero, ya que tiene ajustes que no están aquí. Después de editar, reinicia el servidor o ejecuta /authme reload.
¿Cómo cambio el idioma de los mensajes del plugin?
Pon settings.messagesLanguage con el código de idioma que necesites, por ejemplo ru. El valor predeterminado es en, así que un AuthMe recién instalado habla con los jugadores en inglés. También existe settings.perPlayerLocale: cuando está activado, cada jugador recibe los mensajes en el idioma de su juego, y el valor de arriba se usa como respaldo.
Los jugadores se quejan de que tienen que escribir su contraseña tras cada desconexión
Activa las sesiones: pon settings.sessions.enabled en true y define settings.sessions.timeout, por ejemplo en 30 minutos. El plugin recuerda el apodo y la IP, y no pedirá la contraseña desde la misma dirección durante ese tiempo. La sesión termina si cambia la IP, y eso no se puede configurar.
¿Qué hago si el servidor sufre un ataque de bots?
El plugin tiene un antibot integrado: Protection.enableAntiBot está activado por defecto, y Protection.antiBotSensibility define cuántas conexiones por intervalo cuentan como ataque. Un captcha tras varios intentos de contraseña fallidos y un baneo temporal de la dirección por fuerza bruta también ayudan. El preset «Bajo ataque de bots» de arriba activa todo esto a la vez.
Cuidado con el filtro de países
Protection.enableProtection restringe la entrada a una lista de países, pero por defecto esa lista contiene US, GB y LOCALHOST. Si activas la protección sin editar la lista, los jugadores de todos los demás países dejarán de poder entrar. Los códigos de país son códigos ISO 3166 de dos letras.
¿Pueden entrar los jugadores con licencia sin contraseña?
Sí, para eso está settings.enablePremium. Los jugadores con una cuenta oficial de Minecraft se verifican automáticamente y no escriben contraseña, el resto entra como siempre. El plugin elige el método de verificación automáticamente.
¿Qué método de almacenamiento de contraseñas debería elegir?
El predeterminado es SHA256. BCRYPT y ARGON2 son deliberadamente lentos de calcular, y esa es la idea: la fuerza bruta se vuelve costosa. Importante: si cambias el algoritmo en un servidor activo, añade el antiguo a settings.security.legacyHashes, si no, la gente no podrá iniciar sesión con sus contraseñas.
Un invitado puede ver las construcciones de otros antes de iniciar sesión
Activa settings.restrictions.teleportUnAuthedToSpawn: antes de iniciar sesión el jugador permanece en el spawn, y tras iniciar sesión vuelve a donde estaba. Esto suele combinarse con ocultar el chat y bloquear el movimiento.
De dónde vienen los datos
Los nombres de los ajustes y los valores predeterminados se tomaron de la documentación oficial del plugin el 1 de septiembre de 2026. El generador incluye los ajustes que la gente cambia a mano; el plugin crea el resto por su cuenta.