ESX Illegal Warehouses [esx_illegalWarehouses]

Illegal warehouses that can be rented to gangs, illegal organizations or even certain jobs and that can be lockpicked by police forces as long as they have lockpicks.

[FEATURES]

Warehouses management from any menu via an export
- View the current state of the warehouses : Warehouse Name | Jobname rented to | Gang Name rented to
- Rent a warehouse
- Reset the warehouse ownership
Private warehouses: each warehouse can only be opened by the gang/org/job it has been rented to
LSPD OPEN UP !! : each warehouse can be raided by the LSPD as long as they have lockpicks. When raiding a warehouse, a notification will be sent alerting every player of the raid but you will have to guess which warehouse is being raided !
Easily add or remove warehouses : Just add or remove the Warehouses from Config.lua, add or remove the needed info in the database and you are done !
Easily add or remove gangs, orgs, jobs : Just add or remove the jobs in Config.lua

[REQUIREMENTS]

es_extended (v1 OR v2)
- es_extended v1 : https://github.com/esx-framework/es_extended/tree/v1-final
- es_extended v2 : https://github.com/esx-framework/es_extended
async : https://github.com/esx-framework/async
mysql-async : https://github.com/brouznouf/fivem-mysql-async

[INSTALLATION]

CD in your resources/[folderWhereYouWantTheScriptToBe]
Clone the repository

git clone https://github.com/BenoursonJ/ESX-Illegal-Warehouses esx_illegalWarehouses

- Warehouses and Inventories : Import illegalWarehouses_en.sql or illegalWarehouses_fr.sql according to your language in your database
Add into a menu where you want to access the management panel from (example used is Mafia Job, full menu example at the end of this file):

exports["esx_illegalWarehouses"]:OpenWarehousesMenu()

Add this in your server.cfg :

ensure esx_illegalWarehouses

[CONFIG.LUA EXPLAINED]

Config.DrawDistance | Maximum distance from which the markers can be seen
Config.Locale | Text language (currently supported: fr and en)
Config.PoliceCond | Percentage of failure (default: 75%)
Config.Policejob | Name of the job that is able to lockpick warehouses
Config.Zones | Array listing the warehouses, structure is as follow :
- StorageName (ex: Storage1) | Marker name, must be the same than as defined in the DB
  - Position | Marker position
  - Marker Size | Marker size
  - Marker Color | Marker colour
  - Display Name | Marker Display Name
  - Type | Marker Type (0 = hidden | 1 = displayed)
Config.Gangs | List of gangs, organizations or jobs that can use the illegal warehouses system
- Gangname (ex: ballas) | Gang name, must be the same as the one used to set a job (ex: /setjob 1 ballas 3)
  - Name | Display named that is used when a warehouse is rented. When opening the warehouses menu, you will see this variable and not the gangname

[TUTORIALS]

In need of info and troubleshooting tips ? Head to the Wiki => HERE

[MENU EXAMPLE]

function OpenCloakroomMenu()
  local elements = {
    {label = _U('citizen_wear'), value = 'citizen_wear'},
    {label = "Gestion Entrepôts", value = 'mafia_storagemanage'},
  }
  ESX.UI.Menu.CloseAll()
    ESX.UI.Menu.Open(
      'default', GetCurrentResourceName(), 'cloakroom',
      {
        title    = _U('cloakroom'),
        align    = 'top-left',
        elements = elements,
        },
        function(data, menu)
      menu.close()
      if data.current.value == 'mafia_storagemanage' and ((PlayerData.job ~= nil and PlayerData.job.name == 'mafia' and PlayerData.job.grade_name == 'boss') or (PlayerData.job2 ~= nil and PlayerData.job2.name == 'mafia' and PlayerData.job2.grade_name == 'boss')) then
        exports["esx_illegalWarehouses"]:OpenWarehousesMenu()
      else
        TriggerEvent('esx:showNotification', "Vous devez être Parrain pour ouvrir ce menu")
      end

      if data.current.value == 'citizen_wear' then
        ESX.TriggerServerCallback('esx_skin:getPlayerSkin', function(skin, jobSkin)
          local model = nil
          if skin.sex == 0 then
            model = GetHashKey("mp_m_freemode_01")
          else
            model = GetHashKey("mp_f_freemode_01")
          end
          RequestModel(model)
          while not HasModelLoaded(model) do
            RequestModel(model)
            Citizen.Wait(1)
          end
          SetPlayerModel(PlayerId(), model)
          SetModelAsNoLongerNeeded(model)
          TriggerEvent('skinchanger:loadSkin', skin)
          TriggerEvent('esx:restoreLoadout')
        end)
      end
   CurrentAction     = 'menu_cloakroom'
      CurrentActionMsg  = _U('open_cloackroom')
      CurrentActionData = {}
    end,
    function(data, menu)
      menu.close()
      CurrentAction     = 'menu_cloakroom'
      CurrentActionMsg  = _U('open_cloackroom')
      CurrentActionData = {}
    end)
end

Legal

License

esx_illegalWarehouses - Fivem script for es_extended. Enables the creation of warehouses that can be assigned to gangs/illegal organisations.

This program Is free software: you can redistribute it And/Or modify it under the terms Of the GNU General Public License As published by the Free Software Foundation, either version 3 Of the License, Or (at your option) any later version.

This program Is distributed In the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty Of MERCHANTABILITY Or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License For more details.

You should have received a copy Of the GNU General Public License along with this program. If Not, see http://www.gnu.org/licenses/.

BenoursonJ / ESX-Illegal-Warehouses