Script de lista blanca de contraseñas

Script de Lista Blanca de Contraseñas – Protección de Servidor de Doble Capa para FiveM

Este guión te da dos formas de controlar quién se une a tu servidor: un sistema de contraseña y una lista blanca de identificadores. Puedes usar uno, ambos o habilitar el modo “clever” donde los jugadores necesitan una contraseña O aprobación de la lista blanca. Es una protección de servidor sencilla sin paneles de administración complicados.

Qué está incluido

Obtienes un filtro de conexión ligero que se ejecuta antes de que los jugadores incluso carguen en el servidor. Verifica contraseñas e identificadores en lista blanca (Steam, licencia FiveM, Discord, Xbox, IP) con intentos configurables y mensajes de expulsión automáticos. Todo se gestiona a través de un archivo de configuración simple – sin base de datos, sin panel web.

Características principales

• Protección por Contraseña – Establece una contraseña de servidor que puedes cambiar cuando quieras (útil para pruebas beta o eventos privados)
• Lista blanca de múltiples identificadores – Agregar direcciones de Steam, licencia, Discord, Xbox, Live o IP a la lista aprobada
• Modo Inteligente – Los jugadores necesitan contraseña O lista blanca (no ambos), permitiendo que los amigos se unan sin solicitudes
• Límite de intentos – Intentos de contraseña incorrecta configurables antes de expulsión (predeterminado: 3)
• Redirección Discord – Los jugadores expulsados ven tu invitación Discord para solicitudes de lista blanca
• Opciones de alternancia – Habilitar/deshabilitar contraseña o lista blanca de forma independiente en la configuración

Perfecto para

• Servidores de desarrollo que necesitan acceso rápido por contraseña para probadores
• Comunidades RP con lista blanca y procesos de solicitud
• Servidores privados para grupos de amigos (solo modo de contraseña)
• Fases de prueba beta antes del lanzamiento público
• Servidores en transición de públicos a lista blanca (usar modo inteligente)

Cómo funciona

Cuando alguien se conecta, el script verifica si la lista blanca/contraseña está habilitada. Si la lista blanca está activada, escanea su Steam, licencia, Discord, Xbox, Live e IP contra tu lista aprobada. Si la contraseña está activada, se les solicita ingresarla con X intentos. En modo inteligente, aprobar cualquiera de las verificaciones les permite entrar. Los intentos fallidos muestran un mensaje de expulsión con tu enlace Discord.

Detalles Técnicos

• Estructura: Standalone (funciona con ESX, QBCore, o sin marco
• Actuación: Funciona solo en eventos de conexión, sin impacto en el rendimiento en el juego
• Configuración: Un solo archivo config.lua – sin SQL, sin comandos de administrador
• Tipos de Identificadores: steam, licencia, xbl, live, discord, ip (todos opcionales)
• Tamaño del archivo: Ultra-ligero, código mínimo

Instalación

1. Descarga y extrae en tu carpeta de recursos
2. Abre config.lua y establece UseWhitelist y/o UsePassword en verdadero/falso
3. Establece tu contraseña en Config.Password (cambiar en cualquier momento)
4. Agrega identificadores de lista blanca al array Config.Whitelist (Steam, Discord, etc.)
5. Configura el límite de intentos (cuántos intentos de contraseña incorrectos antes de expulsar)
6. Agregue su enlace de invitación Discord a Config.DiscordLink
7. Agregar “ensure password-whitelist-script” a server.cfg
8. Reiniciar servidor – los jugadores serán notificados al conectarse

Ejemplo de archivo de configuración

-- Config
Config = {}
Config.UseWhitelist = false -- Use whitelist? Only people that are whitelisted are allowed to join.
Config.UsePassword = false -- Use password? If whitelist and password are true, you have to be whitelisted and know the password.
Config.Password = 'PASSWORD' -- Password
Config.Attempts = 3 -- How many attempts a user has to enter the correct password
Config.CleverMode = true -- Use clever mode? If this is true, you will have to either be whitelisted *or* know the password. Recommended.
Config.DiscordLink = 'https://discord.gg/gzkjNkU' -- Your Discord server invite link.
Config.Whitelist = { -- You normally only need one identifier per person.
    'steam:11000010a2324b4', -- Puntherline: Steam
    'license:145ebc08c3ab10a72172c4e98483a4329a3f876e', -- Puntherline: FiveM
    'xbl:2535410249652434', -- Puntherline: Xbox Live
    'live:1055521767134379', -- Puntherline: Live again?
    'discord:250304825902759936', -- Puntherline: Discord
    'ip:87.151.236.79' -- Puntherline: IP
}

Compatibilidad del marco

• ✅ ESX – Completamente compatible, se ejecuta antes de que se cargue el framework
• ✅ QBCore – Funciona perfectamente, el filtro de conexión es independiente del framework
• ✅ QBOX – Compatible con todos los frameworks basados en QB
• ✅ Standalone – Diseñado para funcionar sin ninguna dependencia de marco de trabajo

Lo que lo hace destacar

La mayoría de los scripts de lista blanca te obligan a usar un sistema: gestión de bases de datos, bots Discord o comandos de administrador. Este solo es un archivo de configuración que editas. ¿Necesitas agregar a alguien? Pega su identificador. ¿Quieres cambiar de contraseña a lista blanca? Cambia un booleano. El modo inteligente es particularmente útil para servidores que quieren lista blanca de rol pero aún dejan que los amigos se unan fácilmente. No intenta ser un sistema de permisos complejo: es solo control de acceso que funciona.

¡No dudes en preguntar si tienes alguna duda respecto a cualquier guión!

Relacionados ESX Scripts

• Trabajo de ambulancia de FiveM (ESX/QBCore)
• Menú radial de DebuX (2 estilos, totalmente personalizable)
• Energy Skins Weapons V2 – ESX – QBCORE
• Robo de banco avanzado (T1ger)

Archivo de configuración

-- Config
Config = {}
Config.UseWhitelist = false -- Use whitelist? Only people that are whitelisted are allowed to join.
Config.UsePassword = false -- Use password? If whitelist and password are true, you have to be whitelisted and know the password.
Config.Password = 'PASSWORD' -- Password
Config.Attempts = 3 -- How many attempts a user has to enter the correct password
Config.CleverMode = true -- Use clever mode? If this is true, you will have to either be whitelisted *or* know the password. Recommended.
Config.DiscordLink = 'https://discord.gg/gzkjNkU' -- Your Discord server invite link.
Config.Whitelist = { -- You normally only need one identifier per person.
'steam:11000010a2324b4', -- Puntherline: Steam
'license:145ebc08c3ab10a72172c4e98483a4329a3f876e', -- Puntherline: FiveM
'xbl:2535410249652434', -- Puntherline: Xbox Live
'live:1055521767134379', -- Puntherline: Live again?
'discord:250304825902759936', -- Puntherline: Discord
'ip:87.151.236.79' -- Puntherline: IP
}

¡No dudes en preguntar si tienes alguna duda respecto a cualquier guión!