Elevators

Your TStudio maps come with pre-configured elevators that are ready to use. Elevators allow players to travel between different floors in your interiors. Each elevator appears as a marker on the ground that players can interact with to open a menu and select their destination floor.

All elevator configurations are already included - you don't need to create new ones. This guide shows you how to customize the existing elevators to match your server's style and language.

---

📁 Where to Find Elevator Files

All elevator configurations are stored in the elevators/ folder. Each file represents one or more elevators for a specific TStudio map:

elevators/
├── aldentes.lua          (Al Dente's Restaurant)
├── jurassic_jackpot.lua  (Jurassic Jackpot Casino)
├── mrpd.lua              (Mission Row PD)
├── opium_nights.lua      (Opium Nights)
├── pillbox_md.lua        (Pillbox Medical)
├── tropical_heights.lua  (Tropical Heights)
└── vmc.lua               (Vanilla Unicorn Medical Center)

Note: New elevators will be automatically added when you purchase and install new TStudio map products.

---

⚙️ Enabling or Disabling Elevators

Main Control

Open config.lua and find this setting near the top:

ElevatorsEnabled = true,  -- Set to false to disable all elevator logic

• Set to true = All elevators are active (default)

• Set to false = All elevators are disabled (no markers, menus, or functionality)

After changing this setting, restart the resource:

restart tstudio_zmapdata

---

🎨 What You Can Customize

1. Marker Colors

Open any elevator file (e.g., elevators/mrpd.lua) and find the marker section:

marker = {
    type = 2,        -- Marker style
    r = 0,           -- Red color (0-255)
    g = 32,          -- Green color (0-255)
    b = 128,         -- Blue color (0-255)
    alpha = 50       -- Transparency (0-255)
}

Change the color by adjusting the r, g, b values:

• Red marker: r = 255, g = 0, b = 0

• Green marker: r = 0, g = 255, b = 0

• Yellow marker: r = 255, g = 255, b = 0

• Purple marker: r = 128, g = 0, b = 255

Change transparency with alpha:

• 0 = Invisible

• 50 = Semi-transparent (recommended)

• 255 = Fully solid

2. Marker Style

Change the type value to use different marker shapes:

• 0 = Upside-down cone

• 1 = Vertical cylinder

• 2 = Flat circle (recommended)

• 27 = Full cylinder

3. Menu Header Colors

Find the header section to change the gradient colors at the top of the elevator menu:

header = {
    topColor = {r = 0, g = 32, b = 128},      -- Top gradient color
    bottomColor = {r = 0, g = 16, b = 64}     -- Bottom gradient color
}

4. Language / Localization

Each elevator file includes a locales section where you can add or edit languages:

locales = {
    ["en"] = {
        ["menu-title"] = "Mission Row PD",
        ["menu-description"] = "Mission Row Police Department",
        ["floor-description"] = "Teleport to %s",
        ["floor-label"] = "➤",
        ["elevator-help-notify"] = "~INPUT_CONTEXT~ Open Elevator"
    },
    ["de"] = {
        ["menu-title"] = "Mission Row PD",
        ["menu-description"] = "Mission Row Police Department",
        ["floor-description"] = "Auf %s teleportieren",
        ["floor-label"] = "➤",
        ["elevator-help-notify"] = "~INPUT_CONTEXT~ Aufzug öffnen"
    }
}

To add a new language:

1. Copy one of the existing language blocks (e.g., ["en"])

2. Change the language code (e.g., ["fr"] for French, ["es"] for Spanish)

3. Translate all the text values

Example - Adding Spanish:

["es"] = {
    ["menu-title"] = "Policía de Mission Row",
    ["menu-description"] = "Departamento de Policía",
    ["floor-description"] = "Ir a %s",
    ["floor-label"] = "➤",
    ["elevator-help-notify"] = "~INPUT_CONTEXT~ Abrir Ascensor"
}

💡 Tip: The %s in floor-description is a placeholder that will be replaced with the floor name. Don't remove it!

5. Floor Names

You can rename floors to match your server's terminology. Find the floors section:

floors = {
    [1] = {
        name = "Floor 04 - SWAT",  -- Change this text
        pos = vector4(436.9360, -995.6405, 39.5200, 97.9808)
    },
    [2] = {
        name = "Floor 03 - MRPD Staff",  -- Change this text
        pos = vector4(436.9116, -995.8160, 35.1322, 97.9808)
    }
}

---

🔄 Applying Your Changes

After making any changes to elevator files:

1. Save the file

2. Restart the resource in your server console:

   restart tstudio_zmapdata

3. Test in-game to see your changes

---

📋 Example: Complete Customization

Here's an example of customizing the Mission Row PD elevator with:

• Red markers

• Spanish language

• Custom floor names

return {
    resourceName = "tstudio_mrpd",
    
    locales = {
        ["en"] = {
            ["menu-title"] = "MRPD Headquarters",
            ["menu-description"] = "Select your destination",
            ["floor-description"] = "Teleport to %s",
            ["floor-label"] = "➤",
            ["elevator-help-notify"] = "~INPUT_CONTEXT~ Open Elevator"
        },
        ["es"] = {
            ["menu-title"] = "Cuartel General MRPD",
            ["menu-description"] = "Selecciona tu destino",
            ["floor-description"] = "Ir a %s",
            ["floor-label"] = "➤",
            ["elevator-help-notify"] = "~INPUT_CONTEXT~ Abrir Ascensor"
        }
    },
    
    marker = {
        type = 2,
        r = 255,    -- Red marker
        g = 0,
        b = 0,
        alpha = 50
    },
    
    header = {
        topColor = {r = 255, g = 0, b = 0},      -- Red gradient
        bottomColor = {r = 128, g = 0, b = 0}
    },
    
    elevators = {
        {
            floors = {
                [1] = {
                    name = "SWAT Operations",  -- Custom name
                    pos = vector4(436.9360, -995.6405, 39.5200, 97.9808)
                },
                [2] = {
                    name = "Staff Offices",  -- Custom name
                    pos = vector4(436.9116, -995.8160, 35.1322, 97.9808)
                }
            }
        }
    }
}

---

⚠️ Important Notes

What NOT to Change

• Do not modify the resourceName field - this links the elevator to the correct map

• Do not modify the file structure or remove required fields

What You CAN Change

✅ Marker colors and style ✅ Header gradient colors ✅ All text and language translations ✅ Floor names ✅ Transparency (alpha value)

---

❓ Common Questions

Q: Which language does the elevator use? A: It automatically uses your server's configured language. Make sure your framework or resource is set to the correct language code.

Q: Can I disable just one elevator instead of all of them? A: You can delete or rename the specific elevator file (e.g., rename mrpd.lua to mrpd.lua.disabled)

Q: The changes don't appear in-game A: Make sure you saved the file and restarted the tstudio_zmapdata resource

Q: Can I add more floors to an elevator? A: The floors are specifically designed for each TStudio map. We don't recommend adding additional floors as coordinates need to be precise.

Q: How do I know which language code to use? A: Common codes: en (English), de (German), fr (French), es (Spanish), nl (Dutch), pl (Polish), pt (Portuguese)

---

📞 Need Help?

If you need assistance with customization:

• Double-check your syntax (commas, brackets, quotes)

• Make sure you only changed the allowed values

• Verify the file saved correctly

• Restart the resource after changes

---

Made with ❤️ for TStudio Map Customers