Início › Documentação › Configuração · origen_propplacer

Configuração · origen_propplacer

Toda a configuração está em config.lua, na raiz do recurso.

Geral

Chave	Por omissão	Descrição
`Config.Locale`	`'en'`	Idioma da interface. Valores aceites: `'en'`, `'es'`

Permissões

Chave	Por omissão	Descrição
`Config.AdminGroups`	`{ "admin", "superadmin" }`	Nomes de grupo do ESX que dão acesso de administrador
`Config.QBAdminGroups`	`{ "god", "admin" }`	Valores de `PlayerData.group` do QBCore / QBX que dão acesso de administrador

Estes grupos só são verificados se o origen_admin não estiver em execução e não houver permissões ACE configuradas. Consulta Dependências para veres a cadeia de resolução completa.

Colocação

Chave	Por omissão	Descrição
`Config.DeleteRadius`	`5.0`	Distância máxima (metros) para apagar um prop próximo através de comando
`Config.DefaultStep`	`0.05`	Incremento de movimento (metros) ao deslocar um prop com o teclado
`Config.SnapAngle`	`45.0`	Valor de ajuste do ângulo (graus) ao rodar um prop
`Config.PlacementDefaultDist`	`15.0`	Distância por omissão ao jogador ao entrar no modo de colocação
`Config.PlacementMinDistance`	`2.0`	Distância mínima de colocação permitida
`Config.PlacementMaxDistance`	`100.0`	Distância máxima de colocação permitida
`Config.PlacementScrollStep`	`1.0`	Variação da distância por cada passo da roda durante a colocação

Streaming

Chave	Por omissão	Descrição
`Config.StreamRange`	`120.0`	Raio (metros) em que os props são gerados à volta do jogador
`Config.StreamInterval`	`750`	Milissegundos entre cada tick do streamer (mínimo: 200)
`Config.StreamLogs`	`false`	Se for `true`, imprime na consola do cliente os eventos de spawn/despawn

O streamer processa até 25 operações de spawn e 40 de despawn por tick para evitar quedas bruscas de FPS.

Cooldowns e limites

Chave	Por omissão	Descrição
`Config.PlaceCooldownMs`	`500`	Milissegundos mínimos entre ações de colocar consecutivas por jogador
`Config.BatchCooldownMs`	`2000`	Milissegundos mínimos entre operações de importação em lote por jogador
`Config.MaxImportBatch`	`500`	Número máximo de props que podem ser importados numa única operação em lote
`Config.MaxPropsPerCategory`	`0`	Máximo de props permitidos por categoria. `0` = ilimitado

Cópias de segurança

Chave	Por omissão	Descrição
`Config.BackupInterval`	`0`	Intervalo de cópia de segurança automática em milissegundos. `0` = desativado
`Config.MaxBackups`	`5`	Número máximo de cópias automáticas a manter. Ao atingir o limite, a mais antiga é apagada

Catálogo de props

lua

Config.Props = {}

Um array de definições de props que aparecem no navegador de colocação. Cada entrada define um modelo, uma etiqueta e uma categoria.

lua

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

Campo	Tipo	Descrição
`model`	`string`	Nome do modelo de prop do GTA V (compatível com hash)
`label`	`string`	Nome visível no navegador NUI
`category`	`string`	Grupo de categoria no navegador. É criado automaticamente se não existir

Paleta de cores das categorias

lua

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

As cores são atribuídas automaticamente às categorias com base num hash do nome da categoria. Podes alterar a cor de uma categoria a partir do painel de gestão do jogo; a seleção fica guardada no armazenamento KVP do servidor.