🐚 Add More Shells

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.

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

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

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

How to add new shells?

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:

json
{
    "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": []
        }
    }
}

🐚 Add More Shells

How to add new shells?

Create a new shell pack

Enter resource name

Enter creator / category name

Add each shell

Finish and save

Edit an existing shell

Batch edit shells

Shell pack JSON format