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
The type of interior system used. Values:
"Shells", "IPL"Unique identifier for the house. Must match the house name configured in your housing script
Configuration table containing all house preset data
Configuration Options
ExitCoords
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.Type of spot being searched. Examples:
"drawer", "cabinet", "kitchen", "closet", "bathroom"Position of the searchable spot
Font Awesome icon for the interaction. Example:
'fas fa-search'Text displayed for the interaction
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.Item name that will be given when looting this prop
Experience points awarded for looting this prop
Prop model name to spawn
Position where the prop will spawn
Rotation of the prop (pitch, roll, yaw)
Font Awesome icon for the interaction
Text displayed for the interaction
Animation played when stealing the prop. Can use
Dict and Anim properties OR Scenario propertyCash
Props that contain cash or marked bills.If
true, gives actual cash. If false, gives the cash item specified in CashItemItem name to give when
Cash is false. Example: "markedbills"Cash amount range with
min and max valuesMetadata to attach to the cash item. Set to
false for no metadataExperience points awarded for looting
Prop model name (wallet, purse, etc.)
Position of the cash prop
Rotation of the prop
Font Awesome icon for the interaction
Text displayed for the interaction
Animation played when stealing cash. Can use
Dict and Anim properties OR Scenario propertySafe
Safes that require cracking and contain valuable loot.Experience points awarded for cracking the safe
Position of the safe
Rotation of the safe prop
Font Awesome icon for the interaction
Text displayed for the interaction
Painting
Paintings that can be stolen from walls.Item name given when stealing the painting
Experience points awarded
Position of the painting on the wall
Rotation of the painting
Rotation the player faces when stealing
Position where the player stands when stealing
Painting prop model name
Font Awesome icon for the interaction
Text displayed for the interaction
Display
Glass display cases containing valuable items.Item name given when breaking the display
Experience points awarded
Position of the glass display case
Heading rotation of the display case
Item prop model shown inside the display
Position of the item inside the display
Heading rotation of the item prop
If
true, the stand inside the display will not spawnFont Awesome icon for the interaction
Text displayed for the interaction
HighValueItems
High value items that can be stolen from the house.Item name given when stealing
Experience points awarded
Prop model name
Position of the item
Rotation of the prop
Font Awesome icon for the interaction
Text displayed for the interaction
Animation played when stealing. Can use
Dict and Anim properties OR Scenario propertyTenants
NPCs that live in the house and can detect the player.Spawn position and heading of the tenant
Ped model name for the tenant
Animation the tenant performs. Can use
Dict and Anim properties OR Scenario propertyEnable or disable detection for this tenant
Polyzone coordinates defining the detection area (only if
Enable is true)Height of the detection zone (only if
Enable is true)Pets
Animals in the house that can alert tenants.Spawn position and heading of the pet
Animal model name
Animation the pet performs. Can use
Dict and Anim properties OR Scenario propertyLaser
Laser security system that must be disabled.Prop model for the laser control panel
Position and heading of the control panel (as offset)
Text displayed for the interaction
Font Awesome icon for the interaction
Item required to disable lasers. Set to
false for no requirementStart position of the laser beam
End position of the laser beam
Detection range around the laser beam
Alarms
Alarm system that can be disabled.Prop model for the alarm box
Position and heading of the alarm box (as offset)
Text displayed for the interaction
Font Awesome icon for the interaction
Item required to disable alarm. Set to
false for no requirementContracts
Special contracts that can spawn in the house.Percentage chance (0-100) that a contract will spawn
Contract name from the contracts.lua file
Contract type:
"Break Objects", "Littering", or "Steal Objects"Position where the contract object spawns
Rotation of the contract object
Position where littered items spawn (for
"Littering" type)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
