What Are Presets?
Presets are pre-configured house interiors that you can easily add to your server. The House Robbery V2 resource includes apresets folder where you can simply drag and drop preset files shared by the community in our Discord’s Snippets channel.
Join our Discord at discord.gg/projectxdev and check the Snippets channel for community-shared presets!
How to Use Presets
- Download a preset file from the Discord Snippets channel
- Place the preset file in the
presetsfolder of your House Robbery V2 resource - Restart the resource or your server
- The preset will automatically load and be available for use
When creating custom presets, use the
/getoffset command to get accurate coordinates for all items, spots, and props inside shells. See the Commands page for details.Preset Structure
Here’s a complete example of a preset with all possible options:Function Parameters
string
The type of interior system used. Values:
"Shells", "IPL"string
required
Unique identifier for the house. Must match the house name configured in your housing script
table
required
Configuration table containing all house preset data
Configuration Options
ExitCoords
vector4
required
Coordinates where the player will exit the house interior. Includes position (x, y, z) and heading (w)
Spots
Searchable spots in the house that can be looted for random items.string
required
Type of spot being searched. Examples:
"drawer", "cabinet", "kitchen", "closet", "bathroom"vector3
required
Position of the searchable spot
string
required
Font Awesome icon for the interaction. Example:
'fas fa-search'string
required
Text displayed for the interaction
table
required
Animation played when searching the spot. Can use
Dict and Anim properties OR Scenario property (use one or the other)Props
Stealable props that spawn in the house and can be looted for specific items.string
required
Item name that will be given when looting this prop
number
required
Experience points awarded for looting this prop
string
required
Prop model name to spawn
vector3
required
Position where the prop will spawn
vector3
required
Rotation of the prop (pitch, roll, yaw)
string
required
Font Awesome icon for the interaction
string
required
Text displayed for the interaction
table
required
Animation played when stealing the prop. Can use
Dict and Anim properties OR Scenario propertyCash
Props that contain cash or marked bills.boolean
required
If
true, gives actual cash. If false, gives the cash item specified in CashItemstring
Item name to give when
Cash is false. Example: "markedbills"table
required
Cash amount range with
min and max valuesany
Metadata to attach to the cash item. Set to
false for no metadatanumber
required
Experience points awarded for looting
string
required
Prop model name (wallet, purse, etc.)
vector3
required
Position of the cash prop
vector3
required
Rotation of the prop
string
required
Font Awesome icon for the interaction
string
required
Text displayed for the interaction
table
required
Animation played when stealing cash. Can use
Dict and Anim properties OR Scenario propertySafe
Safes that require cracking and contain valuable loot.number
required
Experience points awarded for cracking the safe
vector3
required
Position of the safe
vector3
required
Rotation of the safe prop
string
required
Font Awesome icon for the interaction
string
required
Text displayed for the interaction
Painting
Paintings that can be stolen from walls.string
required
Item name given when stealing the painting
number
required
Experience points awarded
vector3
required
Position of the painting on the wall
vector3
required
Rotation of the painting
vector3
required
Rotation the player faces when stealing
vector3
required
Position where the player stands when stealing
string
required
Painting prop model name
string
required
Font Awesome icon for the interaction
string
required
Text displayed for the interaction
Display
Glass display cases containing valuable items.string
required
Item name given when breaking the display
number
required
Experience points awarded
vector3
required
Position of the glass display case
number
required
Heading rotation of the display case
string
required
Item prop model shown inside the display
vector3
required
Position of the item inside the display
number
required
Heading rotation of the item prop
boolean
If
true, the stand inside the display will not spawnstring
required
Font Awesome icon for the interaction
string
required
Text displayed for the interaction
HighValueItems
High value items that can be stolen from the house.string
required
Item name given when stealing
number
required
Experience points awarded
string
required
Prop model name
vector3
required
Position of the item
vector3
required
Rotation of the prop
string
required
Font Awesome icon for the interaction
string
required
Text displayed for the interaction
table
required
Animation played when stealing. Can use
Dict and Anim properties OR Scenario propertyTenants
NPCs that live in the house and can detect the player.vector4
required
Spawn position and heading of the tenant
string
required
Ped model name for the tenant
table
required
Animation the tenant performs. Can use
Dict and Anim properties OR Scenario propertyboolean
Enable or disable detection for this tenant
table
Polyzone coordinates defining the detection area (only if
Enable is true)number
Height of the detection zone (only if
Enable is true)Pets
Animals in the house that can alert tenants.vector4
required
Spawn position and heading of the pet
string
required
Animal model name
table
required
Animation the pet performs. Can use
Dict and Anim properties OR Scenario propertyLaser
Laser security system that must be disabled.string
required
Prop model for the laser control panel
vector4
required
Position and heading of the control panel (as offset)
string
required
Text displayed for the interaction
string
required
Font Awesome icon for the interaction
string or boolean
required
Item required to disable lasers. Set to
false for no requirementvector3
required
Start position of the laser beam
vector3
required
End position of the laser beam
number
required
Detection range around the laser beam
Alarms
Alarm system that can be disabled.string
required
Prop model for the alarm box
vector4
required
Position and heading of the alarm box (as offset)
string
required
Text displayed for the interaction
string
required
Font Awesome icon for the interaction
string or boolean
required
Item required to disable alarm. Set to
false for no requirementContracts
Special contracts that can spawn in the house.number
required
Percentage chance (0-100) that a contract will spawn
string
required
Contract name from the contracts.lua file
string
required
Contract type:
"Break Objects", "Littering", or "Steal Objects"vector3
required
Position where the contract object spawns
vector3
required
Rotation of the contract object
vector3
Position where littered items spawn (for
"Littering" type)vector3
Rotation of littered items (for
"Littering" type)Creating Your Own Preset
When creating your own preset:- Start with the basic structure using
LoadHousePreset() - Add the
ExitCoords(required) - Use
/getoffsetcommand while inside the shell to get accurate coordinates for each item - Add any of the optional sections you want (Spots, Props, Cash, etc.)
- For tenant detection zones, enable
Config.PolyTooland use/polycreatecommand - Test in-game to ensure all coordinates and rotations are correct
- Share your preset in the Discord Snippets channel for others to use!
Pro Tip: Use
/getoffset for every single position in your preset. This ensures items spawn exactly where you want them inside the shell interior.Using Development Commands
/getoffset: Stand at the desired location inside the shell and run this command to get the offset coordinates/polycreate: Create detection zones around tenants by defining the area boundaries
