Instalación

Antes de empezar#

Antes de instalar Admin Menu, asegúrate de que tu servidor cumple los requisitos mínimos. Solo tres cosas son obligatorias; todo lo demás es opcional y se detecta solo.

Todo lo específico de un framework o de terceros está detrás de un pequeño archivo de bridge abierto, y el recurso elige el correcto mirando lo que ya está en ejecución:

Cada integración opcional tiene un respaldo silencioso. Si falta un recurso, esa parte funciona en modo standalone en lugar de dar error. Integraciones tiene los detalles y cómo fijar uno a mano.

Descargar Admin Menu#

Después de comprar Admin Menu, el recurso se vincula automáticamente a tu cuenta de CFX Portal.

Inicia sesión en CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Admin Menu.

Después de extraer la descarga, deberías tener lo siguiente:

[sql]/
└── database.sql        -- import once, before the first start
[install]/
└── server.cfg          -- the ACE lines to paste into yours
qs-adminmenu/
├── config/main.lua     -- what you may edit
├── custom/             -- framework bridges (editable)
├── client/custom/      -- inventory, weather and voice bridges (editable)
├── server/custom/      -- inventory, garage, medical, weather and voice bridges (editable)
├── server/webhooks.lua -- Discord webhook URLs
├── locales/            -- 41 languages
└── web/                -- the interface, ready to use

La carpeta debe llamarse qs-adminmenu. La ruta de la interfaz, los permisos ACE y todos los exports (exports['qs-adminmenu']) dependen de ese nombre, así que una copia renombrada deja de funcionar.

Instalar el recurso#

Mueve la carpeta qs-adminmenu al directorio de recursos de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:

resources/
└── [qs]/
    └── qs-adminmenu/

Después abre tu server.cfg y asegúrate de que todas las dependencias (y todo lo que deba detectar) se inician antes que Admin Menu:

set onesync on

ensure oxmysql
ensure ox_lib

# Framework
ensure es_extended
# ensure qb-core
# ensure qbx_core

# Inventory, keys, weather, medical, screenshots
ensure ox_inventory
ensure qs-vehiclekeys
ensure qs-zoneweather
ensure qs-medical-creator
ensure screenshot-basic

ensure qs-adminmenu

El orden de carga importa para las capas de framework, inventario, llaves y médico: se detectan una sola vez, cuando se inicia Admin Menu, así que un recurso que se inicia después no se encuentra. El clima es la excepción: se vuelve a detectar cada vez que un recurso de clima se inicia o se detiene.

Permisos de control de recursos#

La página Resources inicia, detiene, reinicia y actualiza recursos ejecutando los propios comandos del servidor, y FiveM solo permite que un recurso lo haga si tú lo autorizas. Añade estas líneas a server.cfg; también están en [install]/server.cfg:

add_ace resource.qs-adminmenu command.ensure allow
add_ace resource.qs-adminmenu command.start allow
add_ace resource.qs-adminmenu command.stop allow
add_ace resource.qs-adminmenu command.restart allow
add_ace resource.qs-adminmenu command.refresh allow

Sin ellas, todas las acciones sobre recursos responden Command execution failed. Nada más en el menú necesita un ACE.

La base de datos#

Es seguro volver a ejecutar el archivo en una actualización: cada tabla solo se crea si falta, y las filas iniciales se actualizan en lugar de duplicarse. Al iniciar, el recurso también añade cualquier columna o permiso introducido por una versión más nueva, así que una base de datos importada de una versión anterior se pone al día sola.

Obtener acceso de admin#

Admin Menu tiene sus propias cuentas de staff, cada una con un nombre de usuario, una contraseña y un rol. Tu primera cuenta se crea en el juego, y se convierte automáticamente en OWNER del servidor si el juego ya sabe que eres admin. Elige primero una de estas vías:

-- config/main.lua
Config.AdminGroups = {
    'admin',
    'superadmin',
    'god',
}

-- config/main.lua
Config.AdminIdentifiers = {
    'license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
}

Después, en el juego:

1. Abre el menú

   Escribe /adminmenu o pulsa F5. Si aún no tienes cuenta, se abre en la pantalla de registro.

2. Regístrate

   Elige un nombre de usuario (3–32 caracteres: letras, números, _ . -) y una contraseña (6–72 caracteres). Un admin del framework se aprueba al instante con el rol OWNER y acceso completo.

3. Trae a tu staff

   Todos los demás se registran igual con /adminmenu. Su cuenta queda como pending hasta que alguien con el permiso auth.approve la apruebe en el panel. Empieza con el rol MODERATOR; dale otro desde Roles & Permissions.

Una cuenta está vinculada al identificador desde el que se registró. Se rechaza iniciar sesión en la cuenta de otra persona desde otra licencia de Rockstar (u otro personaje, en modo multipersonaje), incluso con la contraseña correcta.

Configurar el recurso#

Los roles, los permisos, las etiquetas de admin, la cola, la densidad de tráfico y el clima se editan desde el panel y se guardan en la base de datos. Los archivos son para la fontanería:

Los valores que conviene revisar primero:

Config.Locale       = 'en'          -- any of the 41 locale codes
Config.OpenCommand  = 'adminmenu'   -- chat command that opens the panel
Config.Shortcuts    = {
    openMenu   = 'F5',
    noclip     = 'PAGE_DOWN',
    fastAction = 'DELETE',
}
Config.Reports.OpenCommand = 'report'   -- the players' report window
Config.Bans.AppealUrl      = ''         -- shown to banned players
Config.Debug               = false      -- extra console output

Verificar la instalación#

Reinicia tu servidor y lee la consola. Deberías ver el framework que se cargó y que cada módulo informa de que está listo:

[qs-adminmenu] Framework loaded: esx
[auth.migrations] permission catalog ready
[bans] ready, 0 active ban(s)
[reports.migrations] ready
[logs.migrations] ready

Framework loaded: none significa que no había ningún framework en ejecución cuando se inició Admin Menu: muévelo por encima de ensure qs-adminmenu. Una línea que dice que falta una tabla significa que database.sql no se importó en esta base de datos.

Después entra en tu servidor y sigue el primer recorrido:

1. Crea tu cuenta

   /adminmenu, regístrate y llegarás al Dashboard como OWNER.

2. Prueba los atajos

   Cierra el panel, pulsa PAGE DOWN para el noclip y DELETE para el Fast Action Menu.

3. Envíate un reporte

   Escribe /report, envía un reporte de bug y mira cómo llega como alerta y a la página Reports. A partir de aquí, Uso cubre cada página del panel.

A partir de ahora, los permisos del staff, los roles, la cola y las etiquetas de admin se editan en el panel, sin necesidad de reiniciar.