Cuxial Gang se configura en tres sitios: shared/config.lua para el comportamiento general, un archivo por actividad en data/ y el panel de staff para todo lo que vive en la base de datos. Reinicia el recurso después de editar un archivo.

Las ubicaciones, las organizaciones, el catálogo de vehículos, los precios de las mejoras, las recompensas del pase, los territorios, los puntos de extorsión, las favelas y los sitios de airdrop no están en ningún archivo. El staff los edita dentro del juego con /crimeadmin.

shared/config.lua

General

Opción	Tipo	Por defecto	Qué hace
debug	boolean	false	Trazas de depuración en la consola. También se activa con setr cuxial_gang_debug 1.
ui.accent	string	configurable	Color de acento del panel de staff y de los HUD, en hexadecimal. El menú de jefe y la tablet usan el color de cada organización.
admin.ace	string	'mod'	ACE que abre el panel de staff y permite sus comandos. Se comprueba siempre en el servidor.
live.enabled	boolean	true	Las ventanas abiertas se refrescan solas cuando cambian sus datos.
live.debounceMs	number	400	Los cambios del mismo bloque dentro de esta ventana, en milisegundos, se avisan una sola vez.
timeZone	string	'America/New_York'	Zona horaria del servidor, con nombre IANA como Europe/Madrid. La usan los horarios y el pase de temporada.
timeApi	string	una API pública de hora	URL a la que se pide la hora real de timeZone al arrancar; %s se sustituye por la zona. Tiene que devolver un JSON con dateTime o datetime en formato ISO. Cadena vacía = usar el reloj de la máquina.
currency	table	{ currency = 'USD', style = 'currency', format = 'en-US' }	Formato del dinero en la interfaz. currency es el código ISO y format la configuración regional.

commands

Cada entrada es { name = '...', restricted = '...' }.

Opción	Tipo	Por defecto	Qué hace
name	string | false	ver Comandos	Nombre del comando. false elimina el comando.
restricted	string | false	'group.mod' o 'group.admin'	Grupo que ve y puede ejecutar el comando. El ACE de admin.ace se comprueba además.

Las entradas son panel, resetStats, addVehicle, fireMember y setGang.

org

Opción	Tipo	Por defecto	Qué hace
accessMethod	string	'none'	'none': las sedes están en el mundo abierto.
markerSize	number	1.2	Tamaño de los marcadores de la sede.
markerColor	table	{ r, g, b }	Color de los marcadores de la sede.
defaultSlots	number	2	Huecos de rango y de miembro de una organización nueva.
ranksLimit	number	5	Máximo de rangos al que se llega con mejoras.
membersLimit	number	20	Máximo de miembros al que se llega con mejoras.
defaultStashWeight	number	2	Capacidad del alijo de una organización nueva, en kg.
stashCapacityUpgradePer	number	5	Kg que suma cada mejora de alijo.
limitBossMenu	boolean	false	true: solo un miembro a la vez dentro del menú de jefe de una organización.
useDirtyMoneyInBossMenu	boolean	false	true: las mejoras se pagan con dinero negro en lugar del saldo limpio. El pase de temporada premium se paga siempre con el saldo limpio.

garage

Opción	Tipo	Por defecto	Qué hace
disabled	boolean	false	true: sin garaje de organización.
hideMarker	boolean	false	true: oculta el marcador del garaje en la sede.
sellPercentage	number	20	Porcentaje que se pierde cuando una organización vende un vehículo.
nearbyMembersRadius	number	30.0	Metros. Con un miembro más cerca que esto, la grúa no se lleva el vehículo.
idleMinutes	number	5	Minutos que el vehículo tiene que llevar vacío para poder remolcarlo.
noticeSeconds	number	60	Aviso al último conductor antes de la grúa. Si alguien se sube, la grúa se cancela.
maxTowSpeed	number	1.0	Velocidad en m/s por encima de la cual el vehículo cuenta como en marcha y no se remolca.
recover.cost	number	5000	Precio de recuperar al momento un vehículo destruido o desaparecido.
recover.payFrom	string	'org'	Quién paga: 'org' (el saldo de la organización) o 'player' (quien lo pide).
returnOnRestart	boolean	true	true: los vehículos que estaban fuera al reiniciar el servidor vuelven al garaje gratis. false: aparecen como destruidos y se recuperan pagando.

tablet y seasonPass

Opción	Tipo	Por defecto	Qué hace
tablet.asItem	boolean	false	true: la tablet se abre con el ítem y el comando no existe. false: se abre con el comando.
tablet.command	string	'crimetablet'	Comando que abre la tablet.
tablet.item	string	'crime_tablet'	Ítem que abre la tablet.
tablet.missionsPerRestart	number	8	Misiones que se sortean en cada reinicio.
tablet.disableSeasonPass	boolean	false	Oculta el pase de temporada.
tablet.disableRanking	boolean	false	Oculta el ranking.
tablet.disableDarkChat	boolean	false	Apaga el chat oscuro.
seasonPass.customCurrency	boolean	false	false: el pase premium se compra con el saldo limpio de la organización. true: el pase muestra una moneda propia en lugar de dinero y el pase premium no está a la venta.
seasonPass.customCurrencyLabel	string	'CT'	Nombre de esa moneda.

blips

Opción	Tipo	Por defecto	Qué hace
scale	number	0.8	Tamaño de los blips.
showOnMap	boolean	true	Muestra los blips de sedes, garajes, médico, lavado y favelas.
showZonesOnMap	boolean	true	Muestra los blips de las zonas de captura.
medic, organisation, zone, garage, port, helipad, moneyLaundry, laundryStop	table	{ id, color }	Sprite y color de cada tipo de blip.
laundryRadius	table	{ color, alpha, radius }	Área que se dibuja alrededor de una parada de lavado.

zones

Opción	Tipo	Por defecto	Qué hace
disabled	boolean	false	true: sin zonas de captura.
tickSeconds	number	1	Cada cuánto cuenta el servidor quién hay dentro de cada zona.
cooldownMinutes	number	15	Minutos hasta que una zona capturada se puede volver a disputar.
captureExp	number	150	Experiencia por capturar una zona.
list	table	ejemplos	Las zonas: label, un index único, coords para el blip y los points del polígono. Las dos incluidas son ejemplos que hay que sustituir.

turf

Opción	Tipo	Por defecto	Qué hace
disabled	boolean	false	true: sin territorios.
disableEnterNotifications	boolean	true	false: avisa al jugador al entrar y al salir de un territorio.
activityWindow	table	{ enabled = false, start = '23:00', finish = '11:00' }	Franja en la que cuentan las actividades de territorio, en hora del servidor. Puede cruzar la medianoche.
rivalry.disabled	boolean	false	true: las organizaciones no pueden declarar guerras.
rivalry.startPrice	number	5000	Precio de declarar una guerra.
rivalry.durationHours	number	1	Horas que dura una guerra declarada.
rivalry.ownershipHours	number	24	Horas que dura la propiedad, solo con control.enabled = false.
rivalry.winExp	number	250	Experiencia por ganar una guerra.
rivalry.bonusMultiplier	number	0.5	Durante una guerra, esta fracción del precio de cada venta se suma a la puntuación de guerra de la organización del vendedor.
drugSelling.expPerSale	number	15	Experiencia por venta.
drugSelling.loyaltyPerSale	number	50	Lealtad que se gana por venta en la zona.
drugSelling.loyaltyLossForOthers	number	15	Lealtad que pierden las demás organizaciones por venta.

turf.control

Control de zona decidido por las ventas. Con enabled = false, la propiedad simplemente caduca a las rivalry.ownershipHours.

Opción	Tipo	Por defecto	Qué hace
enabled	boolean	true	Activa el control de zona.
windowDays	number	3	Ventana móvil, en días, con la que se decide el dueño y el nivel de conflicto.
claimUnits	number	40	Unidades que tiene que vender una organización para quedarse una zona sin dueño.
disputedUnits	number	15	Unidades de un rival que dejan la zona disputada (nivel 1).
hotRatio	number	0.6	Nivel 2: el rival llega a esta fracción de las ventas del dueño.
takeoverMargin	number	0.15	Nivel 3: el rival supera al dueño por este margen y se abre una guerra.
warHours	number	2	Horas de una guerra abierta por el control de zona.
abandonDays	number	7	Días sin ventas tras los que la zona pierde a su dueño.
minOwnerOnline	number	1	Miembros del dueño conectados para que una guerra pueda empezar.
sweepCron	string	'*/10 * * * *'	Cron del repaso periódico que baja los niveles cuando las ventas salen de la ventana.
rankingPointsPerZone	number	50	Puntos de ranking por zona controlada.

turf.sales

Opción	Tipo	Por defecto	Qué hace
maxUnitsPerHour	number	40	Unidades que puntúan por personaje y hora. Lo que pase de ahí se vende pero no cuenta.
ownZoneMultiplier	number	1.0	Multiplicador de precio en tu propia zona.
enemyZoneMultiplier	number	1.2	Multiplicador de precio en una zona enemiga.
disputedMultiplier	number	1.1	Multiplicador de precio en una zona disputada.
graffitiPointsMultiplier	number	1.5	Extra de puntos con un grafiti propio cerca.
graffitiPriceMultiplier	number	1.1	Extra de precio con un grafiti propio cerca.
taxPercent	number	10	Porcentaje de cada venta ajena que se genera como dinero negro para el dueño.
hotAlertMultiplier	number	1.5	Desde el nivel 2, multiplica la probabilidad de aviso a la policía.
hotRejectMultiplier	number	1.5	Desde el nivel 2, multiplica la probabilidad de que el comprador se eche atrás.
alertWindowMinutes	number	30	Ventana con la que se cuenta la racha de un vendedor en una zona.
alertRadiusAfter	number	3	Ventas seguidas tras las que el dueño recibe un área en el mapa.
alertPreciseAfter	number	5	Ventas seguidas tras las que el área pasa a ser precisa.
alertRadius	number	300.0	Radio del área amplia, en metros.
alertPreciseRadius	number	70.0	Radio del área precisa, en metros.
alertBlipSeconds	number	90	Segundos que el área se queda en el mapa.

rope, logs, steam, retention

Opción	Tipo	Por defecto	Qué hace
rope.enabled	boolean	true	Activa el menú de interacción sobre jugadores.
rope.keybind.enabled	boolean	true	Registra una tecla para el menú.
rope.keybind.key	string	'F6'	Tecla por defecto. Cada jugador puede cambiarla.
logs.general	string	'cuxial_gang_webhook'	Nombre de la convar con el webhook de las acciones de jugadores.
logs.admin	string	'cuxial_gang_webhook_admin'	Nombre de la convar con el webhook de las acciones de staff.
steam.convar	string	'cuxial_gang_steam_key'	Nombre de la convar con la clave de la Steam Web API, para los avatares del staff.
retention.playerActionsDays	number	30	Días que se conserva el historial de los miembros. 0 = no purgar nunca.
retention.adminLogsDays	number	90	Días que se conservan los registros de staff. 0 = no purgar nunca.
retention.extortionMessagesDays	number	30	Días que se conservan los mensajes de extorsión por teléfono. 0 = no purgar nunca.
additionalScripts.kq_shellcreator	boolean	false	true: espera a que cargue la colisión alrededor del jugador cuando se carga la organización. Para sedes dentro de interiores generados.

Archivos de data/

Cada archivo configura una actividad y empieza con un comentario que describe todas sus opciones. Las coordenadas, los nombres de ítem, los modelos y los precios que traen son ejemplos que hay que adaptar.

Archivo	Qué configura	Interruptor principal (por defecto)
airdrop.lua	Horario, fases, guardias, niveles, sitios y botín por defecto	enabled = true
arsenal.lua	Tipo de banco, niveles, cupos semanales, recetas que se crean en el primer arranque, piezas y el armero	enabled = true
blackMedic.lua	Médico clandestino: tiempo de curación, espera, precio y NPC	Disable = false
clothing.lua	Vestuario y la ropa que se lleva en la ruta de lavado	Clothing.enable = true
drugselling.lua	Drogas vendibles y precios, compradores, espera, aviso a la policía, probabilidad de rechazo, ítem del móvil	—
extortion.lua	Extorsión por teléfono a civiles: víctimas, palabras clave y respuestas	—
extortionFixers.lua	Intermediarios que venden rehenes: precios, puntos de entrega y respuestas	—
favelas.lua	Tiempos de toma, propiedad, límites, tipo de banco y blip	enabled = true
graffiti.lua	Ítems, esperas, duración, lealtad, experiencia, tamaño y superficies prohibidas	disabled = false
helipad.lua	Helipuertos	Disable = false
hostageControl.lua	Menú del rehén NPC, seguimiento y animaciones	—
interactionMenu.lua	Alcance de cada acción sobre un jugador, controles bloqueados y formas de esposar	—
missions.lua	Catálogo de misiones: texto, experiencia, recompensa y condiciones	—
moneyLaundry.lua	Oficina, furgoneta, paradas, importe por parada y comisión	Disable = false
mulas.lua	Huecos de mula, reclutamiento, confianza, límites de los encargos y comando de paso	Disable = false
ports.lua	Puertos y su NPC	Disable = false
racketeering.lua	Espera, experiencia y blip de los puntos de cobro	—
raids.lua	Redadas policiales: trabajos, horario, esperas, qué se puede incautar	enable = false
supply.lua	Puntos de abastecimiento de los carteles: género, ventas pasivas, robo e incautación	enabled = true

En airdrop.lua, startCommand y testCommand son { enabled, name, permission }. permission es el permiso del framework que exige cada comando, 'admin' por defecto, comprobado a través de cuxial_bridge.

En drugselling.lua la tabla drugs es una lista blanca: un ítem que no esté en ella no se puede vender, y su precio sale siempre de esa tabla.

Cambios habituales

Abrir la tablet con un ítem

shared/config.lua

tablet = {
    asItem = true,
    item = 'crime_tablet',
    -- ...
},

El comando deja de existir. Añade el ítem a tu inventario como se indica en Instalación.

Activar las redadas policiales

data/raids.lua

enable = true,
allowedJobs = {
    police = { minimumGradeToStart = 2 },
},
requireDuty = true,

Cambiar el permiso de staff

shared/config.lua

admin = {
    ace = 'gangadmin',
},

server.cfg

add_ace group.admin gangadmin allow

Revisa también commands.*.restricted para que coincida el grupo que ve cada comando.

Poner las drogas y los precios de tu servidor

data/drugselling.lua

drugs = {
    joint = 35,
    weed_brick = 60,
},

Cambiar el formato del dinero

shared/config.lua

currency = { currency = 'EUR', style = 'currency', format = 'es-ES' },