🗄️Lockers UI

🇫🇷 Locker UI est un script de gestion de casier pour vos métiers. Il est sécurisé via un mot de passe à 4 chiffres. Vous pouvez ajouter et supprimer des casiers, définir une limite de casiers créables et changer le nom des casiers. Compatible avec ESX & QBCore et avec l'inventaire OX & QS.

🇺🇸 Locker UI is a locker management script for your professions. It is secured with a 4-digit password. You can add and remove lockers, set a limit on the number of lockers that can be created, and change the locker names. Compatible with ESX & QBCore and with the inventories OX & QS.

---

Preview Vidéo

Buy

Skyprod | Bienvenue

---

Installation

🇫🇷 Téléchargez le script depuis votre keymaster, extrayez le fichier, placer le dans le dossier de votre choix et ajoutez-le à votre resources.cfg / server.cfg. Ensuite, ouvrez votre fichier sql.sql et insérez-le dans la base de données.

🇺🇸 Download the script from your keymaster, extract the file, place it in the folder of your choice and add it to your resources.cfg / server.cfg. Then, open your sql.sql file and insert it into the database.

CREATE TABLE `s_lockers` (
  `label` varchar(50) NOT NULL,
  `lists` longtext NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;


ALTER TABLE `s_lockers`
  ADD PRIMARY KEY (`label`);
COMMIT;

---

Configuration

🇫🇷 Vous allez utiliser plusieurs fichiers pour configurer au maximum le script. Les deux fichiers principaux sont ceux ci-dessous :

🇺🇸 You will use several files to configure the script to the maximum extent. The two main files are those below:

Config.lua

Config = {}

Config.LockerMenu = {

    ['Framework'] = 'QBCore', -- QBCore or ESX
    ['Inventory'] = 'QS', -- QS, OX (QS potentially automatically creates for the qb-inventory)

    ['Settings'] = { 
        MinCharacForNewName = 3, -- Minimum number of characters to change the locker name
        MinNumberForNewPassword = 4, -- Minimum number of digits to change the password

        DrawMarkerDistance = 10, -- The distance to display the marker
        InteractDistance = 2.5, -- The distance in order to be able to interact and open the locker menu

        KeyOpenMenu = 38, -- The key to open the menu : https://docs.fivem.net/docs/game-references/controls/#controls
    },

    ['Lockers'] = {
        ['lspd_locker'] = {
            TitleName = "Los Santos Police Department",
            Coords = vector3(316.38, -272.42, 53.92),
            MarkerOption = {Type = 6, dirX = 0.0, dirY = 0.0, dirZ = 0.0, rotX = -90.0, rotY = 0.0, rotZ = 0.0, scaleX = 0.7, scaleY = 0.7, scaleZ = 0.7, red = 255, green = 255, blue = 255, alpha = 100, bobUpAndDown = false, faceCamera = false, p19 = true, rotate = false, textureDict = false, textureName = false, drawOnEnts = false}, -- Yes, lots of settings ^^
            MarkerZPosition = (-0.97), -- If you want to increase the height of the marker. Remove the “-”

            ['Restriction'] = {
                JobName = "police", -- "job_name" or "none"
                GradeJob = {'all'}, -- {'all'} or {'1','2','3','4'}
                LockerManagement = 3, -- Grade for Add, Remove, Edit Lockers
                MaxLockers = 20, -- Maximum number of lockers
            },
        },
        ['lspd_locker2'] = {
            TitleName = "Emergency Medical Services",
            Coords = vector3(307.56, -271.09, 53.95),
            MarkerOption = {Type = 6, dirX = 0.0, dirY = 0.0, dirZ = 0.0, rotX = -90.0, rotY = 0.0, rotZ = 0.0, scaleX = 0.7, scaleY = 0.7, scaleZ = 0.7, red = 255, green = 255, blue = 255, alpha = 100, bobUpAndDown = false, faceCamera = false, p19 = true, rotate = false, textureDict = false, textureName = false, drawOnEnts = false}, -- Yes, lots of settings ^^
            MarkerZPosition = (-0.97), -- If you want to increase the height of the marker. Remove the “-”

            ['Restriction'] = {
                JobName = "ambulance", -- "job_name" or "none"
                GradeJob = {'1','2','3','4'}, -- {'all'} or {'1','2','3','4'}
                LockerManagement = 7, -- Grade for Add, Remove, Edit Lockers
                MaxLockers = 10, -- Maximum number of lockers
            },
        },

        ['test_video'] = {
            TitleName = "Tuto Vidéo",
            Coords = vector3(-1017.69, -1129.02, 2.12),
            MarkerOption = {Type = 6, dirX = 0.0, dirY = 0.0, dirZ = 0.0, rotX = -90.0, rotY = 0.0, rotZ = 0.0, scaleX = 0.7, scaleY = 0.7, scaleZ = 0.7, red = 255, green = 255, blue = 255, alpha = 100, bobUpAndDown = false, faceCamera = false, p19 = true, rotate = false, textureDict = false, textureName = false, drawOnEnts = false}, -- Yes, lots of settings ^^
            MarkerZPosition = (-0.97), -- If you want to increase the height of the marker. Remove the “-”

            ['Restriction'] = {
                JobName = "ambulance", -- "job_name" or "none"
                GradeJob = {'1','2','3','4'}, -- {'all'} or {'1','2','3','4'}
                LockerManagement = 3, -- Grade for Add, Remove, Edit Lockers
                MaxLockers = 25, -- Maximum number of lockers
            },
        },






    },

    ['ShowNotification'] = function(text, typenotif) -- Notification type, depending on your framework or external script (Server notifications are forwarded here)
        if Config.LockerMenu['Framework'] == 'QBCore' then 
            TriggerEvent('QBCore:Notify', text, typenotif)
        elseif Config.LockerMenu['Framework'] == 'ESX' then 
            TriggerEvent('esx:showNotification', text, typenotif)
        end
    end,

    ['Translate'] = { 
        -- Client Side

        Interact = "[E] Ouvrir",

        NeedMoreCharacters = "Le nom du casier doit comporter au minimum %s caractères.",
        NameChanged = "Changement du nom du casier effectué : de '%s' à '%s'.",


        NeedMoreNumber = "Le mot de passe doit contenir %s chiffres.",
        PasswordIsNotNumbers = "Le mot de passe ne contient pas que des chiffres.",
        NumberTooLow = "Le mot de passe doit comporter plus de %s chiffres.",

        NotBeNegative = "Le mot de passe ne doit pas être une valeur négative.",
        PasswordChanged = "Le mot de passe du casier a été changé : de '%s' à '%s'.",

        LockerDeleted = "Casier n°%s supprimé (Sous le nom %s).",

        NotHaveAccess = "Vous n'avez pas les accès nécessaires pour effectuer cette action.",

        IncorrectPassword = "Mot de passe incorrect.",

        -- Server Side : 
        NewLocker = "Nouveau casier",
        NewLockerCreated = "Nouveau casier créé.",
    },

    ['OpenInventory'] = function(inv_name) -- For any requests for inventory management additions, come to my Discord if you're having trouble : discord.gg/EyT4mt8Pwf
        if Config.LockerMenu['Inventory'] == 'QS' then 
            local inventory_settings = { maxweight = 20000, slots = 10 }
            TriggerServerEvent("inventory:server:OpenInventory", "stash", inv_name, inventory_settings)
            TriggerEvent("inventory:client:SetCurrentStash", inv_name)
        elseif Config.LockerMenu['Inventory'] == 'OX' then 
            local ox_inventory = exports.ox_inventory
            local inventory_settings = { maxweight = 20000, slots = 10 }

            if ox_inventory:openInventory('stash', inv_name) == false then
                TriggerServerEvent('Lockers:Inventory:Register', inv_name, inventory_settings)
                ox_inventory:openInventory('stash', inv_name)
            end
        end 
    end,
}

LockersUI_DrawText = function(x, y, z, text)
    local px,py,pz=table.unpack(GetGameplayCamCoords())
    local dist = GetDistanceBetweenCoords(px,py,pz, x,y,z, 1)
 
    local scale = (1/dist)*2
    local fov = (1/GetGameplayCamFov())*100
    local scale = scale*fov
        SetTextScale(0.0*scale, 0.40*scale)
        SetTextFont(4)
        SetTextProportional(1)
        SetTextColour(255, 255, 255, 215)
        SetTextDropshadow(0, 0, 0, 0, 255)
        SetTextEdge(1, 0, 0, 0, 150)
        SetTextDropShadow()
        SetTextOutline()
        SetTextEntry("STRING")
        SetTextCentre(1)
        AddTextComponentString(text)
        SetDrawOrigin(x,y,z, 0)
        DrawText(0.0, 0.0)
        ClearDrawOrigin()
end

Config.js

const Config = {
    EnableBlackBackground: true, 
    ColorBackground: "rgba(0, 0, 0, 0.7)", 
    
    BlurOpacity : "3px", // 0px = disabled | 3px = default

    ['NewNameSettings'] : {
        MinLenght : 3,
        MaxLength : 30,
    },
};

const Translate = {
    CreateLocker : "Ajouter un casier",

    ['NewLocker'] : {
        NewLocker : "Nouveau casier",
        Open : "Ouvrir",
        Edit : "Gestion",
        LockerLimitReached : "Vous avez atteint la limite de casier créable",
    },

    ['Open'] : {
        EnterPassword : "Saisiez le mot de passe",
        Placeholder : "...",
    },

    ['Edit'] : {
        ChangeNameLocker : "Changer le nom du casier",
        Placeholder_newname : "Casier de ......",

        ChangePasswordLocker : "Changer le mot de passe",
        Placeholder_newpassword : "1111-9999",

        ValidEmojie : "✔",

        ['Footer'] : {
            DeleteLocker : "Supprimer le casier",
            Valid : "Valider",
            Cancel : "Annuler",
        },
    },

    NotHaveAcces : "Vous n'avez pas les accès requis pour cette action",

    ['Footer'] : {
        Valid : "Valider",
        Cancel : "Annuler",
    },
};

🇫🇷 Après, vous avez le fichier server_config.lua afin de gérer les journaux, l'impression dans la console pour le casier supprimé inutile, et la gestion de l'inventaire du côté serveur.

🇺🇸 Afterward, you have the server_config.lua file to manage logs, printing in the console for unnecessary removed lockers, and server-side inventory management.

server_config.lua

MySQL.ready(function() -- Small addition to remove boxes not inserted in your config.lua
    local lockers_lists = MySQL.query.await('SELECT * FROM `s_lockers`')
    for _,lockers in pairs(lockers_lists) do
        if not Config.LockerMenu['Lockers'][lockers.label] then 
            MySQL.update('DELETE FROM `s_lockers` WHERE label = ?', {lockers.label}, function(result)
                print("[^1DEBUG^7] Casier sous le nom ^3"..lockers.label.."^7 supprimé de la base de données car il n'était pas mentionné dans votre fichier Config.lua.")
                -- print("[^1DEBUG^7] Locker under the name ^3"..lockers.label.."^7 deleted from the database because it was not mentioned in your Config.lua file.")
                Logs_TableDeletedDebug(lockers.label)
            end)
        end
    end
end)

RegisterNetEvent('Lockers:Inventory:Register', function(inv_name, inventory_settings)
    if source == 0 then return end 

    if Config.LockerMenu['Inventory'] == 'OX' then 
        local ox_inventory = exports.ox_inventory
        ox_inventory:RegisterStash(inv_name, inv_name, inventory_settings.slots, inventory_settings.maxweight)
    end
end)


local Logs_Webhook = {
    ['LockerDeleted'] ='https://discord.com/api/webhooks/',
    ['LockerAddNewLocker'] ='https://discord.com/api/webhooks/',
    ['TableDeletedDebug'] = 'https://discord.com/api/webhooks/',
}

Logs_LockerDeleted = function(source, name)
    if source == 0 then return end 

    local embeds = {{
        ["description"] = ("· **ID du joueur :** %s \n· **Pseudo du joueur :** %s \n· **Nom du casier supprimé :** %s"):format(tonumber(source), GetPlayerName(tonumber(source)), name),
        ["color"] = 15605278, -- https://www.colorhexa.com/30ff00
    }}
    PerformHttpRequest(Logs_Webhook['LockerDeleted'], function(err, text, headers) end, 'POST', json.encode({username=username,embeds=embeds}), { ['Content-Type'] = 'application/json' })
end

Logs_AddNewLocker = function(source, label, lists)
    if source == 0 then return end 

    local embeds = {{
        ["description"] = ("· **ID du joueur :** %s \n· **Pseudo du joueur :** %s \n· **Nom des casiers :** %s \n· **Total des casiers :** %s "):format(tonumber(source), GetPlayerName(tonumber(source)), label, #lists),
        ["color"] = 3211008, -- https://www.colorhexa.com/30ff00
    }}
    PerformHttpRequest(Logs_Webhook['LockerAddNewLocker'], function(err, text, headers) end, 'POST', json.encode({username=username,embeds=embeds}), { ['Content-Type'] = 'application/json' })
end

Logs_TableDeletedDebug = function(name)
    local embeds = {{
        ["description"] = ("· **Nom de la table supprimé :** %s"):format(name),
        ["footer"] = {
            ["text"] = "Supprimé de la base de données car il n'était pas mentionné dans votre fichier Config.lua.",
        },
        ["color"] = 13800222, -- https://www.colorhexa.com/30ff00
    }}
    PerformHttpRequest(Logs_Webhook['TableDeletedDebug'], function(err, text, headers) end, 'POST', json.encode({username=username,embeds=embeds}), { ['Content-Type'] = 'application/json' })
end

---

Différence : ESCROW & OPEN-SOURCE

ESCROW

🇫🇷 La version escrow reste assez simple, comme montré dans la vidéo. Elle est vraiment spécialement conçue pour la configuration du script. Les modifications plus poussées ne vous sont pas fournies, bien que je pense vous avoir donné accès à de nombreuses modifications. C'est pourquoi le prix reste relativement bas pour la qualité de ce dernier.

🇺🇸 The escrow version remains quite simple, as shown in the video. It is specifically designed for script configuration. More advanced modifications are not provided, although I believe I have given you access to many adjustments. Hence, the price remains relatively low considering its quality.

OPEN-SOURCE

🇫🇷 La version open-source conserve le même tri des fichiers que l'escrow. Le changement, vous demanderez ? Vous aurez accès à tous les fichiers, bien sûr. Toute revente du script sera suivie de façon judiciaire. Cependant, vous pourrez apprendre le fonctionnement de certaines choses assez complexes.

🇺🇸 The open-source version maintains the same file sorting as the escrow. What's the change, you ask? You'll have access to all the files, of course. Any resale of the script will be legally monitored. However, you'll be able to learn the workings of some rather complex things.