Faction

Facciones que creas por completo en el juego: cada facción es un job real con menú de jefe, garajes, almacenes, vestuario, ascensor, niveles, menú de acciones y sistema de gangwar. El script crea las tablas por sí mismo.

Funciones

• Creador (/fraktionen): crea facciones en el juego con rangos, sueldo, vehículos, lugares (marker o NPC), blips y acceso a partir de un rango.
• Menú de jefe: gestionar miembros, caja con historial, comprar vehículos, permisos por rango, solicitudes y logs.
• Solicitudes: los jugadores se postulan a facciones en los puntos de solicitud (NPC o marker del creador), la dirección acepta o rechaza en el menú de jefe.
• GPS: los miembros se ven en el mapa, con un icono propio a pie, en coche, en moto o bicicleta, en barco, helicóptero o avión, nadando y al morir (activable por facción).
• Vehículos de facción con estilo: prefijo de matrícula propio, pintura y xenón en el color de la facción, tuning máximo y lunas tintadas. Con llave para cerrar y abrir.
• Garajes y almacenes: hasta 10 de cada uno por facción, acceso a partir de un rango.
• Vestuario, ascensor (hasta 10 plantas) y niveles con XP (activables por facción).
• Menú de acciones (F6): esposar, cachear, identificar, escoltar y acciones de vehículo, a elegir por facción.
• Gangwar: crear zonas en el juego, modos Límite de tiempo y First Contact, dimensión propia, tienda y clasificación.
• Logs de Discord para todas las áreas.

Instalación

1. Pon la carpeta off_faction en resources.
2. Añade en el server.cfg, después de oxmysql y ESX:

ensure oxmysql
ensure es_extended
ensure off_faction

1. Abre /fraktionen, crea una facción y asigna la dirección con /setjob <ID> <name> <rango> (rango más alto = número de rangos − 1).

Configuración

config/settings/config.lua

config/settings/config.gangwar.lua

config/settings/config.actions.lua

config/functions.lua

Aquí conectas tus propios scripts. Los errores en ellas llegan a la consola, el script sigue funcionando.

config/settings/config.server.lua e idiomas

Webhooks de Discord por área (creator, members, money, garage, storage, wardrobe, level, gangwar, actions), url = '' desactiva un log. Todos los textos están en config/locales/ (un archivo por idioma).

En el juego

• Creador (/fraktionen): crea una facción, coloca los lugares con Usar mi posición, ajusta markers, NPC y blips con Ajustar, y en Ajustes activa el sistema de niveles, el garaje, el almacén, el gangwar y las acciones del menú F6. Solo Guardar aplica todo. Arriba cambias a Solicitudes y Zonas de Gangwar.
• Ajustar NPC: elige un modelo de una lista con imágenes de todos los peds de GTA (búsqueda y categorías), además del escenario y la orientación, todo con vista previa en directo en el juego. Un ped addon lo eliges escribiendo el nombre exacto del modelo en la búsqueda.
• Estilo de vehículo (Creador → Vehículos): prefijo de matrícula de hasta 5 caracteres, p. ej. BALLA da BALLA 48. Si cambia el prefijo, al guardar todos los vehículos de la facción reciben una matrícula nueva y los vehículos sacados se eliminan. Además: pintura en el color de la facción, tuning máximo, lunas tintadas y xenón en el color de la facción.
• GPS (Creador → Ajustes): los miembros se ven entre sí en el mapa. El icono cambia según el estado, los colores e iconos están en gps.types. El blip solo muestra la orientación a pie y nadando, los iconos de vehículos siempre están rectos.
• Llaves: quien saca un vehículo de facción puede cerrarlo y abrirlo con U (se puede cambiar en los controles de FiveM). Con vehicleKeys.shared = true pueden hacerlo todos los miembros.
• Solicitudes: los puntos de solicitud los creas en el creador en Solicitudes (hasta 20), como NPC o marker y, si quieres, con blip para todos los jugadores. Sirven para todas las facciones. En el punto, E abre la lista de todas las facciones que aceptan solicitudes, allí envías un texto. Tu propia facción no aparece en la lista. Los miembros con el permiso Invitar miembros reciben un mensaje y ven la solicitud en el menú de jefe en Miembros → Solicitudes. Allí también se pueden cerrar las solicitudes. Aceptar funciona aunque el jugador esté desconectado.
• Registros (menú de jefe, botón inferior): todo lo que pasa en la facción, p. ej. ingresos y retiradas, vehículos sacados, guardados o comprados, almacén, vestuario, miembros, solicitudes, tienda de gangwar y nivel. Los ataques de gangwar no aparecen ahí. Visible para la dirección y los rangos con el permiso Ver registros.
• Lugares: en el menú de jefe, garaje, almacén, vestuario y ascensor, E abre el menú.
• Menú de acciones (F6): actúa sobre el jugador o vehículo que tienes justo delante.
• Esposas duras: solo mirar alrededor. Esposas suaves: andar, pero no correr, saltar ni atacar. Volver a seleccionarlas las quita.
• Cachear: solo a jugadores esposados, solo puedes quitar.
• Escoltar: llevar delante de ti a un jugador esposado. Meter en vehículo / Sacar del vehículo para esposados.
• Vehículo: lavar, reparar, llevar al depósito (los vehículos privados acaban en el depósito de off_garage) e identificar. X cancela.
• Gangwar: en el punto de gangwar, E abre el menú. Una facción pone una zona en cola, otra acepta. Te unes con E en el punto de gangwar.
• Límite de tiempo: empieza al instante, puntos por kill, respawn, te puedes unir hasta el final.
• First Contact: tiempo para unirse en el lobby, luego una vida por jugador.

Para desarrolladores

exports.off_faction:AddXP('vagos', 250)
exports.off_faction:SetLevel('vagos', 5, 0)
local level, xp, needXp = exports.off_faction:GetLevel('vagos')
local faction = exports.off_faction:GetFaction('vagos')
local list = exports.off_faction:GetFactions()
local isFaction = exports.off_faction:IsFaction('vagos')
local name, grade = exports.off_faction:GetPlayerFaction(source)
local allowed = exports.off_faction:HasPermission(source, 'withdraw')
exports.off_faction:AddBalance('vagos', 5000, 'Recompensa')
exports.off_faction:RemoveBalance('vagos', 5000, 'Strafe')

• Todos los exports son del lado del servidor.
• Evento de servidor off_faction:levelUp con (faction, level) al subir de nivel.
• Statebags: offGangwar (ID de la zona en el gangwar), offCuffed ('hard', 'soft' o false), offEscorted (ID de servidor de quien escolta).

Problemas frecuentes

Al arrancar, el script muestra errores y avisos en la consola del servidor.