> For the complete documentation index, see [llms.txt](https://rtx-dev.gitbook.io/rtxdev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rtx-dev.gitbook.io/rtxdev/rtx-shell-creator/guides/using-shells-with-housing.md).

# Using Shells With Housing

Use your shells with RTX Housing and any other housing system.

Shells built with RTX Shell Creator work with **RTX Housing and any other housing system**.

{% hint style="info" %}
**Watch it:** [In game with RTX Housing - 5:59](https://www.youtube.com/watch?v=EPpvW_mne4Y\&t=359s)
{% endhint %}

## RTX Housing

When you finish a shell, it is **added to RTX Housing automatically**:

* the shell creator writes `rtx_housing/configs/shells_rtx_shellcreator.lua`
* all your shells are in it, with their housing points
* your own `shells.lua` is never touched

Restart `rtx_housing` (or the server) and the shell is in the Property Creator.

You can also press **Add to RTX Housing** in the Finish window at any time.

***

## Any Other Housing System

Press **Housing config** in the Finish window. Every tab is a ready config for one housing script, with your housing points already in it, and a line that tells you where to paste it. Press **Copy** and paste it.

<figure><img src="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FVWnThaNcGc9HWUS2GJoM%2Fshell-creator-housing-config.webp?alt=media" alt="The Housing config window"><figcaption><p>A ready config for your housing script, with your points already in it.</p></figcaption></figure>

The same configs are saved in the `housing/` folder of the shell resource.

`Config.HousingExport` sets which tab opens first.

{% hint style="info" %}
All points are offsets from the shell origin.
{% endhint %}

***

## Your Own Scripts

* **Lua offsets** and **JSON offsets** with the model and every point
* Exports of the shell resource to enter, leave and spawn it

```lua
local id = exports.rtx_shell_my_shell:EnterShell(vector3(0.0, 0.0, -50.0), { heading = 0.0 })

exports.rtx_shell_my_shell:LeaveShell(id, vector3(215.0, -810.0, 30.7), 90.0)
```

See [Shell Exports](/rtxdev/rtx-shell-creator/exports-events/shell-exports.md).

***

## Doors When a Housing Script Spawns the Shell

When your housing script spawns the shell model itself, the shell resource spawns its doors around it on its own (`Config.AutoDoors = true` in the shell's `config.lua`). Set `Config.AutoProps = true` to spawn the furniture too.
