Home › Documentation › Configuration · origen_propplacer

Configuration · origen_propplacer

All configuration lives in config.lua at the root of the resource.

General

Key	Default	Description
`Config.Locale`	`'en'`	UI language. Accepted values: `'en'`, `'es'`

Permissions

Key	Default	Description
`Config.AdminGroups`	`{ "admin", "superadmin" }`	ESX group names that grant admin-level access
`Config.QBAdminGroups`	`{ "god", "admin" }`	QBCore / QBX `PlayerData.group` values that grant admin-level access

These groups are only checked if origen_admin is not running and no ACE permissions are configured. See Dependencies for the full resolution chain.

Placement

Key	Default	Description
`Config.DeleteRadius`	`5.0`	Maximum distance (meters) to delete a nearby prop via command
`Config.DefaultStep`	`0.05`	Movement increment (meters) when nudging a prop with keyboard
`Config.SnapAngle`	`45.0`	Angle snap value (degrees) when rotating a prop
`Config.PlacementDefaultDist`	`15.0`	Default distance from the player when entering placement mode
`Config.PlacementMinDistance`	`2.0`	Minimum allowed placement distance
`Config.PlacementMaxDistance`	`100.0`	Maximum allowed placement distance
`Config.PlacementScrollStep`	`1.0`	Distance change per scroll tick during placement

Streaming

Key	Default	Description
`Config.StreamRange`	`120.0`	Radius (meters) in which props are spawned around the player
`Config.StreamInterval`	`750`	Milliseconds between each streamer tick (minimum: 200)
`Config.StreamLogs`	`false`	If `true`, prints spawn/despawn events to the client console

The streamer processes up to 25 spawn operations and 40 despawn operations per tick to avoid frame spikes.

Cooldowns and limits

Key	Default	Description
`Config.PlaceCooldownMs`	`500`	Minimum milliseconds between consecutive place actions per player
`Config.BatchCooldownMs`	`2000`	Minimum milliseconds between batch import operations per player
`Config.MaxImportBatch`	`500`	Maximum number of props that can be imported in a single batch operation
`Config.MaxPropsPerCategory`	`0`	Maximum props allowed per category. `0` = unlimited

Backups

Key	Default	Description
`Config.BackupInterval`	`0`	Auto-backup interval in milliseconds. `0` = disabled
`Config.MaxBackups`	`5`	Maximum number of automatic backups to keep. Oldest is deleted when limit is reached

Props catalog

lua

Config.Props = {}

An array of prop definitions that appear in the placement browser. Each entry defines a model, label, and category.

lua

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

Field	Type	Description
`model`	`string`	GTA V prop model name (hash-compatible)
`label`	`string`	Display name shown in the NUI browser
`category`	`string`	Category group in the browser. Auto-created if it does not exist

Category color palette

lua

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

Colors are auto-assigned to categories based on a hash of the category name. You can override a category's color from the in-game management panel — the selection is persisted in server KVP storage.