Inicio › Documentación › Configuración · origen_propplacer

Configuración · origen_propplacer

Toda la configuración está en config.lua, en la raíz del recurso.

General

Clave	Por defecto	Descripción
`Config.Locale`	`'en'`	Idioma de la interfaz. Valores aceptados: `'en'`, `'es'`

Permisos

Clave	Por defecto	Descripción
`Config.AdminGroups`	`{ "admin", "superadmin" }`	Nombres de grupo de ESX que dan acceso de administrador
`Config.QBAdminGroups`	`{ "god", "admin" }`	Valores de `PlayerData.group` de QBCore / QBX que dan acceso de administrador

Estos grupos solo se comprueban si origen_admin no está en ejecución y no hay permisos ACE configurados. Consulta Dependencias para ver la cadena de resolución completa.

Colocación

Clave	Por defecto	Descripción
`Config.DeleteRadius`	`5.0`	Distancia máxima (metros) para borrar un prop cercano mediante comando
`Config.DefaultStep`	`0.05`	Incremento de movimiento (metros) al desplazar un prop con el teclado
`Config.SnapAngle`	`45.0`	Valor de ajuste del ángulo (grados) al rotar un prop
`Config.PlacementDefaultDist`	`15.0`	Distancia por defecto respecto al jugador al entrar en el modo de colocación
`Config.PlacementMinDistance`	`2.0`	Distancia mínima de colocación permitida
`Config.PlacementMaxDistance`	`100.0`	Distancia máxima de colocación permitida
`Config.PlacementScrollStep`	`1.0`	Cambio de distancia por cada paso de la rueda durante la colocación

Streaming

Clave	Por defecto	Descripción
`Config.StreamRange`	`120.0`	Radio (metros) en el que se generan los props alrededor del jugador
`Config.StreamInterval`	`750`	Milisegundos entre cada tick del streamer (mínimo: 200)
`Config.StreamLogs`	`false`	Si es `true`, imprime en la consola del cliente los eventos de spawn/despawn

El streamer procesa hasta 25 operaciones de spawn y 40 de despawn por tick para evitar bajadas bruscas de FPS.

Cooldowns y límites

Clave	Por defecto	Descripción
`Config.PlaceCooldownMs`	`500`	Milisegundos mínimos entre acciones de colocar consecutivas por jugador
`Config.BatchCooldownMs`	`2000`	Milisegundos mínimos entre operaciones de importación por lotes por jugador
`Config.MaxImportBatch`	`500`	Número máximo de props que se pueden importar en una sola operación por lotes
`Config.MaxPropsPerCategory`	`0`	Máximo de props permitidos por categoría. `0` = ilimitado

Copias de seguridad

Clave	Por defecto	Descripción
`Config.BackupInterval`	`0`	Intervalo de copia de seguridad automática en milisegundos. `0` = desactivado
`Config.MaxBackups`	`5`	Número máximo de copias automáticas que se conservan. Al llegar al límite se elimina la más antigua

Catálogo de props

lua

Config.Props = {}

Un array de definiciones de props que aparecen en el explorador de colocación. Cada entrada define un modelo, una etiqueta y una categoría.

lua

Config.Props = {
    { model = "prop_barrier_wat_03a", label = "Water Barrier", category = "Barriers" },
    { model = "prop_bench_01a",       label = "Park Bench",    category = "Furniture" },
}

Campo	Tipo	Descripción
`model`	`string`	Nombre del modelo de prop de GTA V (compatible con hash)
`label`	`string`	Nombre visible en el explorador NUI
`category`	`string`	Grupo de categoría en el explorador. Se crea automáticamente si no existe

Paleta de colores de categorías

lua

Config.CategoryColorPalette = {
    "#e74c3c", "#e67e22", "#f1c40f", "#2ecc71",
    "#1abc9c", "#3498db", "#9b59b6", "#e91e63",
    "#00bcd4", "#8bc34a", "#ff5722", "#607d8b",
    "#795548", "#009688", "#673ab7", "#4caf50",
}

Los colores se asignan automáticamente a las categorías a partir de un hash del nombre de la categoría. Puedes cambiar el color de una categoría desde el panel de gestión del juego; la selección se guarda en el almacenamiento KVP del servidor.