Documentación de Menu radial

Que hace

ov_radial es un menu radial para servidores FiveM con qb-core: una rueda de accesos rapidos con inventario, telefono, emotes, ropa, vehiculo, mapa, filtros de pantalla, audio, comandos propios y acciones de trabajo (policia y ambulancia). Reemplaza a qb-radialmenu y a codem-supreme-radialmenu, y mantiene sus exports para que los scripts que agregaban opciones sigan funcionando.

Lo mas importante:

Dos formas de abrirlo: mantener F3 y soltar sobre un sector, o un toque rapido para dejar la rueda fija y elegir con clic. Tambien con el comando /radial.
Sectores incluidos: Personaje, Policia, Ambulancia, Ropa, Vehiculo, Mapa, Pantalla, Audio, Comandos y Administracion.
Se adapta solo: una entrada se oculta si su recurso no esta iniciado, si el comando no existe o si el trabajo no corresponde. Nada aparece roto.
Vehiculo: puertas, ventanas, asientos, motor, extras, luz interior, voltear vehiculo y baul (entrar o meter a alguien).
Ropa: quitar o poner prendas y accesorios.
Comandos propios: cada jugador guarda hasta 12 atajos a sus comandos favoritos.
Filtros de pantalla, rango de voz del microfono y silenciar la musica.
Compatibilidad: expone AddMenuItem, RemoveMenuItem, AddOption y RemoveOption con el mismo uso que los radiales a los que reemplaza.
Sin base de datos: no crea tablas; los comandos propios se guardan en el cliente de cada jugador.

Requisitos

Requisito	Detalle
Framework	`qb-core`
Dependencias declaradas en el fxmanifest	`qb-core`, `ox_lib`
Lua	5.4 (`lua54 'yes'`)
Base de datos	No usa
Recursos opcionales	Cada entrada aparece solo si su recurso existe. Ver la lista al final de esta seccion

El fxmanifest declara provide 'qb-radialmenu' y provide 'codem-supreme-radialmenu': no debes tener esos radiales activos a la vez.

Recursos opcionales que activan entradas del menu:

Entrada	Recurso o comando que la activa
Cambiar de trabajo	export `OpenWheel` de `ov_multijob`
Limpiar llaves	`ox_inventory`
Sector Policia	`frkn-policejob` (y `frkn-dispatch` para el boton de panico), trabajo `police` en servicio
Sector Ambulancia	`0r-ambulancejob`, trabajo `ambulance` en servicio
Microfono	`pma-voice`
Musica (silenciar)	`xsound`
Parkour	`beeju_parkour`
Cambiar ropa (admin)	`illenium-appearance`
Inventario, telefono, billetera, emotes, reportar, etc.	Que exista el comando correspondiente (ver Comandos y permisos)

Instalacion

Descarga el recurso desde el Portal de Cfx.re (seccion de assets comprados) con la cuenta Cfx.re con la que hiciste la compra. El recurso viene protegido con Asset Escrow de Cfx.re: solo funciona en servidores cuya clave de licencia pertenece a tu cuenta.
Detiene y retira de server.cfg tu radial anterior (qb-radialmenu o codem-supreme-radialmenu).
Copia la carpeta ov_radial dentro de resources.
Agrega en server.cfg, despues de ox_lib y qb-core:

   ensure ov_radial

Inicia el servidor. No hay archivo .sql, no se crean tablas y no hay convars que configurar. No necesita permisos ACE propios.

Archivos editables: en el fxmanifest.lua, escrow_ignore deja sin cifrar la carpeta web/** (interfaz) y shared/config.lua. Los demas archivos, incluido shared/blips.lua y la definicion del menu en client/menu.lua, no estan en escrow_ignore, asi que van cifrados por Asset Escrow. Para agregar o quitar opciones sin editar esos archivos, usa los exports descritos mas abajo.

Configuracion

Todo esta en shared/config.lua. Opciones principales:

Clave	Valor por defecto	Para que sirve
`Config.Key`	`'F3'`	Tecla por defecto (cada jugador puede cambiarla en Ajustes, Teclas, FiveM, "Menu radial")
`Config.Command`	`'radial'`	Comando que abre la rueda ya fija
`Config.TapToStickMs`	`250`	Un toque mas corto que esto deja la rueda fija
`Config.DistanciaVehiculo`	`5.0`	Distancia maxima para acciones de vehiculo
`Config.VelocidadMaximaCambioAsiento`	`100.0`	Velocidad maxima para cambiar de asiento
`Config.TiempoVoltear`	`12000`	Duracion (ms) de la accion de voltear un vehiculo
`Config.MaxComandosPropios`	`12`	Comandos propios por jugador
`Config.ItemsLlave`	`{ 'car_key', 'vehiclekeys' }`	Items que borra "Limpiar llaves"
`Config.EsperaLimpiarLlaves`	`5000`	Espera (ms) entre limpiezas de llaves
`Config.Voz`	`rangos = { 3.0, 15.0, 25.0 }`, `nombres`, `inicial = 2`	Rangos de voz (susurro, normal, grito)
`Config.Filtros`	5 filtros	Filtros de pantalla: sin filtro, cinematografico, calido, noir y grano de cine
`Config.ComandosIniciales`	`{ label = 'Reportar', command = 'reporte' }`	Comando que traen los jugadores nuevos
`Config.Baul.distancia`	`3.0`	Distancia al baul
`Config.Baul.distanciaJugador`	`2.0`	Distancia a la persona que se mete en el baul
`Config.Baul.modelosBloqueados`	17 deportivos (por ejemplo `zentorno`, `infernus`)	Vehiculos sin baul accesible
`Config.Baul.clases`	tabla por clase de vehiculo	Si la clase permite entrar al baul y el desplazamiento de la posicion

Comandos y permisos

Elemento	Detalle
Tecla `F3` (mantener)	Abre la rueda; soltar sobre un sector lo elige
Tecla `F3` (toque rapido)	La rueda se queda abierta y eliges con clic
`/radial`	Abre la rueda fija
`/radialdebug`	Imprime en F8 las opciones ocultas y el motivo de cada una

Comandos que ejecuta el menu (los de otros recursos solo aparecen si estan registrados): inventory o inv, phone o telefono, wallet o billetera, emotemenu o emotes, reporte, checkjob o job, hub, reloadskin, saveSkin, logout, cambiarvip, clearstuckprops, pdaction, pdcuff, pduncuff, prisontablet, dispatch, facilitypanel, revivep, 911e, qadmin / admin / adminmenu, reportesadmin y crafting_creator.

Sector Administracion: se muestra a quien el servidor reconoce como staff: ACE group.admin, qbcore.god o qbcore.admin, o permiso de qb-core god o admin.

Exports del cliente (para otros scripts)

Export	Uso
`AddMenuItem(item)`	Agrega una opcion o un submenu
`RemoveMenuItem(id)`	La retira
`AddOption(data, id)`	Igual que `AddMenuItem`, con el id como segundo parametro
`RemoveOption(id)`	La retira
`OpenMenu()` / `CloseMenu()`	Abre o cierra la rueda
`IsOpen()`	`true` si esta abierta

Campos que acepta un item: id (obligatorio), label o title, icon, desc, canOpen (funcion que devuelve true o false), shouldClose = false (mantener abierta tras elegir), items (submenu), y la accion: type = 'command' o 'qbcommand' con event = nombre del comando, o event con type = 'server' para evento de servidor (el evento de cliente es el valor por defecto), mas args opcionales.

exports.ov_radial:AddMenuItem({
    id = 'mi_opcion',
    label = 'Mi opcion',
    icon = 'star',
    type = 'command',
    event = 'micomando',
})

Como se usa

Manten F3, mueve el raton hacia un sector y suelta para elegirlo. O da un toque rapido para que la rueda quede fija y elige con clic.
Algunos sectores abren un submenu. Para volver atras puedes usar la tecla de retroceso del mando o la opcion de volver de la interfaz.
Personaje: inventario, telefono, billetera, emotes, reportar, trabajo (cambiar de trabajo, mi trabajo, centro de empleo), apariencia (recargar y guardar skin), cuenta (cambiar de personaje, cambiar VIP, limpiar llaves) y ayuda (destrabar la interfaz, limpiar props, parkour).
Limpiar llaves borra todas las llaves de vehiculos del inventario del jugador. El servidor lo limita con una espera entre usos.
Vehiculo: abre puertas, ventanas, asientos, extras o luz interior, enciende o apaga el motor, voltea un vehiculo volcado y usa el baul.
Comandos: el jugador agrega hasta 12 atajos (nombre de hasta 24 caracteres y un comando de hasta 60) desde "Editar comandos". Se guardan en su propio cliente.
Las entradas de policia y ambulancia solo aparecen con el trabajo correspondiente y en servicio.

Para administradores

Si una opcion no aparece, ejecuta /radialdebug y revisa F8: indica si falta un recurso, un comando o una condicion de trabajo.
Para agregar opciones propias, usa el export AddMenuItem desde tus scripts (ver ejemplo arriba). No hace falta editar el recurso.
Cambia la tecla por defecto con Config.Key (los jugadores que ya la cambiaron conservan su propia tecla).
Ajusta los rangos de voz, filtros, comandos iniciales y modelos sin baul en shared/config.lua y reinicia el recurso.
Si cambias de recurso de policia, ambulancia u otros, ten en cuenta que esas entradas estan ligadas a los recursos y comandos listados en Requisitos. Las opciones de tu recurso las puedes anadir con AddMenuItem.

Preguntas frecuentes

Es compatible con scripts que agregaban opciones a qb-radialmenu o a codem-supreme-radialmenu? Si: el recurso declara provide de ambos y ofrece AddMenuItem, RemoveMenuItem, AddOption y RemoveOption. Verifica con tu script concreto.

Falta el sector de policia o ambulancia. Solo aparece con el trabajo police o ambulance en servicio, y con los recursos que usa (frkn-policejob, 0r-ambulancejob). Revisa /radialdebug.

Como cambio la tecla? Cada jugador, en Ajustes, Teclas, FiveM, "Menu radial". El valor por defecto se cambia en Config.Key.

Los comandos propios se pierden? Se guardan localmente en el cliente de cada jugador (no en la base de datos), por lo que dependen de su instalacion de FiveM.

El baul no deja entrar en ciertos vehiculos. Revisa Config.Baul.modelosBloqueados y Config.Baul.clases.

Donde veo los errores? En la consola F8 del cliente (mensajes [ov_radial]) y en la consola del servidor.

Actualizaciones y soporte

Las versiones nuevas aparecen en el Portal de Cfx.re (en tus recursos comprados) y en la tienda. Descargalas con la misma cuenta Cfx.re de la compra y reemplaza la carpeta, conservando tus cambios en shared/config.lua. Para soporte, abre un ticket en el Discord de la tienda: [enlace de soporte]. Indica la version del recurso, el error de consola y los pasos para reproducirlo.