🧰Boot/Trunk Vehicle Inventory

The RPWorks Boot System is a fully interactive vehicle storage system designed to bring realism and immersion to equipment management within your FiveM server.

📦 Features

• 🚗 Multiple access points per vehicle (rear, sides, bonnet, custom)

• 📦 Realistic vehicle storage with weight limits

• 🧍 Player carry capacity system

• 🧱 Placeable props synced across all players

• 🔁 Return items through a dedicated UI

• 🔐 Vehicle safe system (ACE or keypad protected)

• 🛠️ Full in-game admin configuration tools

• 📍 Vehicle restock points

• 🔔 Clean UI with ox_lib notifications

• ⚡ Fully standalone & optimised

---

🧱 Installation

Follow instructions in Getting Started

Ensure that the dependancies are started BEFORE this resource in server.cfg

Permissions

To allow admins to configure vehicles:

add_ace group.admin rpw_boot.admin allow

Then assign users:

add_principal identifier.fivem:YOUR_ID group.admin

---

📦 Dependencies

• ox_target

---

⚙️ Configuration

All configuration is handled inside:

configs/config.lua
configs/items.lua
configs/vehicles.lua

---

General Config

Config.PlayerCarryCapacity = 5 -- Set to 0 for unlimited
Config.SafeAccessMethod = "keypad" -- "keypad" or "ace"

---

Items

Items are defined in:

configs/items.lua

Example:

CONE = {
    Label = "Traffic Cone",
    Type = "Prop",
    Category = "Traffic",
    Desc = "A traffic cone", -- A description to be shown for the item
    Weight = 1, -- How many slots it will take up
    Image = "cone.png", -- The image file name in html/img/
    Desc = "Used for traffic management" -- A description to be shown for the item
}

---

Command Items

Command items can execute commands when taken or returned:

TAPE = {
    Label = "Police Tape",
    Type = "Command",
    Category = "Tools", -- This can be anything you want
    Weight = 1, -- How many slots it will take up
    Image = "cone.png", -- The image file name in html/img/
    Desc = "Police tape", -- A description to be shown for the item
    TakeCommand = "tape", -- Command that gets run when taking the item out
    ReturnCommand = "removetape" -- Command that gets run when returning the item
}

---

Weapon Items

Weapon items give weapons to the players on retrieval:

G36 = {
    Label = "G36", -- How you want it to show
    Type = "Weapon", 
    Category = "Weapons", -- This can be anything you want
    Weight = 1, -- How many slots it will take up
    Image = "g36.png", -- The image file name in html/img/
    Desc = "A G36 assault rifle", -- A description to be shown for the item
    Weapon = "WEAPON_ASSAULTRIFLE", -- The weapon's spawncode
    Components = {"COMPONENT_AT_AR_FLSH", "COMPONENT_ASSAULTRIFLE_VARMOD_LUXE"},
    Safe = true -- Whether or not this should be locked in the safe
},

Get weapon names here: https://wiki.rage.mp/wiki/Weapons

Get weapon components here: https://wiki.rage.mp/wiki/Weapons_Components

---

Vehicles

Vehicles are automatically generated in:

configs/vehicles.lua

Example:

POLICE = {
    Boots = {
        rear = {
            Offset = vec3(0.5, 0.0, 0.5),
            Capacity = 50
        }
    },
    SafeCode = "1234",
    SafeAce = "rpw_boot.safe.police"
}

Do NOT change this file unless you know what you're doing - This is all edited in-game ideally.

---

🛠️ Admin Usage

Register Vehicle

1. Sit in a vehicle

2. Run:

/bootsetup

Altnerative, you can:

1. Use the third-eye option (ox_target)

2. Select the register new vehicle option

---

Configure Boots

Using the admin menu you can:

• Add new access points

• Edit positions using the visual editor

• Delete access points

• Set capacities

• Apply presets

• Add new items

• Save new presets

• Delete boots entirely

---

Safe Configuration

Admins can configure safe access directly in-game:

• If using keypad mode → set code

• If using ACE mode → set permission

Only one method is active at a time.

---

🧱 Using the System

Accessing a Boot

• Look at a configured vehicle

• Use ox_target

• Select the boot access point

---

Taking Items

• Select an item from the UI

• Choose quantity

• Item is added to your carried inventory

---

Placing Props

• Props enter placement mode automatically

• Move and place them in the world

• Press arrow keys to rotate, and enter to place

• Props are synced across all players

---

Returning Items

• Use Return Item(s) option

• (if a prop) Pick up the prop

• Choose what and how many to return

• Items go back into the vehicle

---

🔐 Vehicle Safe

• Access via Access Safe button

• Items marked Safe = true appear here only

Access Methods

Keypad

• Enter the correct code

ACE

• Player must have the required permission

---

📍 Restock Points

Define locations where vehicles can be restocked:

Config.RestockPoints = {
    {
        coords = vec3(452.0, -1018.0, 28.5),
        radius = 3.5,
        label = "Vehicle Restock"
    }
}

When inside the zone:

• Press the interaction key

• Vehicle contents reset to default

---

⚠️ Notes

• Boot contents are server-authoritative

• Props are synced across players and persist through reconnects

• Safe items are hidden from the main boot inventory

• Admin changes update instantly without restart

---

🧠 Tips

• Use realistic weights for better gameplay

• Set different capacities per vehicle type

• Use safes for restricted equipment

• Combine with other RPWorks systems for best experience

---

❓ Support

If you need help or encounter issues, please join the RPWorks Discord.