# Integration {% hint style="warning" %} WARNING: ONLY MESS WITH THESE IF YOU KNOW WHAT YOU ARE DOING!!!! {% endhint %} ### Payphone {% hint style="info" %} There is many different types of phones out there so this event is open for you to incorporate whatever you could possibly need! {% endhint %} ```lua RegisterNetEvent("DHS-PrisonSim:client:UsePayphone", function() if Config.Phone == "lb-phone" then local phoneNumber = lib.inputDialog("Enter Phone Number", { { type = "input", label = "Phone Number", default = "1234567890" } }) if phoneNumber then TriggerServerEvent("DHS-PrisonSim:server:UsePayphoneLB", phoneNumber) end elseif Config.Phone == "custom" then -- Custom Phone Function Here end end) ``` *** ### Convoy Start,End, and InConvoy Functions {% hint style="info" %} Sometimes you may need to do something on Convoy Start, End or even the minute they are in the convoy, this could be useful for a seatbelt script or something else you might need to do! {% endhint %} ```lua function OnConvoyStart() -- Triggers When The Convoy Starts end function PrisonerInConvoyVehicle() -- Probabaly Some Seatbelt Function or Something end function OnConvoyEnd() -- Triggers When The Convoy Ends end ``` *** ### Gate Door Minigame {% hint style="info" %} By default we use ox\_lib for the Gate Door minigame however, in the DHS-PrisonSim/client/editablefunctions\_cl.lua you can edit this to match whatever minigame you want. {% endhint %} ```lua function GateDoorMinigame() local success = lib.skillCheck({'easy', 'easy', 'easy', 'easy'}, {'w', 'a', 's', 'd'}) if success then return true else return false end end ``` *** ### Workout Minigame {% hint style="info" %} By default we use ox\_lib for the workout minigame however, in the DHS-PrisonSim/client/editablefunctions\_cl.lua you can edit this to match whatever minigame you want. {% endhint %} ```lua function WorkoutMinigame(info) local success = lib.skillCheck({'medium'}, {'w', 'a', 's', 'd'}) if success then TriggerEvent("DHS-PrisonSim:client:WorkoutSuccess", info) else TriggerEvent("DHS-PrisonSim:client:WorkoutFailed") end end ``` *** ### Medical Script Functionality {% hint style="info" %} As their is many medical scripts we felt the best way to provide support for healing prisoners was to have a completely open function where you can do absolutely anything you need to make sure your medical script hooks perfectly into PrisonSim if you have any issues open a ticket and we will be glad to help you! {% endhint %} ```lua function CustomMedicalFunction() -- Custom Medical Function Here end RegisterNetEvent("DHS-PrisonSim:client:MedicalEvent", function() if Config.UseBuiltInMedicalSystem then TriggerEvent("DHS-PrisonSim:client:PrisonHealthCare") else TriggerEvent("DHS-PrisonSim:client:CustomMedicalFunction") end end) ``` *** ### Dispatch Function {% hint style="info" %} By default we use qbcore built in system however we have support for both: * ps-dispatch * cd-dispatch however if you know what you are doing you can implement your own as well. * DHS-PrisonSim/client/editablefunctions\_cl.lua {% endhint %} ```lua function CallPolice(message) if Config.DispatchSystem == "qbcore" then TriggerServerEvent('police:server:policeAlert', message) elseif Config.DispatchSystem == "ps-dispatch" then --exports['ps-dispatch']:SuspiciousActivity() elseif Config.DispatchSystem == "cd-dispatch" then -- local data = exports['cd_dispatch']:GetPlayerInfo() -- TriggerServerEvent('cd_dispatch:AddNotification', { -- job_table = {'police'}, -- coords = data.coords, -- title = '10-15 - Illegal Fishing Activity', -- message = 'A '..data.sex..' using illegal bait at '..data.street, -- flash = 0, -- unique_id = tostring(math.random(0000000,9999999)), -- blip = { -- sprite = 431, -- scale = 1.2, -- colour = 3, -- flashes = false, -- text = '911 - Illegal Fishing Activity', -- time = (5*60*1000), -- sound = 1, -- } -- }) else if Config.Debug then print("No Dispatch System Selected") end end end ``` *** ### Notify System {% hint style="info" %} By default we use the built in qbcore notify system however we also support ox\_lib notify but if you know what you are doing you can integrate this as well. * DHS-PrisonSim/client/editablefunctions\_cl.lua {% endhint %} ```lua function Notify(text, type, time) if Config.Notify == "qbcore" then local QBCore = exports['qb-core']:GetCoreObject() QBCore.Functions.Notify(text, type, time) elseif Config.Notify == "ox_lib" then lib.notify({ title = text, type = type, duration = time }) else print("No Notify System Selected") end end ``` *** ### Reset Clothing {% hint style="info" %} By Default we use Illenium appearance however you can change this to whatever you use * DHS-PrisonSim/client/editablefunctions\_cl.lua {% endhint %} ```lua function ResetClothing() if Config.Clothing == "illenium-appearance" then TriggerEvent("illenium-appearance:client:reloadSkin") elseif Config.Clothing == "custom" then --Custom Clothing System Here end end ``` *** ### Fuel System {% hint style="info" %} We support many different fuel systems and we make it quite easy to add your own {% endhint %} ````lua local fuelEvent = nil function RefuelVehicle(vehicle) if GetResourceState('ox_fuel') ~= 'started' then exports[fuelEvent]:SetFuel(vehicle, 100) return elseif GetResourceState('ox_fuel') == 'started' then Entity(vehicle).state.fuel = 100.0 return end print('ERROR: No Fuel Resource Detected') fuelEvent = nil end ```lua CreateThread(function() if GetResourceState('LegacyFuel') == 'started' then fuelEvent = 'LegacyFuel' return end if GetResourceState('cdn-fuel') == 'started' then fuelEvent = 'cdn-fuel' return end if GetResourceState('BigDaddy-Fuel') == 'started' then fuelEvent = 'BigDaddy-Fuel' return end if GetResourceState('ps-fuel') == 'started' then fuelEvent = 'ps-fuel' return end if GetResourceState('okokGasStation') == 'started' then fuelEvent = 'okokGasStation' return end if GetResourceState('qs-fuelstations') == 'started' then fuelEvent = 'qs-fuelstations' return end end) ```` *** ### Custom Vehicle Function {% hint style="info" %} If your needing to do something specific like paint or change the livery of the convoy vehicles do so here {% endhint %} ```lua function CustomVehicleFunction(vehicle, model) if model == "policet" then -- Custom Vehicle Function Here elseif model == "pbus" then -- Custom Vehicle Function Here elseif model == "police" then -- Custom Vehicle Function Here elseif model == "riot" then -- Custom Vehicle Function Here end end ``` *** ### Give Keys Function {% hint style="info" %} If your using a different vehicle key system put it here {% endhint %} ```lua function GiveKeys(plate) if Config.VehicleKeys == 'qb-vehiclekeys' then TriggerEvent("vehiclekeys:client:SetOwner", plate) else if Config.Debug then print("No Vehicle Key System Selected") end end end ``` *** ### Gate Door Minigame {% hint style="info" %} For those that use the gate door escape you can change the minigame for hacking the gate here {% endhint %} ```lua function GateDoorMinigame() local success = lib.skillCheck({'easy', 'easy', 'easy', 'easy'}, {'w', 'a', 's', 'd'}) if success then return true else return false end end ``` *** ### On Prisoner Sentenced Function {% hint style="info" %} When the prisoner is sentenced you can have something happen like notifying the whole server or whatever it is you want to do {% endhint %} ```lua function OnPrisonerSentenced(sentenceTime) print("Prisoner Sentenced For: " .. sentenceTime) -- Triggers When The Prisoner Is Sentenced end ``` *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://dragon-heart-studios.gitbook.io/dragonheartstudios/scripts/dhs-prisonsim/integration.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.