> For the complete documentation index, see [llms.txt](https://modmen.gitbook.io/mdm-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://modmen.gitbook.io/mdm-documentation/mdm_garages/installation.md). # Installation #### 📦 `mdm_garages` Script Installation * 📥 Downloading: After purchasing, download the script directly from [portal.cfx.re](https://portal.cfx.re). * 🗂️ Extracting: Unzip the downloaded `.zip` archive. * 📂 Moving Files: Copy the extracted script folder and place it in the `resources` directory on your server. * ⚙️ Main Configuration: Open the config file and adjust it to your needs. ``` Config = {} Config.TransferPrice = 500 Config.ImpoundMoney = 1000 Config.FullRepairOnImpoundRetrieve = true Config.ImpoundRetrieveFuelLevel = nil Config.ImpoundDestroyedRepair = { maxEngineHealthForTotalLoss = 80, maxEngineHealthForWreckPair = 120, maxBodyHealthForWreckPair = 120, } Config.GarageParkDamage = { minEngineHealth = 150.0, minBodyHealth = 150.0, minPetrolTankHealth = 150.0 } Config.StandardGarageFromImpound = 'Legion Square' Config.StandardGarageFromBoatImpound = 'Port LS' Config.StandardGarageFromPlaneImpound = 'Lotnisko LS' Config.StandardGarageFromHeliImpound = 'Lądowisko LS' Config.Garages = { ------GARAGE------ { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'standard', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Legion Square', -- have to be unique vehFade = true, ped = { pedCoords = vec4(214.7878, -806.8287, 30.7976, 333.3197), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingZone = { thickness = 10.0, points = { vec3(240.4534, -821.4702, 32.1385), vec3(198.5820, -806.3627, 33.0906), vec3(229.5427, -724.8796, 32.8130), vec3(275.5550, -740.3254, 32.6923), }, debug = false }, parkingSpots = { vec4(220.7160, -806.5695, 30.6882, 256.8359), vec4(221.7587, -803.9960, 30.6824, 246.0718), vec4(222.8254, -801.5403, 30.6661, 254.6283), vec4(223.7718, -799.1251, 30.6613, 247.1982), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'standard', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Downtown', -- have to be unique vehFade = true, ped = { pedCoords = vec4(55.4002, -876.3535, 30.6598, 69.0547), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingZone = { thickness = 10.0, points = { vec3(70.5092, -848.6313, 30.8438), vec3(49.2027, -905.3050, 29.9748), vec3(11.7298, -893.0327, 30.0143), vec3(32.7924, -834.4604, 30.9872), }, debug = false }, parkingSpots = { vec4(53.9101, -845.9445, 30.8532, 157.3516), vec4(57.1429, -846.8212, 30.8482, 158.8945), vec4(60.2886, -848.0247, 30.8373, 161.0967), vec4(63.7829, -848.9854, 30.8310, 159.6180), vec4(60.2802, -867.1022, 30.5516, 339.8672), vec4(57.0385, -866.2855, 30.5558, 340.6664), vec4(53.7722, -864.9009, 30.5678, 335.2706), vec4(50.4313, -863.9020, 30.5744, 338.7265), vec4(47.1374, -862.7849, 30.5821, 344.1269), vec4(44.1619, -871.4844, 30.4511, 340.4653), vec4(47.0224, -872.9221, 30.4349, 339.5426), vec4(50.3145, -874.2440, 30.4225, 340.7217), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'standard', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Plaża Del Perro', -- have to be unique vehFade = true, ped = { pedCoords = vec4(-1579.4545, -916.4983, 9.4141, 45.8919), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingZone = { thickness = 10.0, points = { vec3(-1573.0642, -898.3938, 9.9554), vec3(-1663.3572, -825.7949, 9.8067), vec3(-1727.6499, -902.4616, 7.6764), vec3(-1631.9076, -969.5347, 7.7537), }, debug = false }, parkingSpots = { vec4(-1585.7578, -908.2817, 9.4201, 317.3390), vec4(-1588.1302, -906.4604, 9.4126, 316.8747), vec4(-1590.2723, -904.5187, 9.4138, 317.4387), vec4(-1592.8176, -902.5420, 9.4013, 318.5570), vec4(-1595.4379, -900.6846, 9.3790, 318.2809), vec4(-1591.4634, -896.2623, 9.5442, 317.7019), vec4(-1589.0851, -898.0941, 9.5964, 316.6983), vec4(-1586.6328, -900.2523, 9.6022, 316.2188), vec4(-1584.6248, -902.3526, 9.5949, 318.6377), vec4(-1582.2927, -904.4443, 9.5948, 317.5029), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'standard', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Vinewood', -- have to be unique vehFade = true, ped = { pedCoords = vec4(598.0298, 90.0326, 92.8320, 267.2950), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingZone = { thickness = 10.0, points = { vec3(592.9523, 83.8667, 92.9865), vec3(616.0499, 75.5866, 91.1946), vec3(636.6053, 128.7801, 92.8951), vec3(607.9037, 139.4220, 92.8719), }, debug = false }, parkingSpots = { vec4(616.2256, 122.2247, 92.8736, 69.1136), vec4(614.9348, 118.3572, 92.8690, 68.0992), vec4(613.3643, 114.5448, 92.8806, 72.5167), vec4(612.2701, 110.8818, 92.8706, 69.2717), vec4(610.7169, 107.0704, 92.8479, 70.4054), vec4(609.5197, 103.6536, 92.7998, 71.1034), vec4(615.9015, 101.1461, 92.6357, 248.4442), vec4(617.3669, 104.6737, 92.6349, 250.7614), vec4(618.9111, 108.3130, 92.6701, 249.7151), vec4(619.8359, 112.0205, 92.6838, 248.7835), vec4(621.1753, 115.9388, 92.6679, 250.1192), vec4(622.6636, 119.7261, 92.6702, 254.7461), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'standard', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Mirror Park', -- have to be unique vehFade = true, ped = { pedCoords = vec4(1035.1473, -765.2365, 57.9950, 167.3370), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingZone = { thickness = 10.0, points = { vec3(1050.8995, -768.5453, 57.9680), vec3(1049.5922, -794.4015, 58.2246), vec3(1031.5079, -794.4223, 58.0121), vec3(1007.5560, -765.1736, 58.0093), vec3(1022.3504, -751.9138, 58.0329), }, debug = false }, parkingSpots = { vec4(1029.3429, -788.7775, 57.8451, 308.5790), vec4(1026.7397, -786.0767, 57.8401, 310.2340), vec4(1024.7192, -782.9108, 57.8484, 309.3103), vec4(1022.3571, -780.0425, 57.8490, 309.0000), vec4(1019.9068, -777.1120, 57.8483, 311.2107), vec4(1017.5230, -774.0894, 57.8624, 310.4830), vec4(1015.2460, -771.4031, 57.8746, 308.8791), vec4(1013.8328, -762.0575, 57.8902, 218.6961), vec4(1016.5474, -759.6137, 57.9719, 221.1177), vec4(1019.2379, -757.2947, 57.9921, 222.5340), vec4(1022.3890, -754.9599, 57.9699, 226.5731), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'standard', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Maze Bank Arena', -- have to be unique vehFade = true, ped = { pedCoords = vec4(-186.3081, -1996.1377, 27.7510, 29.7516), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingZone = { thickness = 10.0, points = { vec3(-195.8906, -1984.7694, 27.6204), vec3(-180.9571, -1984.5615, 27.6204), vec3(-190.5455, -1943.9332, 27.6204), vec3(-203.4874, -1948.5236, 27.6204), }, debug = false }, parkingSpots = { vec4(-186.3188, -1982.4291, 27.6204, 272.8488), vec4(-187.0209, -1978.5071, 27.6204, 273.2590), vec4(-187.3710, -1974.6106, 27.6204, 290.4997), vec4(-187.5988, -1970.4083, 27.6204, 278.4158), vec4(-188.7403, -1966.3617, 27.6204, 286.9148), vec4(-194.1291, -1967.4591, 27.6204, 103.4918), vec4(-193.4283, -1971.2698, 27.6204, 106.6877), vec4(-192.2512, -1974.9131, 27.6204, 101.1034), vec4(-192.8668, -1978.9412, 27.6204, 93.8706), vec4(-191.9081, -1982.7255, 27.6204, 98.1840), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'standard', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Parking Sandy', -- have to be unique vehFade = true, ped = { pedCoords = vec4(1526.5598, 3774.0422, 34.5113, 181.1530), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingZone = { thickness = 10.0, points = { vec3(1523.6562, 3771.0266, 34.0603), vec3(1529.4314, 3753.1821, 34.3816), vec3(1501.6140, 3737.7888, 34.3786), vec3(1489.6504, 3757.9917, 33.8594), }, debug = false }, parkingSpots = { vec4(1523.2711, 3767.5271, 34.0497, 223.2946), vec4(1516.7424, 3763.7480, 34.0292, 194.6954), vec4(1511.3174, 3761.9907, 34.0079, 201.7464), vec4(1497.3622, 3760.6531, 33.9235, 212.4734), vec4(1494.7360, 3758.9468, 33.9003, 210.4021), vec4(1492.2393, 3757.0493, 33.9608, 211.8176), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'standard', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Parking Paleto', -- have to be unique vehFade = true, ped = { pedCoords = vec4(-21.5743, 6313.4434, 31.3751, 330.4017), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingZone = { thickness = 10.0, points = { vec3(-11.7127, 6304.9399, 31.2258), vec3(-23.9406, 6322.2832, 31.2258), vec3(-0.5488, 6346.4546, 31.3759), vec3(12.9473, 6320.2285, 31.2281), }, debug = false }, parkingSpots = { vec4(-19.9920, 6322.7529, 31.2292, 207.9000), vec4(-17.4391, 6325.2388, 31.2300, 215.8975), vec4(-14.4039, 6328.0977, 31.2297, 206.3959), vec4(-11.9266, 6330.8716, 31.2294, 215.4022), vec4(-8.9965, 6333.4688, 31.2295, 212.2468), vec4(-6.2218, 6336.4263, 31.2293, 211.3910), vec4(-3.3432, 6338.9717, 31.2295, 211.5045), vec4(-0.4460, 6341.9907, 31.2290, 208.6183), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'boat', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Port LS', -- have to be unique vehFade = true, ped = { pedCoords = vec4(-783.3405, -1506.6696, 1.5952, 290.7660), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingZone = { thickness = 4.0, points = { vec3(-779.2917, -1503.9077, 1.5952), vec3(-802.1589, -1512.0692, 1.5952), vec3(-807.1750, -1498.6404, 1.5952), vec3(-784.8440, -1490.5206, 1.5952), }, debug = false }, parkingSpots = { vec4(-796.4943, -1502.7395, 1.2002, 109.5188), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'plane', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Lotnisko LS', -- have to be unique vehFade = true, ped = { pedCoords = vec4(-942.8176, -2964.5542, 13.9451, 119.1012), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingZone = { thickness = 10.0, points = { vec3(-924.9955, -2978.6091, 13.9451), vec3(-965.4611, -3050.1985, 13.9451), vec3(-1029.0798, -3013.7405, 13.9394), vec3(-984.1164, -2937.1677, 13.9446), }, debug = false }, parkingSpots = { vec4(-979.3782, -2996.0688, 13.9451, 58.8436), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'heli', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Lądowisko LS', -- have to be unique vehFade = true, ped = { pedCoords = vec4(-1164.8788, -2860.1372, 13.9459, 148.7152), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingZone = { thickness = 10.0, points = { vec3(-1185.4320, -2830.2539, 13.9474), vec3(-1195.5552, -2847.5298, 13.9475), vec3(-1109.2139, -2897.4319, 13.9406), vec3(-1097.5228, -2878.0037, 13.9471), }, debug = false }, parkingSpots = { vec4(-1178.2249, -2845.7817, 13.9458, 151.2019), vec4(-1145.8507, -2864.5569, 13.9433, 150.3437), vec4(-1112.3450, -2883.5388, 13.9460, 151.9777), } }, ------STANDARD------ ------IMPOUND------ { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'impound', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Odholownik LS', -- have to be unique vehFade = true, ped = { pedCoords = vec4(483.4305, -1311.3533, 29.2120, 247.4239), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingSpots = { vec4(489.7032, -1313.1001, 29.2581, 282.0030), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'boatimpound', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Odholownik portowy LS', -- have to be unique vehFade = true, ped = { pedCoords = vec4(-789.5735, -1490.8326, 1.5952, 289.7321), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingSpots = { vec4(-796.4943, -1502.7395, 1.2002, 109.5188), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'planeimpound', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Odholownik lotniskowy LS', -- have to be unique vehFade = true, ped = { pedCoords = vec4(-950.3175, -3056.2354, 13.9451, 59.1011), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingSpots = { vec4(-979.3782, -2996.0688, 13.9451, 58.8436), } }, { job = nil, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = true, garageType = 'heliimpound', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Odholownik lądowiskowy LS', -- have to be unique vehFade = true, ped = { pedCoords = vec4(-1147.6479, -2825.2410, 13.9470, 151.8441), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingSpots = { vec4(-1178.2249, -2845.7817, 13.9458, 151.2019), vec4(-1145.8507, -2864.5569, 13.9433, 150.3437), vec4(-1112.3450, -2883.5388, 13.9460, 151.9777), } }, ------IMPOUND------ -------POLICE------ { job = { ['police'] = 0 }, -- np { ['police'] = 2, ['ambulance'] = 1 } blip = false, garageType = 'police', -- standard/impound/police/boat/boatimpound/plane/planeimpound/heli/heliimpound name = 'Zarekwirowane LS', -- have to be unique vehFade = true, ped = { pedCoords = vec4(458.4848, -1010.7183, 28.2530, 116.2291), distToPed = 30.0, pedFade = true, pedIsRendered = false, -- don't change that ped = nil, -- don't change that }, parkingSpots = { vec4(450.1048, -1017.7275, 28.5238, 89.4736), } } ------POLICE------ } Config.Peds = { 'a_m_y_golfer_01', 'a_m_y_ktown_02', 'a_m_y_vindouche_01', 'cs_jimmyboston' } Config.Blips = { enable = true, standard = { label = 'Garaż', sprite = 357, colour = 3, scale = 0.5 }, impound = { label = 'Odholownik', sprite = 357, colour = 47, scale = 0.5 }, police = { label = 'Odholownik policyjny', sprite = 68, colour = 38, scale = 0.5 }, boat = { label = 'Port', sprite = 356, colour = 3, scale = 0.5 }, boatimpound = { label = 'Odholownik portowy', sprite = 356, colour = 47, scale = 0.5 }, plane = { label = 'Lotnisko', sprite = 359, colour = 3, scale = 0.5 }, planeimpound = { label = 'Odholownik lotniskowy', sprite = 359, colour = 47, scale = 0.5 }, heli = { label = 'Lądowisko', sprite = 360, colour = 3, scale = 0.5 }, heliimpound = { label = 'Odholownik lądowiskowy', sprite = 360, colour = 47, scale = 0.5 }, } Config.Commands = { GiveCurrentVeh = { enable = true, command = 'givecurrentveh', desc = 'Nadanie osobie pojazdu w którym się siedzi' }, SaveCurrentVeh = { enable = true, command = 'savecurrentveh', desc = 'Zapisanie stanu pojazdu w którym aktualnie się siedzi' } } Config.Notifications = { Title = 'Garaż', NoSpaceError = 'Brak wolnego miejsca parkingowego', NotEnoughMoney = 'Brak wystarczających środków', VehTransferSuccess = 'Pojazd został przeniesiony', VehicleGotOut = 'Pojazd został wyciągnięty', NotOwner = 'Nie jesteś właścicielem tego pojazdu', VehParkedInGarage = 'Pojazd został zaparkowany na parkingu %s', VehExist = 'Pojazd znajduje się już na mieście', CannotParkDestroyedVehicle = 'Nie można schować zniszczonego pojazdu do garażu. Odbierz go na odholowniku.', VehicleParked = 'Pojazd został zaparkowany', NoPermissions = 'Nie posiadasz uprawnień', NoActivePerson = 'Brak osoby o podanym ID', NotInVeh = 'Nie siedzisz w żadnym pojeździe', VehGrantedToPerson = 'Pojazd został nadany osobie', PlateAlreadyInDb = 'Pojazd z tą tablicą rejestracyjną jest już w bazie — nadanie anulowane.', GiveVehMissingPlate = 'Brak tablicy rejestracyjnej w danych pojazdu — nadanie anulowane.', VehStateSaved = 'Stan pojazdu został zapisany', ThisVehIsNoOne = 'Nikt nie posiada tego pojazdu' } Config.Notification = function(title, msg, type) lib.notify({ title = title, description = msg, type = type }) end ``` * 🎯 Dependencies (Target & Lib): By default, the script requires `ox_target` and `ox_lib` to function. Ensure you have them installed on your server. * *Note:* If you are using different scripts for the target system, polyzones, or vehicle properties, you must open the `client.lua` and `server.lua` files and modify a few dedicated lines to integrate them with your specific setup. * 🗄️ Database: Check if your database (in the `owned_vehicles` table) contains all the columns required by the script: `owner`, `coowner`, `plate`, `vehicle`, `vehicle_type`, `garage`, and `stored`. * 📝 Server Configuration: Open your server config file (usually `server.cfg`) and add the following line: `ensure mdm_garages` * 🔄 Restart: Restart the script or your server. You can now fully enjoy your new garages! 🚗 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://modmen.gitbook.io/mdm-documentation/mdm_garages/installation.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.