Docs del script
Game Management
Un panel de administración web para tu staff: jugadores desconectados, la economía y un registro de auditoría.

- Versión
- v2.3.0
- Frameworks
- ESX · QBCore · Qbox
- Requiere
- PHP 7.4+ web hosting, MySQL 5.7.8+ or MariaDB 10.2.7+
- Código
- Escrow
- Actualizado
- 18 oct 2026
Descripción general
XeX Panel se conecta a la misma base de datos MySQL/MariaDB que usa tu servidor FiveM y ofrece a tu staff una interfaz web para gestionarla.
- No requiere ningún recurso de FiveM: el panel trabaja sobre la base de datos. La página Live y el indicador de conexión leen la API HTTP de tu servidor.
- Un único adaptador (
includes/framework.php) gestiona ESX, QBCore y Qbox, incluidas las columnas JSON que usan QBCore y Qbox. - Los recursos opcionales (housing, banca, teléfono, facturación, ox_inventory) se detectan a partir de tu esquema. Las páginas y entradas de menú de los recursos que no uses quedan ocultas.
- Acceso basado en roles con permisos de página y de acción por rol.
- Tokens CSRF, sentencias preparadas, escape de salida y limitación de intentos de inicio de sesión.
- Verificación en dos pasos opcional (códigos TOTP de Google Authenticator, Authy o apps similares), desactivada por defecto.
- Registro de auditoría de las acciones del staff, además de webhooks a Discord, Slack o cualquier endpoint JSON.
Frameworks compatibles
| Framework | Tabla de jugadores | Notas |
|---|---|---|
| ESX Legacy | users |
Columnas planas (firstname, job, job_grade, …) y una columna JSON accounts. |
| QBCore | players |
Columnas JSON charinfo, job, gang, money, metadata. |
| Qbox (qbx_core) | players |
Misma estructura que QBCore, más player_groups, que el panel mantiene sincronizada cuando cambia un trabajo. |
| Custom | configurable | Se trata como una estructura tipo ESX. Mapea tus nombres en $DB_TABLES (consulta Configuración). |
Detección del framework
El instalador inspecciona tu base de datos:
- Tabla
userscon columnasidentifieryaccounts→ ESX - Tabla
playerscon columnascitizenidycharinfo→ QBCore, o Qbox cuando también existe una tablaplayer_groups - En cualquier otro caso → Custom
Puedes cambiar el valor detectado en el paso de framework del instalador (ESX, QBCore, Qbox o Custom), o más adelante editando $FRAMEWORK en config.php.
Cómo se gestionan los datos de QBCore y Qbox
- Los nombres, el trabajo, la banda y las licencias se leen con
JSON_EXTRACTy se escriben conJSON_SET, de modo que solo cambian las claves editadas. El resto decharinfo,jobymetadatase deja como estaba. - El dinero se escribe como números JSON (no cadenas) dentro de la columna
money. - Las licencias se guardan en
players.metadata.licences(driver,weapon,business, más cualquier clave que añadas en Settings). - Cambiar un trabajo establece
job.name,job.grade.levelyjob.onduty = false. qb-core / qbx_core actualizan la etiqueta del trabajo, el nombre del rango y el salario desde su archivo compartido de trabajos cuando el jugador carga. - Qbox: al cambiar de trabajo, la fila de trabajo de
player_groupsse sustituye (o se elimina cuando el nuevo trabajo es el trabajo por defecto “unemployed”). - Los rangos de trabajo están en
shared/jobs.lua, no en la base de datos, así que la página Job Grades muestra en su lugar los trabajos en uso y su número de empleados.
Recursos opcionales
El panel lee la lista de tablas una vez y la guarda en caché durante unos 2 minutos (cache/schema.json). Para cada función usa la primera fuente que exista. Settings → System → Detected resources muestra lo que se ha encontrado, y Rescan limpia la caché.
| Función | ESX / Custom | QBCore / Qbox |
|---|---|---|
| Housing | $DB_TABLES['housing'] si está definido, después loaf_housing, esx_property (owned_properties), properties |
ps-housing / qbx_properties (properties), qb-houses (player_houses) |
| Fondos de negocios | addon_account_data (etiquetas de addon_account) |
qb-management (management_funds), qb-banking (bank_accounts), Renewed-Banking (bank_accounts_new) |
| Facturación | billing |
qb-phone (phone_invoices) |
| Stashes de ox_inventory | ox_inventory |
ox_inventory |
| Teléfono | phone_phones (o $DB_TABLES['phone']) |
phone_phones (o $DB_TABLES['phone']) |
| Rangos de trabajo | job_grades |
no está en la base de datos (shared/jobs.lua) |
| Licencias | user_licenses |
players.metadata.licences |
| Skins / outfits | users.skin, datastore_data (“property”) |
playerskins, player_outfits |
| Premium / VIP | solo si $DB_TABLES['premium'] está definido y la tabla existe |
igual |
Cuando falta una fuente, su entrada de menú, sus secciones de página, sus tarjetas del panel principal y sus columnas de tabla quedan ocultas.
Funciones
Gestión básica
| Función | Descripción |
|---|---|
| Dashboard | Dinero por cuenta, fondos de negocios, usuarios únicos, personajes, vehículos, casas, sociedades, objetos, alertas de anomalías abiertas y acciones recientes del staff. Solo se muestran las tarjetas de los datos que tiene tu servidor. |
| Players | Lista de jugadores con búsqueda y ordenación; perfil de jugador con identidad, trabajo, cuentas, inventario, skin y licencias editables. |
| Vehicles | Recuento de vehículos, modelos y garajes; borrar por matrícula, enviar al garaje, borrar vehículos de trabajo (ESX). |
| Societies | Fondos de trabajos y bandas, miembros con rangos e inventarios de sociedad (ESX). |
| Housing | Lista de propiedades con propietarios, desde el recurso de housing detectado. |
| Job Grades | ESX: trabajos, rangos y salarios. QBCore/Qbox: trabajos en uso y número de empleados. |
| Licenses | Conceder y revocar licencias (ESX user_licenses, QB/Qbox metadata.licences). |
| Item Finder | Encuentra quién tiene un objeto en inventarios, stashes, maleteros y guanteras. |
| Live Server | Jugadores conectados e información del servidor desde la URL de la API de tu servidor. |
Operaciones avanzadas
| Función | Descripción |
|---|---|
| Character Kill (CK) | Borra un personaje y sus filas en las tablas relacionadas que existan en tu servidor. |
| Swap | ESX: mueve todos los datos de un identifier a otro. QBCore/Qbox: mueve un personaje a otra licencia de Rockstar. |
| Quick search | Ctrl+K / Cmd+K desde cualquier página: jugadores (nombre o identifier), matrículas y páginas del panel. |
Intelligence Suite
| Función | Descripción |
|---|---|
| Economy | Totales, distribución de riqueza, jugadores más ricos, dinero por trabajo, jugadores con exceso de efectivo. |
| Business Analytics | Empleados por trabajo, fondos de sociedades, actividad por trabajo, negocios abandonados, distribución de rangos. |
| Anomaly Detection | Alertas de riqueza extrema y saldos negativos, con un flujo para descartarlas. |
| Analytics | Dinero por cuenta a lo largo del tiempo (necesita la tarea cron). |
| Staff Activity | Acciones del staff a lo largo del tiempo, mapa de calor por horas, desglose por categoría, ranking. |
Administración
| Función | Descripción |
|---|---|
| Audit Log | Registro de acciones del staff con filtros, paginación, exportación CSV y purga. |
| Webhooks | Varios endpoints con embeds de Discord, attachments de Slack o JSON genérico. |
| Settings | 8 pestañas: General, Appearance, Game Config, Economy, Limits, Staff, Permissions, System. |
| Permissions | Permisos de página y de acción por rol guardados en la base de datos, más roles personalizados. |
| Two-step verification | Desactivada, opcional u obligatoria para todos los admins. Códigos de 6 dígitos de una app de autenticación, 10 códigos de recuperación de un solo uso y reinicio por un Superadmin. |
| Profile | Cambiar tu propia contraseña; activar o desactivar la verificación en dos pasos. |
Interfaz
- Tema oscuro con color de acento y logo configurables.
- Barra lateral agrupada en Overview, Players, World, Insights y Admin. Se contrae en escritorio (el estado se recuerda) y se convierte en un panel deslizante en móvil.
- Barra superior con el título de la página, búsqueda rápida, perfil y cierre de sesión.
- Visor de skin agrupado en secciones (Identity, Hair, Face, Makeup, Clothing, Damage).
- Contenido de inventarios, stashes, maleteros y guanteras mostrado con etiquetas de objeto y cantidades.
- Gráficas dibujadas con Chart.js.
Requisitos
Servidor
| Componente | Mínimo | Notas |
|---|---|---|
| PHP | 7.4 | Lo comprueba el instalador. Se recomienda PHP 8.1+ por soporte de seguridad. |
| MySQL | 5.7.8 | Se requieren las funciones JSON. |
| MariaDB | 10.2.7 | Se requieren las funciones JSON y el alias de columna JSON. |
| Servidor web | Apache 2.4 con mod_rewrite y mod_headers, o Nginx + PHP-FPM |
Las reglas de protección incluidas están en .htaccess (solo Apache). |
El panel usa estas funciones JSON de SQL: JSON_EXTRACT, JSON_UNQUOTE, JSON_SET, JSON_OBJECT y JSON_VALID.
Extensiones de PHP
| Extensión | Propósito |
|---|---|
pdo_mysql |
Acceso a la base de datos (obligatoria) |
json |
Columnas JSON, ajustes, caché (obligatoria) |
session |
Sesiones de inicio de sesión (obligatoria) |
mbstring |
Iniciales del nombre en la barra lateral, búsqueda rápida, visor de skin. El instalador la lista como opcional, pero instálala. |
fileinfo |
Comprobación del tipo de archivo al subir el logo |
curl |
Peticiones de la página Live (usa file_get_contents como alternativa si falta) |
El directorio del panel y cache/ deben tener permisos de escritura para el servidor web durante la instalación (el instalador escribe config.php). assets/img/ y assets/data/ deben tener permisos de escritura para subir el logo y el catálogo de objetos.
Entornos compatibles
- XAMPP (Windows) para instalaciones locales o pequeñas
- LAMP (Apache + PHP + MySQL/MariaDB) en Linux
- Nginx + PHP-FPM: traslada las reglas de
.htaccessa tu bloque de servidor (consulta Seguridad) - Hosting compartido con PHP 7.4+ y MySQL/MariaDB
Instalación
Método 1: Instalador (recomendado)
1. Copia los archivos
| Entorno | Ruta |
|---|---|
| XAMPP (Windows) | C:\xampp\htdocs\xex-panel\ |
| Linux / Apache | /var/www/html/xex-panel/ |
| Nginx | La raíz web que tengas configurada |
2. Abre el instalador
http://your-server/xex-panel/install/
El instalador tiene seis pasos:
- Requirements: versión de PHP, extensiones, directorios con permisos de escritura.
- Database: host, usuario, contraseña y nombre de tu base de datos de FiveM. El host puede incluir un puerto, por ejemplo
127.0.0.1:3307. - Framework: el framework detectado viene preseleccionado. Elige ESX, QBCore, Qbox o Custom.
- Review: lista las tablas del panel que se crearán y las que ya existen. Las tablas del juego no se modifican.
- Admin account and panel settings: usuario, correo y contraseña del superadmin, nombre del panel y URL de la API de FiveM.
- Done: muestra el resultado de cada tabla.
El instalador crea las tablas del panel con CREATE TABLE IF NOT EXISTS (filas iniciales con INSERT IGNORE), escribe config.php y crea install/installed.lock.
Política de contraseñas: al menos 8 caracteres con una mayúscula, una minúscula y un número.
3. Inicia sesión
http://your-server/xex-panel/
Después, borra o bloquea la carpeta install/.
Método 2: Instalación manual
1. Importa el esquema
Importa setup/schema.sql en tu base de datos de FiveM (las tablas del panel conviven con las tablas del juego):
mysql -u root -p your_database < setup/schema.sql
2. Crea config.php
config.php no se incluye; normalmente lo escribe el instalador. Créalo en la raíz del panel con este contenido:
<?php
$MODE = "production"; // "development" shows PHP errors
if ($MODE === 'production') {
error_reporting(0);
ini_set('display_errors', 0);
ini_set('log_errors', 1);
} else {
error_reporting(E_ALL);
ini_set('display_errors', 1);
}
// ─── Database (host may include a port: 127.0.0.1:3307) ───
$DDBB_HOST = 'localhost';
$DDBB_USER = 'root';
$DDBB_PASSWORD = 'your_password';
$DATABASE_NAME = 'your_database';
$HOST = '';
// ─── Framework: "esx" | "qbcore" | "qbox" | "custom" ───
$FRAMEWORK = 'esx';
// ─── Table and column overrides (empty = framework defaults) ───
$DB_TABLES = [];
// ─── Panel ───
$PANEL_NAME = 'Admin Panel';
$API_FIVEM_URL = '';
$WEBHOOK_URL = '';
require_once __DIR__ . '/includes/bootstrap.php';
3. Crea una cuenta de administrador
INSERT INTO superadmins (username, password, email, role, force_password_change)
VALUES ('admin', '$2y$10$your_bcrypt_hash', 'admin@example.com', 3, 1);
Genera el hash con php -r "echo password_hash('your_password', PASSWORD_DEFAULT);". Con force_password_change = 1 el panel pide una contraseña nueva tras el primer inicio de sesión.
4. Bloquea el instalador
Crea un archivo vacío install/installed.lock o borra la carpeta install/. El instalador también se niega a ejecutarse mientras exista config.php, pero el archivo de bloqueo lo mantiene cerrado aunque config.php se mueva o se renombre.
Tras la instalación
Página Live y estado de conexión
Configura Settings → General → FiveM API URL. El valor de $API_FIVEM_URL es solo el valor inicial por defecto. Respuestas aceptadas:
- la API de servidores de cfx.re:
https://servers-frontend.fivem.net/api/servers/single/YOUR_SERVER_ID/(jugadores, variables del servidor y recursos) - una lista de jugadores simple como el
http://IP:30120/players.jsonde tu servidor, o cualquier JSON con un arrayplayers
El perfil de jugador usa la misma URL para mostrar si la licencia de Rockstar del personaje está conectada. Cuando la URL está vacía, la entrada de menú Live no tiene nada que mostrar.
Etiquetas de objetos
Sube tu lista de objetos en Settings → Game Config → Item catalogue:
ox_inventory/data/items.luaqb-core/shared/items.lua(o el equivalente de Qbox)- o un archivo JSON:
{"water": "Water"},{"water": {"label": "Water"}}o[{"name": "water", "label": "Water"}]
El archivo (hasta 4 MB) se analiza y se guarda como assets/data/items.json. Sin una subida, el panel usa la tabla items de ESX y, en su defecto, los nombres de objeto encontrados en los inventarios de los jugadores. Use automatic source elimina el catálogo subido.
Tarea cron de analítica (opcional)
setup/cronjob_money_analytics.php guarda una instantánea por cada cuenta que exista en tu servidor (ESX: bank, cash, black money; QBCore/Qbox: bank, cash, crypto; más cualquier moneda personalizada que hayas configurado).
Linux (crontab):
0 */6 * * * php /var/www/html/xex-panel/setup/cronjob_money_analytics.php
Windows (Programador de tareas):
- Crear tarea básica → nombre
XeX Panel Analytics - Desencadenador: diario, repetir cada 6 horas
- Acción: Iniciar un programa
- Programa:
C:\xampp\php\php.exe - Argumentos:
C:\xampp\htdocs\xex-panel\setup\cronjob_money_analytics.php
- Programa:
Sin la tarea cron, la página Analytics no tiene datos.
Actualización
- Haz una copia de seguridad de tu base de datos y de la carpeta del panel.
- Sustituye todos los archivos por los de 2.3.0, excepto:
config.phpinstall/installed.lockassets/img/custom-logo.*(si existe)assets/data/items.json(si existe)cache/totp-key.php(si existe: la clave de cifrado de la verificación en dos pasos)
- Abre el panel.
- Desde 2.2: no hay que hacer nada más. La verificación en dos pasos está desactivada hasta que la actives en Settings → Staff, así que todo el mundo inicia sesión como antes. Su tabla (
panel_admin_2fa) se crea la primera vez que un admin la configura; no se modifica ninguna tabla existente. - Desde 2.1: un
config.phpgenerado por 2.1 sigue funcionando: los archivos de bootstrap y seguridad solo definen los valores que la configuración antigua no establece ya. Opcional: sube tuitems.luaen Settings → Game Config (el archivo de objetos incluido con 2.1 ya no se usa) y revisa Settings → System → Detected resources.
- Desde 2.2: no hay que hacer nada más. La verificación en dos pasos está desactivada hasta que la actives en Settings → Staff, así que todo el mundo inicia sesión como antes. Su tabla (
Opcional: cambiar a la configuración corta de 2.2
En 2.2, config.php solo contiene valores (base de datos, framework, sobrescrituras de $DB_TABLES, nombre del panel, URL de la API de FiveM) y termina con require_once __DIR__ . '/includes/bootstrap.php';. Los valores por defecto de cada framework están en includes/framework.php. Para regenerarlo:
- Copia tu
config.phpactual a un lugar seguro. - Borra
install/installed.locky abre/install/. - Sigue los pasos. Las tablas del panel existentes se conservan (
CREATE TABLE IF NOT EXISTS,INSERT IGNORE), y el instalador sobrescribeconfig.php. - El instalador también crea una cuenta de superadmin. Usa un nombre de usuario que no exista todavía, o el paso fallará.
- La nueva configuración tiene un
$DB_TABLESvacío. Si tu configuración antigua mapeaba algo que los valores por defecto no cubren (una clave de moneda personalizada, una tabla premium, una tabla renombrada), copia esas claves en el nuevo$DB_TABLES. - Borra o bloquea de nuevo la carpeta
install/.
Configuración
Los valores están en config.php. La mayoría de las opciones en tiempo de ejecución están en la página Settings.
Modo de la aplicación
$MODE = "production"; // errors logged only (use this in production)
$MODE = "development"; // errors shown on screen
Base de datos
$DDBB_HOST = 'localhost'; // or '127.0.0.1:3307' for a non-default port
$DDBB_USER = 'root';
$DDBB_PASSWORD = 'your_password';
$DATABASE_NAME = 'your_database';
Framework
$FRAMEWORK = 'esx'; // ESX Legacy
$FRAMEWORK = 'qbcore'; // QBCore
$FRAMEWORK = 'qbox'; // Qbox
$FRAMEWORK = 'custom'; // ESX-like layout with your own names in $DB_TABLES
Sobrescritura de tablas y columnas
$DB_TABLES es solo para sobrescrituras. Déjalo vacío salvo que tu servidor renombre algo. Los valores por defecto están en fw_default_tables() en includes/framework.php.
$DB_TABLES = [
'account_black' => 'dirty_money', // ESX account key for black money
'account_coin' => 'coins', // extra currency stored in accounts/money JSON
'housing' => 'my_houses', // ESX / Custom: housing table
'housing_owner' => 'owner',
'premium' => 'my_premium', // optional premium/VIP table
];
Claves y valores por defecto de ESX / Custom
| Clave | Por defecto | Significado |
|---|---|---|
users |
users |
Tabla de jugadores |
users_identifier |
identifier |
Clave del jugador |
users_firstname / users_lastname |
firstname / lastname |
Columnas de nombre |
users_accounts |
accounts |
Columna JSON de cuentas |
users_group |
group |
Grupo de administración |
users_job / users_job_grade |
job / job_grade |
Columnas de trabajo |
users_inventory |
inventory |
JSON del inventario |
users_skin |
skin |
JSON de la skin |
users_pincode |
pincode |
Columna del pincode |
users_created_at / users_last_seen |
created_at / last_seen |
Fechas |
account_bank / account_cash / account_black |
bank / money / black_money |
Claves dentro de accounts |
account_coin |
ninguno | Clave opcional de moneda extra dentro de accounts |
vehicles, vehicles_owner, vehicles_plate |
owned_vehicles, owner, plate |
Vehículos |
licenses, licenses_owner, licenses_type |
user_licenses, owner, type |
Licencias |
job_grades, jobs, items |
job_grades, jobs, items |
Trabajos y objetos |
societies, society_data |
addon_account, addon_account_data |
Cuentas de sociedad |
billing, datastore, inventory_items |
billing, datastore_data, addon_inventory_items |
Otras tablas de ESX |
ox_inventory |
ox_inventory |
Stashes de ox_inventory |
housing, housing_owner |
detección automática | Tabla de housing |
phone |
detección automática (phone_phones) |
Tabla del teléfono (necesita una columna id) |
premium |
ninguno | Tabla premium (necesita una columna identifier con el hash de la licencia) |
Una columna que no exista en tu tabla se omite, y el campo se oculta en la interfaz.
Claves y valores por defecto de QBCore / Qbox
La estructura JSON de players (charinfo, job, gang, money, metadata) es fija. Estas claves sí se pueden sobrescribir:
| Clave | Por defecto | Significado |
|---|---|---|
users |
players |
Tabla de jugadores |
users_accounts |
money |
Columna JSON del dinero |
users_inventory |
inventory |
JSON del inventario |
users_last_seen |
last_updated |
Última conexión |
account_bank / account_cash |
bank / cash |
Claves dentro de money |
account_coin |
crypto |
Se muestra como la moneda extra (“Crypto”) |
vehicles |
player_vehicles |
Tabla de vehículos |
skins |
playerskins |
Tabla de skins |
ox_inventory |
ox_inventory |
Stashes de ox_inventory |
phone, premium |
como arriba | Tablas opcionales |
Las claves exclusivas de ESX (nombres, grupo, columnas de trabajo, tabla de licencias, rangos de trabajo, sociedades, facturación, datastore, dinero negro, housing) se ignoran en QBCore/Qbox, así que una configuración antigua que las mapeara a charinfo no puede escribir texto plano en una columna JSON.
Cuentas
| Framework | Cuentas mostradas |
|---|---|
| ESX | Banco (bank), Efectivo (money), Dinero negro (black_money) |
| QBCore / Qbox | Banco (bank), Efectivo (cash), Crypto (crypto) como moneda extra |
Define account_coin en $DB_TABLES para mostrar una moneda personalizada guardada en el JSON de accounts/money. Las etiquetas mostradas se pueden editar en Settings → Game Config → Account Labels. La moneda extra no se cuenta en los totales de riqueza.
Ajustes generales (Settings → General)
| Ajuste | Por defecto |
|---|---|
| Nombre del panel | Admin Panel (o el valor del instalador) |
| URL de la API de FiveM | valor de $API_FIVEM_URL |
| Símbolo / posición de la moneda | $ / delante |
| Tiempo de expiración de sesión (segundos) | 3600 |
| TTL de la caché (segundos) | 300 |
| Máximo de intentos de inicio de sesión | 5 |
| Tiempo de bloqueo de inicio de sesión (segundos) | 900 |
| Tamaños de página de DataTable | 20,50,100 |
Apariencia (Settings → Appearance)
- Color de acento: cualquier
#rrggbb. El texto dibujado sobre el acento cambia automáticamente entre oscuro y claro para mantener el contraste. - Logo: PNG, JPG o WebP, hasta 512 KB, guardado como
assets/img/custom-logo.*y usado también como favicon. Sin logo, la barra lateral muestra las iniciales del nombre del panel.
Game Config (Settings → Game Config)
| Ajuste | Descripción |
|---|---|
| Item catalogue | Sube items.lua o JSON para las etiquetas de objetos |
| Account Labels | Nombres mostrados para banco, efectivo, dinero negro y la moneda extra |
| License Types | Claves de licencia ofrecidas al conceder (por defecto en ESX: dmv, drive, drive_bike, drive_truck, weapon; por defecto en QB: driver, weapon, business) |
| Job Configuration | Nombre del trabajo “unemployed” por defecto usado por el reinicio de trabajo y la sincronización de grupos de Qbox; lista de trabajos para el formulario de borrado de vehículos de trabajo de ESX |
Economía (Settings → Economy)
| Ajuste | Por defecto |
|---|---|
| Multiplicador de riqueza (página Economy) | 5 |
| Multiplicador de desviación estándar (página Anomalies) | 3 |
| Ratio de exceso de efectivo / total mínimo | 0.8 / 10000 |
| Severidad: crítica / alta (× media) | 20 / 10 |
| Ventana de deduplicación de alertas (horas) | 24 |
| Umbrales de color de salario y sociedad | 5000/1000, 1000000/100000 |
| Ventana de empleado activo / inactivo (días) | 7 / 30 |
| Tramos de riqueza | <1K … >1M |
Límites (Settings → Limits)
Número de filas para las páginas Economy, Anomalies, Business, Staff Activity y Webhook, y para los resultados de la búsqueda rápida (jugadores 8, vehículos 5).
Comprobación de actualizaciones (Settings → System)
Settings → System muestra Up to date o Version X available junto a la versión del panel. El panel consulta https://xexstudio.com/api/version/xex_panel como mucho una vez cada 12 horas (3 segundos de tiempo máximo, resultado guardado en cache/update_check.json). La petición no envía nada sobre tu servidor: ni dominio, ni jugadores, ni base de datos, ni ajustes. Si la tienda no responde, no se muestra nada y la página funciona como siempre. Para desactivarla, añade a config.php antes de la línea require_once:
$UPDATE_CHECK = false;
Módulos del panel
Dashboard (home.php)
- Totales de dinero por cada cuenta que exista en tu servidor, más fondos de negocios
- Usuarios únicos (por licencia de Rockstar) y personajes
- Recuento de vehículos, casas, sociedades y objetos, cuando existan esas fuentes
- Filas premium activas, solo cuando hay una tabla premium configurada
- Alertas de anomalías abiertas y las últimas 8 acciones del staff (para los roles que pueden ver esas páginas)
Players (users.php → view-user.php)
Lista: búsqueda y ordenación con DataTables. Las columnas siguen tu framework (grupo en ESX, banda en QB, dinero negro y moneda extra cuando existen). La lista se guarda en caché en cache/users_<framework>.json y se limpia tras editar jugadores.
Perfil:
- Ficha resumen: riqueza total, cuentas, recuento de vehículos, casas y licencias, estado de conexión, etiquetas y notas del staff
- Información del jugador: nombre, trabajo y rango, grupo y pincode (ESX), JSON del inventario, JSON de la skin. En ESX el trabajo se comprueba contra
job_grades. - Cuentas: saldos editables de las cuentas que tenga tu servidor
- Licencias: conceder y revocar
- Pestañas del explorador de datos: vehículos (con maletero y guantera), casas, inventarios (stashes de ox_inventory), teléfono, outfits, premium, cada una mostrada solo cuando existe la fuente
Las ediciones requieren el permiso de acción correspondiente y un token CSRF.
Vehicles (vehicles.php)
- Recuento total, guardados y fuera/incautados, modelos y garajes
- Borrar un vehículo por matrícula (todos los frameworks)
- Enviar un vehículo a un garaje por matrícula: ESX establece
parking,stored = 1y limpiapound; QBCore/Qbox establecengarage,state = 1,depotprice = 0(cada columna solo si existe) - Borrar los vehículos de trabajo de un jugador (solo ESX, necesita una columna
jobenowned_vehicles) - Los hashes de modelo de ESX se resuelven mediante la tabla
vehiclesde esx_vehicleshop cuando existe
Societies (societies.php → view-societies.php)
- Fondos desde la fuente de fondos de negocios detectada (consulta Recursos opcionales)
- Miembros del trabajo o banda con rango y última conexión
- ESX: stash de ox_inventory de la sociedad, inventario addon y armas del datastore
Houses (houses.php)
- Propiedades con nombre del propietario y, cuando está disponible, shell/interior/nivel
- Oculta cuando no se detecta ningún recurso de housing
Job Grades (grades.php, enlazada desde Societies)
- ESX: nombre del trabajo, rango, etiqueta y salario desde
job_grades - QBCore/Qbox: trabajos que tienen actualmente los jugadores, con número de empleados
Item Finder (itemsFinder.php → search-items.php)
- Lista el catálogo de objetos
- Busca en los inventarios de jugadores (y loadouts de ESX), stashes de ox_inventory, inventarios addon y datastores de ESX, columnas de maletero/guantera de vehículos y tablas de qb-inventory (
stashitems,trunkitems,gloveboxitems,inventories) cuando existen - Muestra propietario, ubicación y cantidad
Live Server (live.php)
- Jugadores conectados desde la URL de API configurada (nombre, ID de servidor, ping, licencia), con un enlace que busca en la lista de jugadores por licencia
- Cuando no se puede acceder a la API, la página muestra el error recibido
- Máximo de clientes, nombre/descripción del proyecto y recursos cuando se usa la API de cfx.re
Character Kill (ck_user.php → makeck.php)
Borra la fila del jugador en último lugar, dentro de una transacción, después de estas filas relacionadas (cada tabla solo si existe):
| ESX / Custom (por identifier) | QBCore / Qbox (por citizenid) |
|---|---|
filas de addon_account_data, addon_inventory_items, datastore_data propiedad del jugador |
player_vehicles |
billing, owned_vehicles, user_licenses |
playerskins, player_outfits |
| filas de housing, teléfono y premium | player_houses, phone_invoices |
filas de ox_inventory propiedad del jugador |
filas de ox_inventory propiedad del jugador, player_groups (Qbox) |
Introduce el identifier de ESX o el citizenid de QB/Qbox.
Swap (swaps.php → controllers/swap-controller.php)
- ESX / Custom: mueve todo del identifier antiguo al nuevo. Primero ejecuta un CK sobre el nuevo identifier y después actualiza el identifier en la tabla de jugadores, vehículos, licencias, housing, ox_inventory, cuentas/inventarios addon, datastores y facturación (identifier, sender, target). Se rechaza hacer un swap de un identifier sobre sí mismo.
- QBCore / Qbox: mueve un personaje (citizenid) a otra licencia de Rockstar (
license:<hash>o el hash a secas). No se borra nada. Actualizaplayers.license, asigna el siguientecidlibre en la nueva licencia, actualizaplayer_vehicles.licensey, en Qbox, estableceplayers.userIda la fila deuserscorrespondiente.
Exportación de jugadores (export-players.php)
- Export CSV en la página Players descarga todos los personajes con identifier, nombre, trabajo, rango, banda (QB), cada cuenta y última conexión
- UTF-8 con BOM para que Excel conserve los acentos; las celdas que empiezan por
=,+,-o@llevan un prefijo para evitar la inyección de fórmulas - Requiere la acción
export_players
Modo demo
Define $DEMO_MODE = true; en config.php para ejecutar un panel de solo lectura, por ejemplo una demo pública con datos ficticios. Todo envío de formulario, excepto el inicio de sesión y la búsqueda de objetos, se rechaza antes de llegar a un controlador, y la barra superior muestra Demo · read-only. $DEMO_LOGIN = ['demo', 'demo']; muestra esas credenciales en la página de inicio de sesión. Crea antes esa cuenta como una cuenta de staff normal.
Analytics (analytics.php)
- Una gráfica por cuenta, cada una con su propia escala, con el último total y la variación en 30 días
- Varias instantáneas del mismo día se reducen a la última
Sistema de roles y permisos
Roles integrados
| Rol | Nivel |
|---|---|
| Viewer | 0 |
| Moderator | 1 |
| Admin | 2 |
| Superadmin | 3 |
Estos cuatro roles del sistema no se pueden borrar. Los superadmins pueden crear roles personalizados (nombre, nivel, color) en la página Permissions y conceder páginas y acciones por rol. Los permisos guardados ahí sustituyen a los valores por defecto de abajo para ese rol. Los superadmins tienen acceso a todo.
Acceso a páginas por defecto
| Página | Viewer | Moderator | Admin | Superadmin |
|---|---|---|---|---|
| Dashboard, Live, lista de Players, Societies, Houses, Item Finder, Job Grades, Analytics | ✅ | ✅ | ✅ | ✅ |
| Perfil de jugador, detalle de sociedad | ❌ | ✅ | ✅ | ✅ |
| Vehicles, formulario de Character Kill, formulario de Swap, reinicio de trabajo, añadir licencia, Audit Log | ❌ | ❌ | ✅ | ✅ |
| Página Licenses, Economy, Business, Anomalies, Staff Activity, Webhooks, Settings, Permissions | ❌ | ❌ | ❌ | ✅ |
Las páginas de la última fila se pueden conceder a otros roles en la página Permissions.
Permisos de acción por defecto
| Acción | Rol mínimo |
|---|---|
edit_user_data |
Admin |
edit_user_money |
Admin |
delete_job |
Admin |
manage_vehicles |
Admin |
manage_licenses |
Moderator |
character_kill |
Superadmin |
swap_players |
Superadmin |
create_staff |
Superadmin |
remove_staff |
Superadmin |
change_password |
Moderator |
view_settings |
Superadmin |
manage_permissions |
Superadmin |
export_players |
Admin |
export_audit |
Admin |
purge_audit |
Superadmin |
manage_webhooks |
Superadmin |
Las notas y etiquetas del staff en los perfiles de jugador requieren Moderator o superior.
Sistema de webhooks
Formatos
| Formato | Se detecta por | Payload |
|---|---|---|
| Discord | la URL contiene discord.com/api/webhooks |
Embed con color, campos y marca de tiempo |
| Slack | la URL contiene hooks.slack.com |
Attachment con color y campos |
| JSON genérico | cualquier otra URL | event, data y marca de tiempo |
Eventos (13)
| Evento | Disparador |
|---|---|
user.money_changed |
Saldo de cuenta editado |
user.data_changed |
Datos del jugador editados |
user.license_added |
Licencia concedida |
user.license_swapped |
Swap realizado |
user.character_killed |
Character kill realizado |
user.job_reset |
Trabajo reiniciado al trabajo por defecto |
vehicle.deleted |
Vehículo(s) borrado(s) |
vehicle.sent_garage |
Vehículo enviado al garaje |
staff.created |
Cuenta de staff creada |
staff.removed |
Cuenta de staff borrada |
staff.password_changed |
Contraseña de staff cambiada |
panel.login |
Inicio de sesión correcto |
panel.login_failed |
Inicio de sesión fallido |
Configuración
- Abre Webhooks en la barra lateral
- Crea un webhook con un nombre, una URL y los eventos que enviar
- Usa Test para enviar un payload de prueba
Cada entrega se registra en panel_webhook_logs (evento, payload, estado HTTP, respuesta) y se lista en la página Webhooks.
Webhook de Discord heredado
$WEBHOOK_URL en config.php sigue recibiendo un mensaje de texto plano para las acciones registradas mediante la función de auditoría heredada. Es preferible usar la página Webhooks.
Avatar de Discord
Los mensajes de Discord usan el avatar configurado en el propio webhook. Para cambiarlo, define $WEBHOOK_AVATAR_URL = 'https://your-site/avatar.png'; en config.php.
Registro de auditoría
Las acciones del staff se guardan en panel_audit_log y se muestran en la página Audit Log.
Se registra: marca de tiempo, nombre de usuario, rol, acción, categoría, objetivo, detalles, dirección IP, user agent.
- 7 filtros: usuario, categoría, acción, objetivo, IP, fecha desde, fecha hasta
- 50 entradas por página
- Estadísticas: hoy, esta semana, usuarios activos, inicios de sesión fallidos (24 h)
- Exportación CSV de los resultados filtrados
- Purga de entradas con más de N días (mínimo 7); el formulario de purga se muestra a los Superadmins
Verificación en dos pasos
Desactivada por defecto. Cuando está activa, el admin introduce tras la contraseña un código de 6 dígitos de una app de autenticación de su móvil, así que una contraseña filtrada por sí sola no abre el panel. Funciona con Google Authenticator, Authy, Microsoft Authenticator, 2FAS, Aegis y cualquier app compatible con TOTP (RFC 6238).
Modos (Settings → Staff → Two-step verification)
| Modo | Qué ocurre |
|---|---|
| Off (por defecto) | Solo usuario y contraseña, como en 2.2. A los admins que la configuraron antes no se les pide el código mientras esté desactivada; su configuración vuelve a funcionar cuando la reactives. |
| Optional | Cada admin decide: Profile → Two-step verification → Set up. Los admins que no la tienen inician sesión solo con su contraseña. |
| Required | Todos los admins la necesitan. Tras la contraseña, quien no la tiene pasa directamente a la página de configuración; quien ya tiene la sesión iniciada es enviado allí en la siguiente página que cargue. Esto te incluye a ti. |
La pestaña Staff también muestra qué admins la tienen activa.
Configurarla
- Profile → Set up two-step verification (o la página que aparece al iniciar sesión cuando el modo es Required).
- Escanea el código QR con la app o escribe la clave que aparece debajo. El QR lo dibuja tu navegador con el archivo incluido
assets/js/qrcode.min.js; la clave no se envía a ningún servicio externo. - Introduce tu contraseña actual (si vienes del perfil) y el primer código de la app.
- Guarda los 10 códigos de recuperación (cópialos o descárgalos como
.txt). Solo se muestran una vez. Cada uno te permite iniciar sesión una vez en lugar de un código.
Desde el perfil también puedes crear códigos de recuperación nuevos (los antiguos dejan de funcionar) y desactivarla (modo Optional) o pasarla a un móvil nuevo (modo Required: se desactiva y se abre la página de configuración). Ambas acciones piden tu contraseña y un código o un código de recuperación.
Iniciar sesión
- Un código se acepta durante su ventana de 30 segundos y una ventana antes y otra después, por si el reloj se desvía. Cada código funciona una sola vez.
- Los códigos erróneos cuentan para el mismo límite por IP que las contraseñas erróneas (Max login attempts / Login lockout time). Tras 5 códigos erróneos se vuelve a pedir la contraseña. El código debe introducirse en los 10 minutos siguientes a la contraseña.
- Lost your phone? Use a recovery code, en la página del código, acepta un código de recuperación en su lugar.
Un admin perdió el móvil y los códigos de recuperación
Usa cualquiera de estas opciones. Cada una queda en el registro de auditoría y, si el modo es Required, el admin la vuelve a configurar en su siguiente inicio de sesión.
- Desde el panel: un Superadmin (o un rol con la acción
remove_staff) abre Settings → Staff, pulsa Reset 2FA junto al admin y confirma con su propia contraseña. Funciona con admins del mismo rol o inferior. - Desde una consola en el servidor web:
php setup/reset-2fa.php <username>. Sin nombre de usuario, lista los admins que la tienen activa. - Desde phpMyAdmin (sin acceso a consola), cambiando el nombre de usuario:
DELETE FROM panel_admin_2fa WHERE admin_id = (SELECT id FROM superadmins WHERE username = 'name');
Las opciones 2 y 3 también sirven cuando el único Superadmin es el que se ha quedado fuera.
Dónde se guardan los datos
- Tabla
panel_admin_2fa, una fila por cada admin con la verificación en dos pasos activa. La crea el instalador; en instalaciones existentes se crea la primera vez que un admin la configura.superadminsno se modifica. - El secreto se guarda cifrado (AES-256-GCM). La clave es
$TOTP_KEYdeconfig.phpsi está definida; si no,cache/totp-key.php, que el panel crea la primera vez que alguien configura la verificación en dos pasos (cache/debe tener permisos de escritura, igual que para el límite de inicio de sesión). - Para guardar la clave en
config.php, añádela antes de que nadie configure la verificación en dos pasos (cambiar la clave después deja ilegibles las configuraciones existentes). Genera un valor conphp -r "echo base64_encode(random_bytes(32));"y añádelo antes de la línearequire_once:$TOTP_KEY = 'the generated value'; - Conserva la clave al actualizar o mover el panel. Si se pierde, los códigos ya no se pueden comprobar y hay que reiniciar a cada admin (ver arriba).
- Los códigos de recuperación se guardan como hashes SHA-256.
Entradas en el registro de auditoría
| Acción | Cuándo |
|---|---|
staff.2fa_enabled |
Un admin la activó |
staff.2fa_disabled |
Un admin la desactivó (o la pasó a un móvil nuevo) |
staff.2fa_reset |
Se desactivó para otro admin (Settings → Staff o setup/reset-2fa.php) |
staff.2fa_recovery_regenerated |
Se crearon códigos de recuperación nuevos |
staff.2fa_recovery_used |
Inicio de sesión con un código de recuperación (con los que quedan) |
panel.login_2fa_failed |
Código o código de recuperación erróneo al iniciar sesión (también envía el evento de webhook panel.login_failed) |
settings.security_updated |
Se cambió el modo |
Los inicios de sesión correctos se registran como panel.login con (2FA code) o (recovery code) en los detalles.
Intelligence Suite
Economy (economy.php)
- Totales por cuenta, riqueza media y máxima (riqueza = banco + efectivo + dinero negro; la moneda extra queda excluida)
- Jugadores más ricos, dinero por trabajo, tramos de riqueza
- Jugadores por encima del multiplicador de riqueza, jugadores con exceso de efectivo
- Gráficas
Business Analytics (business-analytics.php)
- Empleados por trabajo, fondos de sociedades
- Empleados activos / semiactivos / inactivos por trabajo (por última conexión)
- Negocios abandonados, número de desempleados, distribución de rangos
Anomaly Detection (anomalies.php)
| Alerta | Severidad |
|---|---|
| Riqueza extrema (por encima de la media + N desviaciones estándar) | Crítica, alta o media, según el múltiplo de la media |
| Saldo negativo | Baja |
- Las alertas se generan al cargar la página y se deduplican dentro de la ventana de deduplicación
- Filtro por severidad y tipo; descartar alertas
- Se guardan en
panel_anomaly_alerts
Staff Activity (staff-activity.php)
- Acciones totales, staff activo, media por día
- Tendencia diaria, desglose por categoría, mapa de calor por horas
- Ranking del staff y acciones más comunes
- Rango: 7, 14, 30, 60 o 90 días
Personalización
Traducciones
Los textos de la interfaz están en translations.php como variables $T_*:
$T_PAGE_HOME = 'Home';
$T_TOTAL_CARS = 'Total Cars';
El panel se entrega en inglés.
Tema
Elige el color de acento y el logo en Settings → Appearance. Para cambios más profundos, edita las variables CSS al principio de style.css:
:root {
--bg: #0e1116; /* page background */
--surface: #151a21; /* cards */
--border: #252c36;
--text: #e7eaef;
--text-2: #a7afbc; /* secondary text */
--accent: #c5f24a; /* overridden by Settings → Appearance */
}
Menú
Los grupos y entradas de la barra lateral se definen en panel_menu() en includes/layout.php.
Referencia de la base de datos
Tablas del panel
Se crean en tu base de datos de FiveM con CREATE TABLE IF NOT EXISTS. Volver a ejecutar el instalador o setup/schema.sql es seguro.
| Tabla | Propósito |
|---|---|
superadmins |
Cuentas de staff (contraseñas bcrypt, rol) |
analytics_money |
Instantáneas de dinero de la tarea cron |
panel_audit_log |
Registro de acciones del staff |
panel_webhooks |
Endpoints y eventos de webhooks |
panel_webhook_logs |
Entregas de webhooks |
panel_roles |
Roles y sus permisos (JSON) |
panel_player_notes |
Notas y etiquetas del staff sobre jugadores |
panel_anomaly_alerts |
Alertas de anomalías |
panel_settings |
Almacén clave/valor de ajustes |
panel_admin_2fa |
Verificación en dos pasos: secreto cifrado y códigos de recuperación con hash por admin |
Tablas del juego que usa el panel
El panel nunca crea, elimina ni altera estas tablas. Las lee y, para las operaciones indicadas, escribe filas.
| Propósito | ESX | QBCore / Qbox | Operaciones |
|---|---|---|---|
| Jugadores | users |
players (JSON charinfo, job, gang, money, metadata) |
Lectura / actualización / borrado (CK) / swap |
| Licencias | user_licenses |
players.metadata.licences |
Lectura / escritura / borrado |
| Vehículos | owned_vehicles |
player_vehicles |
Lectura / actualización / borrado |
| Skins / outfits | users.skin, datastore_data |
playerskins, player_outfits |
Lectura / actualización de skin / borrado (CK) |
| Grupos de trabajo | — | player_groups (Qbox) |
Escritura al cambiar de trabajo / borrado (CK) |
| Rangos de trabajo | job_grades, jobs |
— (shared/jobs.lua) |
Lectura |
| Fondos de negocios | addon_account, addon_account_data |
management_funds, bank_accounts, bank_accounts_new |
Lectura |
| Facturación | billing |
phone_invoices |
Borrado (CK) / swap (ESX) |
| Objetos de sociedad | addon_inventory_items, datastore_data |
stashitems, trunkitems, gloveboxitems, inventories |
Lectura / borrado y swap (ESX) |
| ox_inventory | ox_inventory |
ox_inventory |
Lectura / borrado (CK) / swap (ESX) |
| Housing | loaf_housing, owned_properties, properties |
properties, player_houses |
Lectura / borrado (CK) / swap (ESX) |
| Teléfono | phone_phones |
phone_phones |
Lectura / borrado (CK, ESX) |
| Objetos | items |
— | Lectura |
| Nombres de vehículos | vehicles (esx_vehicleshop) |
— | Lectura |
| Usuarios de Qbox | — | users (Qbox) |
Lectura (swap) |
| Premium | tabla configurada | tabla configurada | Lectura / borrado (CK, ESX) |
Estructura de archivos
xex-panel/
├── config.php # Created by the installer (values only)
├── .htaccess # Apache protection rules and headers
├── index.php # Login
├── export-players.php # Player list CSV export
├── home.php # Dashboard
├── live.php # Live server
├── users.php # Player list
├── view-user.php # Player profile
├── licenses.php # Grant licences
├── makelicenses.php # Licence grant handler
├── delete-job.php # Job reset handler
├── ck_user.php # Character kill form
├── makeck.php # Character kill handler
├── swaps.php # Swap form
├── societies.php # Society list
├── view-societies.php # Society detail
├── grades.php # Job grades
├── houses.php # Housing
├── vehicles.php # Vehicles
├── itemsFinder.php # Item catalogue and search form
├── search-items.php # Item search results
├── analytics.php # Money over time
├── economy.php # Economy
├── business-analytics.php # Business analytics
├── anomalies.php # Anomaly detection
├── staff-activity.php # Staff activity
├── audit.php # Audit log
├── webhooks.php # Webhooks
├── settings.php # Settings (8 tabs)
├── permissions.php # Roles and permissions
├── profile.php # Own profile, password and two-step verification
├── two-factor.php # Sign-in step: 6-digit code or recovery code
├── two-factor-setup.php # Two-step verification setup (QR) and recovery codes
├── logout.php
├── translations.php # UI strings
├── style.css # Styles (CSS variables)
├── main.js # Sidebar, quick search, tables
├── favicon.ico
│
├── controllers/ # Form handlers (POST only, except quick search)
│ ├── authenticate.php # Login
│ ├── createuser.php # Create staff account
│ ├── data-controller.php # Player data edits
│ ├── editpass-controller.php # Password change
│ ├── money-controller.php # Account edits
│ ├── notes-controller.php # Player notes and tags
│ ├── remove-license-controller.php
│ ├── remove-staff-controller.php
│ ├── remove-veh-controller.php # Delete vehicle(s)
│ ├── search-global.php # Quick search (GET, JSON)
│ ├── search-veh-controller.php # Vehicle search by plate
│ ├── send-veh-controller.php # Send vehicle to garage
│ ├── settings-controller.php # Settings, logo and item uploads
│ ├── two-factor-controller.php # Turn 2FA on/off, recovery codes, reset by a Superadmin
│ ├── verify-two-factor.php # Sign-in code check
│ └── swap-controller.php # Swap
│
├── includes/
│ ├── bootstrap.php # Loaded by config.php: roles, default access, helpers
│ ├── security.php # Sessions, headers, CSRF, DB connection, CK and swap
│ ├── framework.php # Framework adapter and schema detection
│ ├── fw_players.php # Adapter: per-player helpers
│ ├── fw_world.php # Adapter: economy, housing, vehicles, items, live API
│ ├── settings_helper.php # Settings store, appearance helpers
│ ├── two_factor.php # TOTP, encrypted secrets, recovery codes
│ ├── login_guard.php # Login rate limit and session start after sign-in
│ ├── permissions.php # Granular permissions engine
│ ├── webhooks.php # Webhook delivery
│ ├── layout.php # Menu definition and page titles
│ ├── header.php # <head> assets (CDN with SRI)
│ ├── sidebar.php # Sidebar shell
│ ├── topbar.php # Top bar shell
│ ├── menu.php # Sidebar links filtered by access and detected data
│ └── chart.php # Chart.js loader and defaults
│
├── install/
│ └── index.php # Installer (6 steps)
│
├── setup/
│ ├── schema.sql # Panel tables
│ ├── cronjob_money_analytics.php # Analytics snapshots
│ └── reset-2fa.php # Turn off 2FA for an admin (command line)
│
├── assets/
│ ├── js/qrcode.min.js # QR code drawing for the 2FA setup (MIT, qrcode.LICENSE)
│ ├── data/ # items.json (created by the item catalogue upload)
│ └── img/ # custom-logo.* (created by the logo upload)
│
└── cache/ # Runtime files
├── schema.json # Detected tables (~2 min)
├── users_<framework>.json # Player list cache
├── cacheAnalytics.txt # Analytics cache
├── login_attempts.json # Login rate limiting
└── totp-key.php # 2FA encryption key (keep it when updating)
Solución de problemas
| Problema | Causa | Solución |
|---|---|---|
| “Database connection error” | Credenciales incorrectas, puerto incorrecto o base de datos caída | Comprueba $DDBB_HOST (usa host:port para un puerto distinto del predeterminado), $DDBB_USER, $DDBB_PASSWORD, $DATABASE_NAME. |
| Página en blanco | Error de PHP oculto en modo producción | Establece $MODE = "development" temporalmente y revisa el registro de errores de PHP. |
| Errores de tabla del panel inexistente | Tablas del panel no creadas | Ejecuta el instalador o importa setup/schema.sql. |
| “Invalid security token” | Sesión expirada o formulario abierto en otra sesión | Vuelve a iniciar sesión; aumenta el tiempo de expiración de sesión en Settings si hace falta. |
| Falta una entrada de menú o una sección de página | El recurso no se detectó | Revisa Settings → System → Detected resources, pulsa Rescan o define el nombre de la tabla en $DB_TABLES. |
| Framework incorrecto | La detección eligió otra estructura | Define $FRAMEWORK en config.php (esx, qbcore, qbox, custom). |
| Los objetos muestran nombres internos | No hay catálogo de objetos | Sube ox_inventory/data/items.lua o qb-core/shared/items.lua en Settings → Game Config → Item catalogue. |
| Falla la subida del logo | Archivo demasiado grande o carpeta sin permisos de escritura | Usa PNG/JPG/WebP de hasta 512 KB; da permisos de escritura a assets/img/. |
| Página Analytics vacía | Todavía no hay instantáneas | Configura la tarea cron. |
| Página Live vacía | URL de API ausente, incorrecta o servidor inaccesible | Configura Settings → General → FiveM API URL. La página muestra el error recibido (conexión, estado HTTP o JSON no válido). |
| La búsqueda rápida no devuelve nada (Apache) | Un .htaccess antiguo bloquea las peticiones GET a los controladores |
Usa el .htaccess de 2.2, que permite GET a controllers/search-global.php. |
| Redirección a HTTPS en un servidor sin certificado | .htaccess antiguo |
El .htaccess de 2.2 omite la redirección para localhost, 127.0.0.1 y [::1]. Para otros hosts, instala un certificado o elimina el bloque de redirección. |
| Instalador bloqueado | Ya instalado | Borra install/installed.lock. |
| Los permisos no se guardan | Faltan privilegios en la BD | El usuario de MySQL necesita INSERT/UPDATE en panel_roles. |
| El código 2FA siempre es incorrecto | El reloj del móvil o el del servidor no está en hora | Pon el móvil en fecha y hora automáticas; comprueba la hora del servidor. |
| Un admin perdió el móvil | Sin app de autenticación | Inicia sesión con un código de recuperación o reiníciala. |
| “Two-step verification is unavailable” | cache/ sin permisos de escritura o cache/totp-key.php sustituido |
Da permisos de escritura a cache/; restaura el archivo de clave anterior o reinicia la 2FA de cada admin. |
Archivos de registro
- Errores de PHP: tu registro de errores de PHP (XAMPP:
C:\xampp\php\logs\php_error_log) - Entregas de webhooks: página Webhooks o
panel_webhook_logs - Intentos de inicio de sesión:
cache/login_attempts.json - Acciones del staff: página Audit Log o
panel_audit_log
Seguridad
Autenticación y sesiones
- Contraseñas con hash mediante
password_hash()(PASSWORD_DEFAULT), recalculado al iniciar sesión cuando hace falta - Política de contraseñas para cuentas nuevas y cambios: 8+ caracteres con mayúscula, minúscula y un número
- Las cuentas marcadas con
force_password_changedeben cambiar su contraseña antes de usar el panel - ID de sesión regenerado al iniciar sesión
- Cookie de sesión con
HttpOnly,SameSite=StrictySecurecuando la petición es HTTPS, también en la petición de inicio de sesión - Tiempo de expiración de sesión (1 hora por defecto)
- Limitación de intentos de inicio de sesión por IP, guardada en disco; los códigos 2FA erróneos cuentan para el mismo límite
- Verificación en dos pasos (TOTP) opcional por admin u obligatoria para todos; secretos cifrados con AES-256-GCM y códigos de recuperación guardados como hashes
- El error de inicio de sesión no revela si un nombre de usuario existe
Protección de peticiones
- Tokens CSRF en los formularios (incluida la búsqueda de objetos), rotados tras cada comprobación correcta
- Las operaciones que cambian estado usan POST
- Sentencias preparadas de PDO con la emulación desactivada; valores como umbrales y nombres de trabajo se vinculan como parámetros
- Los nombres de tablas y columnas de la configuración se validan antes de usarse
- Salida escapada con
e()/attr(); los datos pasados a JavaScript se codifican como JSON
Cabeceras HTTP
Enviadas por includes/security.php (y por .htaccess en Apache):
X-Frame-Options: DENYX-Content-Type-Options: nosniffX-XSS-Protection: 1; mode=blockReferrer-Policy: strict-origin-when-cross-originPermissions-Policy: camera=(), microphone=(), geolocation=()Strict-Transport-Security(solo en peticiones HTTPS)
Dependencias del front-end
Cargadas desde CDN con hashes de Subresource Integrity: jQuery 3.7.1, DataTables core 1.13.7, Font Awesome 6.5.1, Chart.js 4.4.1. Las fuentes vienen de Google Fonts. La librería de códigos QR de la verificación en dos pasos (qrcode.js, MIT) va incluida en assets/js/ y se sirve desde tu propio hosting.
Protección de archivos
.htaccess (Apache):
- Redirige HTTP a HTTPS, excepto para
localhost,127.0.0.1y[::1] - Bloquea las peticiones que no sean POST a
controllers/*.php, exceptocontrollers/search-global.php(búsqueda rápida) - Bloquea
includes/*.php,setup/ycache/ - Deniega los archivos
.sql,.log,.txt,.md,.json,.bak,.old,.orig,.saveyconfig.php - Desactiva el listado de directorios
En Nginx, añade reglas equivalentes a tu bloque de servidor.
Lista de comprobación para producción
- Sirve el panel por HTTPS
- Restringe el acceso (firewall, VPN o lista de IP permitidas)
- Mantén
$MODE = "production" - Borra o bloquea
install/tras la instalación - Activa la verificación en dos pasos (Settings → Staff), al menos para los Superadmins
- Revisa el registro de auditoría con regularidad
- Mantén PHP y MySQL/MariaDB actualizados
- Haz copias de seguridad de la base de datos, incluidas las tablas del panel, y de
cache/totp-key.php
Registro de cambios
v2.3.0
Seguridad
- Verificación en dos pasos con códigos de 6 dígitos de Google Authenticator, Authy, Microsoft Authenticator o cualquier app TOTP. Desactivada por defecto: tras actualizar, todo el mundo inicia sesión como antes
- Settings → Staff define el modo: Off, Optional (cada admin la activa en su perfil) o Required (cada admin la configura antes de usar el panel)
- Configuración con un código QR dibujado en el navegador por una librería incluida (sin servicios externos) y un primer código para confirmar
- 10 códigos de recuperación de un solo uso por admin, guardados como hashes; se pueden crear códigos nuevos desde el perfil
- Los códigos erróneos cuentan para el mismo límite de inicio de sesión por IP que las contraseñas erróneas; tras 5 códigos erróneos se vuelve a pedir la contraseña
- Cada código funciona una sola vez y el secreto se guarda cifrado (AES-256-GCM)
- Un Superadmin puede reiniciar la verificación en dos pasos de otro admin desde Settings → Staff; sin acceso al panel, lo hace
php setup/reset-2fa.php <username>o una consulta SQL - Entradas en el registro de auditoría al activarla y desactivarla, en los reinicios, los códigos de recuperación nuevos, los inicios de sesión con código de recuperación y los códigos erróneos
Base de datos
- Nueva tabla
panel_admin_2fa, creada por el instalador o la primera vez que un admin configura la verificación en dos pasos. No se modifica ninguna tabla existente
Correcciones y cambios menores
- Max login attempts y Login lockout time de Settings → General ahora se aplican al inicio de sesión (antes solo lo hacían
$MAX_LOGIN_ATTEMPTS/$LOGIN_LOCKOUT_TIMEdeconfig.php) - Al eliminar una cuenta de staff también se eliminan sus datos de verificación en dos pasos
v2.2.1 (2026-10-10)
Seguridad
- El instalador ahora queda bloqueado tras una instalación manual: se niega a ejecutarse si existe
config.phpoinstall/installed.lock - El instalador valida el nombre de la base de datos antes de usarlo
- El script cron de analítica solo se puede ejecutar desde la línea de comandos
- Los flags reforzados de la cookie de sesión ahora también se aplican en la petición de inicio de sesión
Novedades
- Comprobación de actualizaciones en Settings → System: muestra Up to date o Version X available (se comprueba como mucho cada 12 horas y se puede desactivar con
$UPDATE_CHECK = false)
Correcciones y cambios menores
- Los webhooks de Discord usan el avatar del propio webhook salvo que se defina
$WEBHOOK_AVATAR_URL - Limpieza interna del nombre de la moneda extra en la página del jugador
- Los pasos de instalación manual ahora incluyen bloquear el instalador
v2.2.0
Novedades
- Exportación de la lista de jugadores a CSV
- Modo demo de solo lectura (
$DEMO_MODE) - Analytics muestra una gráfica por cuenta con su propia escala y la variación a 30 días
export_audit,purge_auditymanage_webhooksahora se aplican y se pueden conceder a roles personalizados
Frameworks
- ESX Legacy, QBCore y Qbox son compatibles de forma nativa mediante un nuevo adaptador (
includes/framework.php,includes/fw_players.php,includes/fw_world.php) - Las columnas JSON de QBCore/Qbox (
charinfo,job,gang,money,metadata.licences) se leen conJSON_EXTRACTy se escriben conJSON_SET player_groupsde Qbox se mantiene sincronizada al cambiar de trabajo- El instalador detecta ESX, QBCore y Qbox y tiene una opción Qbox
Configuración
config.phpsolo contiene valores y termina conrequire_once includes/bootstrap.php; los valores por defecto de cada framework se han movido aincludes/framework.php$DB_TABLESahora es solo para sobrescrituras- El host de la base de datos puede incluir un puerto (
127.0.0.1:3307) - Las configuraciones generadas por 2.1 siguen funcionando
Recursos y datos
- Los recursos opcionales se detectan automáticamente; sus páginas y entradas de menú se ocultan cuando no existen
- Nuevo Settings → System → Detected resources con Rescan
- Housing: loaf_housing, esx_property, ps-housing, qbx_properties, qb-houses
- Fondos de negocios: cuentas addon de ESX, qb-management, qb-banking, Renewed-Banking
- Facturación:
billingde ESX,phone_invoicesde qb-phone - Las cuentas siguen al framework; el crypto de QBCore/Qbox se muestra como la moneda extra. Se puede definir una moneda personalizada con
account_coin - La subida del catálogo de objetos (
items.luade ox_inventory o qb-core, o JSON) sustituye a la lista de objetos incluida - Character kill y swap tienen en cuenta el framework; el swap de QBCore/Qbox mueve un personaje a otra licencia de Rockstar; el swap de ESX rechaza hacer un swap de un identifier sobre sí mismo
- Enviar al garaje y borrar por matrícula funcionan en todos los frameworks; borrar vehículos de trabajo es solo para ESX
- El cron de analítica registra solo las cuentas que existen
Interfaz
- Nueva interfaz oscura con barra lateral agrupada y contraíble y barra superior
- Búsqueda rápida (
Ctrl+K/Cmd+K) de jugadores, matrículas y páginas, sin distinguir mayúsculas en todos los frameworks - Settings → Appearance: color de acento y subida de logo
- Bootstrap 3 eliminado; DataTables core 1.13.7 y Chart.js 4.4.1 fijados con SRI
- Estructura de página compartida:
includes/sidebar.php,includes/topbar.php,includes/layout.php,includes/header.php
Seguridad
- Los flags reforzados de la cookie de sesión ahora se aplican de verdad (
HttpOnly,SameSite=Strict,Secureen HTTPS) - El inicio de sesión ya no revela si un nombre de usuario existe
.htaccessya no fuerza HTTPS en localhost y permite GET solo al endpoint de búsqueda rápida- Comprobación CSRF añadida a la búsqueda de objetos
- Correcciones de escape de salida en varias páginas
- Umbrales SQL vinculados como parámetros
Eliminado
- Las imágenes incluidas en
assets/img/y la lista de objetos incluida enassets/data/
v2.1.0
- Intelligence Suite — Economy Dashboard, Business Analytics, Anomaly Detection, Staff Activity
- Ajustes dinámicos — Configuración completa desde el panel (sin editar archivos para la mayoría de los ajustes)
- Permisos granulares — Motor de permisos por rol respaldado por la BD con creación de roles personalizados
- Sistema de webhooks — Webhooks multi-endpoint compatibles con Discord, Slack y JSON genérico (13 eventos)
- Notas de jugador — Notas entre miembros del staff en los perfiles de jugador
- Registro de auditoría avanzado — 7 filtros, exportación CSV, tarjetas de estadísticas, purga automática
- Tramos de riqueza — Rangos configurables de distribución de riqueza
- Seguimiento de actividad del staff — Mapas de calor, gráficas de tendencia, ranking, desglose por categoría
v2.0.0
- Compatibilidad multi-framework — ESX Legacy, QBCore y mapeo de tablas para frameworks personalizados
- Control de acceso basado en roles — 4 roles integrados con permisos de página y de acción configurables
- Protección CSRF — Todos los formularios y peticiones que cambian estado
- Protección XSS — Escape de salida en todos los datos generados por usuarios
- Caché segura — Caché basada en JSON que sustituye a la serialización PHP insegura
- Limitación de intentos — Limitación de intentos de inicio de sesión con bloqueo configurable
- Interfaz modernizada — Tema oscuro con la familia tipográfica Inter, variables CSS, diseño adaptable
- Dependencias actualizadas — jQuery 3.7, DataTables 1.13, Font Awesome 6.5
- Refuerzo de seguridad — Eliminados los hashes de contraseña expuestos, controladores solo POST, protección contra autoborrado, limpieza de código de depuración
Licencia
Este es un producto comercial. Queda prohibida la redistribución, reventa o modificación para reventa sin autorización.
© 2024–2026 XeX Game Management. Todos los derechos reservados.