Configuration

Quick reference for configuring markers, scenarios, and privacy controls in config/config.lua.

---

Marker Settings

What you can customize: Marker appearance (type, size, color), visibility distance, interaction range.

Safe to change: All values in this section.

Config.MarkerSettings = {
    type = 2,                           -- Marker type (2 = floor circle)
    scale = {x = 0.2, y = 0.2, z = 0.2}, -- Size
    drawDistance = 2.0,                 -- Visibility range (meters)
    interactionDistance = 1.0           -- Interaction range (meters)
}

Common Types: 2 (floor circle), 1 (cylinder), 20 (rotating cylinder)

---

Scenario Terminal

What you can customize: Terminal location (coords), blip appearance (sprite, color, scale), marker color, interaction key.

Safe to change: coords, sprite, color, scale, name, markerColor, interactKey

Do NOT change: The marker type and scale references (they work correctly as-is).

Config.UIBlip = {
    coords = vector3(470.638, -980.273, 21.949), -- Terminal location
    sprite = 161,                                -- Blip icon (161 = police badge)
    color = 3,                                   -- Blip color (3 = blue)
    scale = 0.8,                                 -- Blip size
    name = 'MRPD Scenarios',
    markerColor = { r = 0, g = 150, b = 255, a = 50 }, -- RGBA color
    interactKey = 38,                            -- E key
}

To change location: Get in-game coords and update coords = vector3(X, Y, Z)

---

Privacy Rooms

What you can customize: Marker positions (coords), marker colors (color), marker display names (name).

⚠️ Do NOT change:

• ipl - Must match your MLO interior name exactly

• roomCoords - Interior reference coordinates (leave as-is)

• entitySetsOn / entitySetsOff - Must match your YTYP entity set names exactly

These values are tied to your map files. Changing them will break the privacy system!

Config.Rooms = {
    {
        name = "MRPD Observation Room 01",
        ipl = "tstudio_mrpd_garage_milo_",
        roomCoords = vector3(459.15, -991.88, 22.57),
        markers = {
            {
                id = "obs01_privacy",              -- Unique ID
                name = "Privacy Controls",
                coords = vector3(462.93, -988.33, 21.95),
                color = {r = 60, g = 82, b = 145, a = 50},
                entitySetsOn = { "observation01_pv_on" },
                entitySetsOff = { "observation01_pv_off" }
            },
        }
    },
}

---

Scenarios

What you can customize: Card appearance (title, description, duration, image path), scenario information for players.

⚠️ Do NOT change:

• id - Used internally for tracking (only change if adding NEW scenarios)

• interior - Must match your MLO interior name exactly

• entitysets - Must match your YTYP entity set names exactly

These values control which props appear in-game. Incorrect names will cause scenarios to not work!

Config.Cards = {
    {
        id = 'scenario-01',
        title = 'SAFE\nHOUSE',
        description = 'Secure and clear a safe house location.',
        duration = 20,
        durationUnit = 'Minutes',
        showDuration = false,
        image = './1.jpg',
        interior = 'tstudio_mrpd_int_garage',
        entitysets = { 'scenario_set01' }
    },
}

---

Troubleshooting

Issue	Fix
Markers not showing	Check coords, draw distance, and IPL
UI won't open	Verify coords and interaction distance
Entity sets not working	Match names exactly with YTYP file
Scenarios not syncing	Check server console for errors