📦Installation

🔧 1. Requirements

Before installing, ensure you have the following dependencies:

• TMC Core https://store.tmc.bj/category/frameworks

• OPTIONAL: VISE Minigames https://vise.tebex.io/package/minigame-bundle (You can integrate whatever minigames you wish, however this is setup by default to use VISE minigames).

---

📥 2. Download & Extract

1. Download the latest release from your keymaster.

2. Place the folder:

gunchi-humane

into your server’s resources directory.

---

🗄️ 3. Core Items

Add the following items to your core > shared.gta5.lua:

    ["humaneusb"] = {
        ["label"] = "Injection USB",
        ["weight"] = 5,
        ["type"] = "item",
        ["image"] = "placeholder.webp",
        ["unique"] = true,
        ["stackable"] = false,
        ["useable"] = false,
        ["shouldClose"] = false
    },
    ["humanehackcard"] = {
        ["label"] = "Intrusion Keycard",
        ["weight"] = 5,
        ["type"] = "item",
        ["image"] = "placeholder.webp",
        ["unique"] = true,
        ["stackable"] = false,
        ["useable"] = false,
        ["shouldClose"] = false
    },
    ["humanekeycard"] = {
        ["label"] = "Humane Labs Keycard",
        ["weight"] = 5,
        ["type"] = "item",
        ["image"] = "placeholder.webp",
        ["unique"] = true,
        ["stackable"] = false,
        ["useable"] = false,
        ["shouldClose"] = false
    },
    ["humanefuses"] = {
        ["label"] = "4 Electrical Fuses",
        ["weight"] = 5,
        ["type"] = "item",
        ["image"] = "placeholder.webp",
        ["unique"] = true,
        ["stackable"] = false,
        ["useable"] = false,
        ["shouldClose"] = false
    },
    ["nvg"] = {
        ["label"] = "NVG",
        ["weight"] = 250,
        ["type"] = "item",
        ["image"] = "placeholder.webp",
        ["unique"] = true,
        ["stackable"] = true,
        ["useable"] = true,
        ["shouldClose"] = true,
        ["description"] = "Better than eating carrots..",
        ["quality"] = 100
    },

---

🚪 4. Door Lock Config

Add the following auth group to your doorlocks resource Config.AuthGroups:

    ['humane_auth'] = {
        jobs = {
            "police"
        }
    },

Add the following door lock config to your doorlocks resource Config.Doors:

["humane"] = {
        groupLabel = "Humane Labs",
        authGroup = "humane_auth", -- or false if door state will remain static locked/unlocked
        doors = {
            ["humane_front"] = {
                doorLabel = "Front Doors",
                distance = 1.0,
                locked = true,
                lockpick = false,
                hidden = false,
                keyFob = true,
                doorObjects = {
                    [1] = {
                        model = -1081024910,
                        pos = vec4(3627.713135, 3746.716309, 27.690086, 324.999908)
                    },
                    [2] = {
                        model = -1081024910,
                        pos = vec4(3620.842773, 3751.527100, 27.690086, 324.999908)
                    },
                },
            },
            ["humane_labdoors"] = {
                doorLabel = "Lab Entrance Doors",
                distance = 1.0,
                locked = true,
                lockpick = false,
                hidden = false,
                doorObjects = {
                    [1] = {
                        model = 1282049587,
                        pos = vec4(3598.511475, 3688.976562, 28.971624, 324.999908)
                    },
                    [2] = {
                        model = -421709054,
                        pos = vec4(3596.380615, 3690.468506, 28.971624, 324.999908)
                    },
                },
            },
            ["humane_analysisroomdoors"] = {
                doorLabel = "Analysis Room Doors",
                distance = 1.0,
                locked = true,
                lockpick = false,
                hidden = false,
                doorObjects = {
                    [1] = {
                        model = 1282049587,
                        pos = vec4(3584.406250, 3680.945312, 27.769638, 324.999969)
                    },
                    [2] = {
                        model = -421709054,
                        pos = vec4(3582.274170, 3682.437988, 27.769638, 324.999969)
                    },
                },
            },
            ["humane_powerroomdoor"] = {
                doorLabel = "Power Room Door",
                distance = 1.0,
                locked = true,
                lockpick = false,
                hidden = false,
                doorObjects = {
                    [1] = {
                        model = -421709054,
                        pos = vec4(3570.112549, 3699.474854, 28.267475, 79.999962)
                    },
                },
            },
            ["humane_coldaccess1"] = {
                doorLabel = "Cold Access Doors",
                distance = 1.0,
                locked = true,
                lockpick = false,
                hidden = false,
                doorObjects = {
                    [1] = {
                        model = 161378502,
                        pos = vec4(3567.634766, 3684.288574, 27.121397, 349.999969)
                    },
                    [2] = {
                        model = -1572101598,
                        pos = vec4(3565.073975, 3684.739990, 27.121397, 349.999969)
                    },
                },
            },
            ["humane_coldaccess2"] = {
                doorLabel = "Cold Access Doors",
                distance = 1.0,
                locked = true,
                lockpick = false,
                hidden = false,
                doorObjects = {
                    [1] = {
                        model = -1572101598,
                        pos = vec4(3549.012695, 3658.794189, 27.118046, 349.999969)
                    },
                    [2] = {
                        model = 161378502,
                        pos = vec4(3551.577148, 3658.339844, 27.118046, 349.999969)
                    },
                },
            },
            ["humane_waterroomdoor"] = {
                doorLabel = "Water Room Door",
                distance = 1.0,
                locked = true,
                lockpick = false,
                hidden = false,
                doorObjects = {
                    [1] = {
                        model = 19193616,
                        pos = vec4(3526.020508, 3702.242676, 21.341961, 170.203094)
                    },
                },
            },
            ["humane_lab1"] = {
                doorLabel = "Laboratory 1 Doors",
                distance = 1.0,
                locked = true,
                lockpick = false,
                hidden = false,
                doorObjects = {
                    [1] = {
                        model = -1572101598,
                        pos = vec4(3532.973389, 3665.869873, 27.118267, 260.000000)
                    },
                    [2] = {
                        model = 161378502,
                        pos = vec4(3532.518555, 3663.305420, 27.118336, 260.000000)
                    },
                },
            },
            ["humane_lab2"] = {
                doorLabel = "Laboratory 2 Door",
                distance = 1.0,
                locked = true,
                lockpick = false,
                hidden = false,
                doorObjects = {
                    [1] = {
                        model = 161378502,
                        pos = vec4(3557.549561, 3669.192627, 27.120199, 260.000000)
                    },
                },
            },
            ["humane_lab3"] = {
                doorLabel = "Laboratory Storage Door",
                distance = 1.0,
                locked = true,
                lockpick = false,
                hidden = false,
                doorObjects = {
                    [1] = {
                        model = 161378502,
                        pos = vec4(3551.913330, 3666.956543, 27.118069, 260.000000)
                    },
                },
            },
        }
    },

---

⚙️ 4. Configuration

config.lua

All configuration options are documented inside the file.

---

▶️ 5. Add to Server / Resources Config

Ensure the resource is started by adding the following to your server.cfg or resources.cfg:

ensure gunchi-humane

---

🔐 6. Escrow & Customization

This script uses escrow protection, however the following files remain editable:

• config.lua

• minigames.lua

These files allow you to customize gameplay without breaking escrow protection.

---

🎮 7. Usage

Once installed:

• Follow the guidance provided in the included README.MD file to learn how the heist functions, it's not detailed here to protect against metagaming.

---

🆘 8. Support

If you need help:

• Join my Discord server for support and updates