Press Enter to search

How to Add a Custom Shell to esx_property (ESX)

Shell guide

How to Add a Custom Shell to esx_property (ESX)

To add a custom shell to esx_property on ESX Legacy, start the shell resource before the housing script, paste the generated entry inside Config.Interiors.Shells of esx_property/config.lua, set Config.Shells = true, and restart. The entry comes from a shell exported by the FiveMRides Shell Studio.

By FiveMRides. Updated . Shells from the Shell Studio were tested in game on FiveM with GTA V Legacy, with ps-housing (QBCore) and esx_property (ESX Legacy). GTA V Enhanced is not supported.

Quick answer
  • Resource: unzip the shell into resources and add ensure my_shell to server.cfg before esx_property.
  • Config: paste configs/esx_property_shell.lua inside Config.Interiors.Shells = { ... } of esx_property/config.lua, and set Config.Shells = true.
  • Storage: the Storage point needs ox_inventory, as esx_property itself does.
  • Tested in game: ESX Legacy 1.16.4 with esx_property on FiveM Legacy: arrival on the floor, interior doors, Wardrobe and Storage prompts at our spots, exit back at the door.

How do I add a custom shell to esx_property?

  1. Unzip the shell. Unzip the ZIP from the Shell Studio so you have one folder with an fxmanifest.lua, a stream folder and a configs folder.
  2. Copy it to resources. Copy the folder into your server resources folder and keep its name.
  3. Start it first. Add ensure followed by the folder name to server.cfg, on a line before esx_property.
  4. Turn shells on. In esx_property/config.lua set Config.Shells = true.
  5. Paste the entry. Copy the entry from configs/esx_property_shell.lua and paste it inside Config.Interiors.Shells.
  6. Restart and test. Restart the server, create a property with the new interior, enter it and check the Wardrobe and Storage prompts.

What does the generated entry look like?

The numbers are an example, yours are calculated from the entrance, the exit, the wardrobe and the stash points you set in the editor:

{
    label = "Modern flat",
    value = "my_shell",
    positions = {
        Wardrobe = vector3(2.1, -1.4, -1.2),
        Storage = vector3(-1.8, 0.6, -1.0),
    },
    type = "shell",
    pos = vector3(0.0, 4.5, 0.0)
},
  • esx_property has one anchor point per property. The player arrives at the anchor and the leave menu is drawn within a few metres of it. The shell is created so that the floor under the anchor lands exactly where the script expects it, and pos carries the difference.
  • The anchor is the exit spot of your project when it has one, otherwise the entrance spot. Set an exit in the Markers tab so the door of the shell is the leave point.
  • Wardrobe and Storage are positions relative to that anchor. The script draws them on the floor.
Properties keep their copy esx_property copies the positions into each property when the property is created. If you change the config later, existing properties keep the old numbers. Create a new property to see the change.

How do I test it?

Before you create any property, type /shelltest my_shell with the resource started. The shell appears under you and you stand at the entrance. Type it again to leave. /shellclock 23 sets your own clock to night to check the lights.

Frequently asked questions

Why must the shell start before esx_property?

The housing script asks for the shell model when a player enters a property. If the shell resource is not running yet, the model cannot load. Put the shell ensure line above the housing script and restart.

The Storage prompt does not open anything.

The Storage of esx_property works with ox_inventory only. Check that ox_inventory is installed and started, then test with a new property.

Do I need a heading for the arrival?

No. esx_property sets no arrival heading, so the player faces the way the game decides. Place your entrance so that both directions look fine.

I changed the offsets but my property did not move.

The positions are copied into each property when it is created. Create a new property after you change the config.

What if the esx_property resource changes later?

The entry was checked and tested against the esx_property of ESX Legacy as of November 2026. The ESX team may rewrite the resource later, so check the header of the generated file, which names the version it was checked against.

Does it work on GTA V Enhanced?

Not yet. The shells are built for FiveM on GTA V Legacy.

Open the Shell Studio

GET 35% OFF YOUR FIRST RIDE

Join the FiveMRides list for new drops, free tools and subscriber-only deals. Your 35% code arrives right after you sign up.

We do not spam! Read our privacy policy for more info.

FiveMRides is an independent store. We are not affiliated with, endorsed by or sponsored by Take-Two Interactive, Rockstar Games or Cfx.re. Grand Theft Auto, GTA and FiveM are trademarks of their respective owners, and vehicle brand names are used only to describe the models.

Scroll to Top