🐚Add More Shells

This package does not include shells by default and you need to get them yourself.

Our system includes an integrated shell editor with a full UI, where you can create shell packs, set door offsets, add interaction points, gallery images, stash settings, and trash locations — all in-game. Follow this guide to learn how to add more shells.

Can I add new shell or ipl?

Of course, you can create new shell packs or edit existing JSON files in nolag_properties/custom/shells/ at your own risk to add or remove shells or ipl.

Can I restrict shell or ipl to job?

Yes, you can restrict both to a certian job or a certian job grade.

{
    "resourceName": "custom_shells",
    "creator": "Custom Shells",
    "interiors": {
        "Standard Motel": {
            "label": "Standard Motel",
            "model": "standardmotel_shell",
            "jobs": {
                "realestate": 1
            },
            ...
        }
    }
}

IPLsData = {
    ["FinanceOffice1"] = {
        label = "Arcadius Business Centre",
        inventory = {
            slots = 50,
            weight = 10000,
        },
        jobs = {
            ["realestate"] = 1,
        }
        ...
    },
    ...
}

How to add new shells?

Add more shells at your own risk or by contacting the creator of those shells.

Don't forget to add a list of images for the realtor!

Make sure the integrated offset finder is enabled in the config.lua -> EnableOffsetFinder. The resource provides several commands to create and manage shell packs entirely in-game.

Create a new shell pack

1

Enter resource name

Use the /createshellpack command to create a brand new shell pack. You will be prompted to:

Enter a resource name (used as the JSON filename, e.g. MyPack -> MyPack.json)

2

Enter creator / category name

Enter a creator / category name

3

Add each shell

For each shell you want to add:

• Enter the object / model name (e.g. k4_motel2_furn)

• Enter a label (display name)

• Set the entrance / door position using the placement tool (LMB to confirm, RMB to cancel)

• Use the shell editor to add interaction points, trash locations, gallery images, and stash settings

• Press ENTER to finish the current shell

4

Finish and save

Choose to add another shell or finish and save the pack.

The pack is saved as a JSON file to nolag_properties/custom/shells/.

Edit an existing shell

Use /testshell <shellName> to open the shell editor for a single shell that already exists in a pack. The editor lets you:

• Scroll to navigate between point types (interaction points, entrance, gallery, inventory, trash)

• LMB to place a point or select an action

• RMB to undo the last placed point

Changes are saved directly to the pack when you close the editor.

Batch edit shells

Use /batchshells [packName] to start a batch editor for all shells in a pack (or all shells if no pack name is given). Navigate between shells with ENTER (next) and Backspace (previous). Use /nextshell and /stopbatch for additional control.

You can also use the /shells command to open a context menu and select a pack to batch edit.

Shell pack JSON format

Shell packs are stored as JSON files in nolag_properties/custom/shells/. Here is an example of the format:

{
    "resourceName": "my_custom_shells",
    "creator": "Custom Shells",
    "interiors": {
        "Modern Hotel": {
            "label": "Modern Hotel",
            "model": "modernhotel_shell",
            "doorOffset": {
                "x": 4.983124,
                "y": 4.242126,
                "z": -0.817879,
                "h": 175.733047,
                "width": 2.0
            },
            "stash": {
                "maxweight": 80000000,
                "slots": 120
            },
            "imgs": [
                {
                    "url": "https://r2.fivemanage.com/R97q1rVBsp92SWyV2UCJi/angle_1.png"
                }
            ],
            "points": [],
            "trashLocations": []
        }
    }
}