Configuración

Guía de Configuración

Este archivo detalla todas las opciones disponibles en el archivo config.lua para personalizar el script rc-billing.

Antes de continuar, asegúrate de haber completado la Guía de Instalación.

---

Configuración General

Estas opciones controlan el comportamiento fundamental del script.

Opción	Tipo	Por Defecto	Descripción
Config.Locale	string	'en'	Idioma por defecto para la interfaz web. Opciones: 'en', 'es'.
Config.AllowPersonalInvoices	boolean	true	Habilita (true) o deshabilita (false) la creación de facturas entre jugadores.
Config.CreateInvoicePermission	string	'rc-billing.create'	Permiso ACE requerido para crear facturas personales.
Config.MaxInvoiceAmount	number	1000000	Cantidad máxima de dinero para una sola factura.
Config.PaymentAccount	string	'bank'	Cuenta desde la que se paga ('bank' o 'money').
Config.UseFrameworkPlayerNames	boolean	true	Si es true, usa el nombre del personaje del framework (ESX/QB). Si es false, usa el nombre de la cuenta de FiveM.
Config.DefaultMugshotUrl	string	URL	Imagen de perfil por defecto para jugadores sin una específica.

Configuración de Trabajos de Empresa (Config.CompanyJobs)

Esta sección te permite definir qué trabajos pueden emitir facturas de empresa y quién dentro de esa empresa tiene permiso para hacerlo.

El script detecta automáticamente el framework (ESX, QBCore, Qbox) para gestionar los trabajos y los rangos.

Estructura de un Trabajo

Cada entrada en la tabla Config.CompanyJobs representa un trabajo y se configura de la siguiente manera:

Config.CompanyJobs = {
    ['nombredeltrabajo'] = { -- El nombre interno del trabajo (ej: 'police', 'ambulance')
        label = 'Nombre para Mostrar', -- Nombre público que aparecerá en la UI
        minRank = 1, -- Rango numérico MÍNIMO para crear facturas
        bossRank = 3, -- Rango numérico MÍNIMO para cancelar facturas de la empresa
        account = 'society_police', -- (Opcional) Cuenta de sociedad para pagos.
        logo = 'URL_DEL_LOGO' -- URL de un logo para la empresa
    },
}

• label: El nombre que se muestra en la interfaz para identificar a la empresa.

• minRank: El nivel de rango (en número) que un empleado necesita como mínimo para poder crear facturas en nombre de la empresa.

• bossRank: El nivel de rango (en número) mínimo para ser considerado "jefe". Los jefes pueden ver y cancelar todas las facturas emitidas por su empresa.

• logo: URL de una imagen que se usará como logo de la empresa en la interfaz.

Nota: El campo account es opcional. Si no se define, el sistema usará el valor por defecto del framework (ej: society_police para el trabajo police en ESX).

Ejemplo de Configuración

Config.CompanyJobs = {
    ['police'] = {
        label = 'Los Santos Police Department',
        minRank = 3,                         -- Sargento o superior puede facturar
        bossRank = 5,                        -- Teniente o superior puede cancelar facturas de la empresa
        account = 'society_police',          -- Cuenta de sociedad para los pagos
        logo = 'https://iili.io/Hg0h0Ux.png' -- URL del logo de la policía
    },
    ['ambulance'] = {
        label = 'Pillbox Hospital',
        minRank = 2,                         -- Médico o superior puede facturar
        bossRank = 4,                        -- Cirujano Jefe o superior puede cancelar
        logo = 'https://static.wikia.nocookie.net/offscriptrp/images/0/07/PillboxLogo1.png'
    },
}

Localización y Traducciones

Las traducciones se gestionan en dos lugares:

1. Lua (Servidor/Cliente): Los textos usados en notificaciones del juego y comandos se encuentran en la carpeta locales/. Puedes editar los archivos .json existentes o añadir nuevos.

2. Web (Interfaz): Los textos de la interfaz web están en web/src/locales/. Para añadir un nuevo idioma o modificar los existentes, edita los archivos .json en esta carpeta.

Importante: Si realizas cambios en los archivos de la carpeta web/src/locales, recuerda que necesitas compilar la interfaz de nuevo para que los cambios se apliquen.