Antes de empezar#
Antes de instalar Radial Menu, asegúrate de que tu servidor cumple los requisitos mínimos. Solo un recurso es obligatorio; el framework es opcional y se detecta solo.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Acceso a la base de datos para lo que guarda el editor del juego. La tabla se crea sola. |
Framework | Opcional | ESX, QBCore, Qbox o vRP, detectado automáticamente. Sin ninguno, el menú funciona de forma independiente y los botones restringidos a un trabajo o una banda permanecen ocultos. |
| Opcional | Es lo primero que leen las condiciones que comprueban un ítem. Sin él, se lee el inventario de ESX o QBCore. |
Todo lo específico de cada framework está detrás de un pequeño archivo puente en custom/, y el recurso elige uno según lo que ya esté en ejecución:
Recurso en ejecución | Config.Framework | Puente |
|---|---|---|
|
|
|
|
|
|
|
|
|
Ninguno |
|
|
Si hay más de un framework en el mismo servidor, configura Config.Framework a mano. Integraciones explica lo que aporta cada puente.
Descargar Radial Menu#
Después de comprar Radial 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 Radial Menu.
Después de extraer la descarga, deberías tener la siguiente carpeta:
qs-radialmenu/
├── config/ -- main.lua and menu.lua: what you may edit
├── custom/ -- framework bridges, actions, conditions, clothing (editable)
├── client/ -- the wheel, the settings and the editor
├── server/ -- admin checks and the database
├── shared/ -- helpers
├── locales/ -- 41 languages, one JSON file each
└── web/ -- the interface, ready to useMantén la carpeta con el nombre
qs-radialmenu. Otros recursos acceden a ella medianteexports['qs-radialmenu'], y la importación del editor lee config/menu.lua con ese nombre: una copia renombrada rompe ambas cosas.
Instalar el recurso#
Mueve la carpeta qs-radialmenu al directorio de recursos de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:
resources/
└── [qs]/
└── qs-radialmenu/Una vez copiada, abre tu server.cfg y asegúrate de que la base de datos y tu framework se inicien antes que Radial Menu:
ensure oxmysql
# Framework
ensure qb-core
# ensure qbx_core
# ensure es_extended
# ensure vrp
# Optional
ensure ox_inventory
ensure qs-radialmenuEl orden de carga importa. El framework se detecta una sola vez, cuando se inicia Radial Menu, y solo cuentan los recursos que ya están iniciados: un framework que se inicia después no se encuentra y el menú funciona de forma independiente.
La base de datos#
No hay ningún archivo SQL que importar. Radial Menu crea una única tabla, qs_radialmenu, en el primer inicio y guarda en ella todo lo que guarda el editor del juego, una fila por documento:
Fila | Contiene | Se guarda desde |
|---|---|---|
| El aspecto del servidor (colores, forma, disposición, tamaño, posición) y los tres permisos de los jugadores. | /radialedit → Appearance, Permissions |
| El menú creado en el editor, y si sustituye a config/menu.lua. | /radialedit → Menu |
| Las acciones con nombre creadas en el editor. | /radialedit → Actions |
Hasta que un administrador guarda algo, las filas no existen y el recurso usa config/main.lua y config/menu.lua tal como están. Las filas se leen una vez al iniciar el recurso y se mantienen en memoria, así que un guardado en el editor nunca espera a la base de datos para llegar a los jugadores.
El aspecto y los atajos de cada jugador no están en el servidor.
/radialsettingslos guarda en el propio PC del jugador, así que siguen al ordenador, no al personaje.
Obtener acceso de administrador#
/radialedit cambia el menú y el aspecto para todos los jugadores, así que el servidor comprueba quién lo abre y quién guarda desde él. Basta con cualquiera de estas vías:
La vía habitual. Añade esta línea a server.cfg con el identificador del jugador:
add_ace identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx qs-radialmenu.saveDefaults allowLos jugadores que ya están en los grupos ACE group.admin o group.god se aceptan sin ella.
Una lista simple de identificadores en config/main.lua. Sirve cualquier identificador del jugador (license, FiveM, Discord, Steam) y la comparación no distingue entre mayúsculas y minúsculas.
Config.AdminIdentifiers = {
'license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
'fivem:1234567',
}Automático, sin nada que configurar. Grupos de ESX admin, superadmin y owner; de QBCore y Qbox admin y god; de vRP admin, superadmin y owner.
¿No conoces los identificadores de un jugador? Pon Config.DevOpenEditor = true, reinicia el recurso y pídele que escriba /radialedit: se abre el editor y la consola del servidor muestra todos sus identificadores. Copia uno en Config.AdminIdentifiers, y luego vuelve a ponerlo en false.
Configurar el recurso#
La configuración está en unos pocos archivos abiertos. Todo lo guardado desde el editor del juego tiene prioridad sobre los valores equivalentes de esos archivos.
Archivo | Contenido |
|---|---|
| Idioma, framework, comandos y teclas, el aspecto del primer inicio, los temas predefinidos, los administradores y las animaciones de ropa. |
| El menú: cada sección y botón, con sus restricciones y condiciones. |
| Tus propias acciones y condiciones con nombre, que se ofrecen en los desplegables del editor. |
| Las once ranuras de ropa, qué significa "quitada" para cada una, y sus animaciones. |
| El puente con tu framework: trabajos, bandas, dinero, ítems, notificaciones, grupos de administración. |
| Todos los textos de la interfaz y las etiquetas del menú por defecto. |
Los valores que conviene revisar primero:
Config.Locale = 'en' -- 41 languages, see locales/
Config.OpenCommand = 'radial' -- /radial opens and closes the wheel
Config.EditCommand = 'radialsettings' -- the player's settings panel
Config.OpenKey = 'F3' -- first-launch key; players rebind it in FiveM
Config.CloseKeys = { 322, 200 } -- ESC; key names work too: { 'ESC', 'X' }
Config.Shape = 'hexagon' -- the look until an admin saves one
Config.LayoutMode = 'radial' -- radial | stack
Config.CarouselAnimation = true
Config.InnerRingMaxItems = 6 -- buttons on the inner ring; the outer holds two more
Config.Debug = false -- explains every menu decision in the F8 console
Config.OpenKeyes solo la tecla que recibe un jugador la primera vez. FiveM recuerda la asignación de cada jugador, así que cambiarla después no mueve una tecla que ya tenga; puede reasignarla en Settings → Key Bindings → FiveM → Radial Menu: Open.
Verificar la instalación#
Tras completar la instalación, reinicia tu servidor y busca la línea que nombra el framework elegido, en la consola del servidor y en la consola F8 cuando entres:
[qs-radialmenu:INFO] Server framework loaded: qb
[qs-radialmenu:INFO] Client framework loaded: qbstandalone significa que no encontró ningún framework en ejecución. Si usas uno, muévelo por encima de ensure qs-radialmenu o configura Config.Framework a mano.
Luego entra en tu servidor y recorre el primer ciclo:
Abre la rueda
Pulsa F3 o escribe
/radial. Haz clic en una sección para abrirla; el clic derecho o Retroceso vuelve un nivel atrás, y ESC cierra la rueda. Colócate junto a un coche y aparecerá una sección Vehicle.Hazlo tuyo
Haz clic en el engranaje del centro de la rueda o escribe
/radialsettings. Elige un tema, una forma y una disposición, y luego Save Settings: la rueda se abrirá así a partir de ahora.Abre el editor
/radialeditse abre en la pestaña Menu. Pulsa Import from menu.lua para cargar el menú incluido en el árbol, luego configura el aspecto del servidor en la pestaña Appearance y guárdalo. Lee El editor del juego antes de activar Override active.
A partir de aquí nada necesita reinicio. El menú, el aspecto del servidor y los permisos de los jugadores se guardan desde el editor y llegan a todos los jugadores al instante.