💡Usage

Script for PolyZone to trigger an event by pressing E.

new locked doorsMaybe you wondering how to use this script 😕 Don't worry we will help here. Here you learn how to use our script.

How to use BoxE

First of all, we create a new Box in Boxes.lua
The Box config should look like that. Of course, customize it by your preferences

 [1] = {
        ["enabled"] = true,
        ['coords'] = vector4(-57.0654, -1097.0039, 26.4224, 205.0292),
        ['sizeY'] = 3, -- Size of box
        ['sizeX'] = 2, --Size of box
        --['sizeZ'] = 2, -- don't have to be there. Default is 2
        ['message'] = 'to trigger Test', --Text what you want
        ['side'] = 'left', --Left/Right
        ['Trigger'] = 'Test', --Custom name what you set up in events.lua, if you don't need just leave it blank.
    },

If you want to add next box just change [1] to [2]

[2] = {
        ["enabled"] = true,
        ['coords'] = vector4(-60.0654, -1097.0039, 26.4224, 205.0292),
        ['sizeY'] = 3, -- Size of box
        ['sizeX'] = 2, --Size of box
        ['message'] = 'to trigger REEEE', --Text what you want
        ['side'] = 'left', --Left/Right
        ['Trigger'] = 'REEEEE', --Custom name what you set up in events.lua, if you don't need just leave it blank.
    },

So final config should look like that

boxes.lua

--[[        TEMPLATES         ]]--

--BASIC TEMPLATES
--You can combine most of things. If you find a bug contact us on Discord.
--[[ 
    [1] = {
        ["enabled"] = true,
        ['coords'] = vector4(-57.0654, -1097.0039, 26.4224, 205.0292),
        ['sizeY'] = 3, -- Size of box
        ['sizeX'] = 2, --Size of box
        --['sizeZ'] = 5, --SizeZ is optionable don't have to be there. Default is 2
        ['message'] = '[E] to trigger Test', --Text what you want
        ['side'] = 'left', --Left/Right
        ['Trigger'] = 'Test', --Custom name what you set up in events.lua, if you don't need just leave it blank.
    },
    [2] = {
        ["enabled"] = true,
        ['coords'] = vector4(-69.6077, -1088.9026, 26.5622, 40.0142),
        ['sizeY'] = 5, -- Size of box
        ['sizeX'] = 5, -- Size of box
        ['sizeZ'] = 5, -- Size of box
        ['message'] = 'to trigger Test2', --Text what you want
        ['side'] = 'left', --Left/Right
        ['Trigger'] = 'Test2', --Custom name what you set up in events.lua, if you don't need just leave it blank.
    }, 
]]

Shared.BoxEs = {
    [1] = {
        ["showbox"] = true,
        ['coords'] = vector4(-57.0654, -1097.0039, 26.4224, 205.0292),
        ['sizeY'] = 3, -- Size of box
        ['sizeX'] = 2, --Size of box
        --SizeZ don't have to be there. Default is 2
        ['message'] = 'to trigger Test', --Text what you want
        ['side'] = 'left', --Left/Right
        ['Trigger'] = 'Test', --Custom name what you set up in events.lua, if you don't need just leave it blank.
    },
    [2] = {
        ["showbox"] = true,
        ['coords'] = vector4(-60.0654, -1097.0039, 26.4224, 205.0292),
        ['sizeY'] = 3, -- Size of box
        ['sizeX'] = 2, --Size of box
        ['sizeX'] = 2, don't have to be there. Default is 2
        ['message'] = 'to trigger REEEE', --Text what you want
        ['side'] = 'left', --Left/Right
        ['Trigger'] = 'REEEEE', --Custom name what you set up in events.lua, if you don't need just leave it blank.
    },
}

Now we have to set up Triggers. So, We open the events.lua and we make a new condition
The Condition is up to you. It depends on what you want to trigger
For example, I want to send to player a message by box [1] and by box [2] I want to spawn a vehicle

events.lua

local QBCore = exports['qb-core']:GetCoreObject()

-----------------------------------------------------
-- In config set the trigger name and continue event == "NameOfTrigger"

function SummonBoxEvent(Trigger)
    local event = Trigger

    if event == 'Test' then
        QBCore.Functions.Notify('Now it works.', 'success', 7500)

    elseif event == 'REEEEE' then
        QBCore.Functions.Notify('Now it works 2 :Wink:.', 'success', 7500)
        QBCore.Functions.SpawnVehicle('adder')

    --[[ 
    elseif event == 'Example' then
        --Whatever you want 
    ]]
end

How to use BoxE for doors

First of all, we have to create new locked doors and set it all in qb-doorlock. Also, I recommend setting distance to 0
Now, we create a new Box in Doors.lua
The Box config should look like that. Of course, customize it by your preferences again

Doors.lua

--[[        TEMPLATES         ]]--

--BASIC TEMPLATES
--You can combine most of things. If you find a bug contact us on Discord.
--TEMPLATE FOR DOORS
--[[ 
    [1] = {
        ["enabled"] = true,
        ['coords'] = vector4(-60.6077, -1078.9026, 26.5622, 40.0142),
        ['sizeY'] = 5, -- Size of box
        ['sizeX'] = 5, -- Size of box
        --['sizeZ'] = 5, --SizeZ is optionable don't have to be there. Default is 2
        ['side'] = 'left', --Left/Right

        ['unlock'] = '[E] Unlock', --Text to unlock
        --['lock'] = '[E] Lock', --Text to lock is optionable
        ['isDoor'] = true, --It starts qb-doorlock mode
        ['OneTime'] = true, --This is for one use. It automatically locks door after 2s by default or by Timer what you set below
        ['Timer'] = 1000, --This lock your door automatically after 1000 = 1s +-
        ['DoorID'] = '', --Here should be name of doors
    },
    [2] = {
        ["enabled"] = true,
        ['coords'] = vector4(-38.4101, -1108.5775, 26.4688, 143.6674),
        ['sizeY'] = 3, -- Size of box
        ['sizeX'] = 2, -- Size of box
        ['unlock'] = 'Control of gate', --Text to unlock and lock
        ['side'] = 'left', --Left/Right
        ['isDoor'] = true, --It starts qb-doorlock mode
        ['DoorID'] = 'PDM-Entrance', --Here should be name of doors
    },
}
]]

Shared.Doors = {
    --Put here code
    [1] = {
        ["enabled"] = true,
        ['coords'] = vector4(-60.61, -1093.79, 26.63, 251.62),
        ['sizeY'] = 3, -- Size of box
        ['sizeX'] = 2, -- Size of box
        ['side'] = 'left', --Left/Right
        ['unlock'] = 'Unlock', --Text to unlock
        ['isDoor'] = true, --It starts qb-doorlock mode
        ['OneTime'] = false, --This is for one use. It automatically locks door after 2s by default or by Timer what you set below
        ['Timer'] = 1000, --This lock your door automatically after 1000 = 1s +-
        ['DoorID'] = 'PDM-PDM_1', --Here should be name of doors
    },
}

These configs are just examples. The most of settings should be combinable.
If you find any bugs or you still didn't get it how it works contact us in the Support room on Discord.

Last updated 2 years ago