> 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/overview.md).

# Overview

What RTX Shell Creator is and what it can do.

### 🏠 Build Your Own Shells In Game

👉 **Purchase on Tebex:**\
<https://rtx.tebex.io/package/7763334>

🎬 **Preview video:**\
<https://www.youtube.com/watch?v=EPpvW_mne4Y>

<figure><img src="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2F2vPL2E9XxQ8RwbUZsyEy%2Fshell-creator-furnished-house.webp?alt=media" alt="A furnished house built with RTX Shell Creator"><figcaption><p>A whole furnished house, built in the game with RTX Shell Creator.</p></figcaption></figure>

***

## What is RTX Shell Creator?

**RTX Shell Creator** is an in-game editor for building house interiors on your FiveM server.

Your admins draw the rooms on a floor plan or straight in 3D, add doors, windows, stairs, kitchens, bathrooms, pools, balconies, lights and furniture, and the shell builds itself live in the game while they draw. When it is done, one click turns it into a ready resource on your server.

It is designed to be:

* easy to use, with no 3D skills needed
* done entirely in the game, with no Blender and no CodeWalker
* ready for **RTX Housing and any other housing system**
* light on performance, because a finished shell is **one model**
* yours - add your own props, textures, colours, templates and language

{% embed url="<https://www.youtube.com/watch?v=EPpvW_mne4Y>" %}

***

## Standalone & Framework Support

RTX Shell Creator is a **standalone resource**.

### Supported out of the box:

* **ESX**
* **QBCore**
* **QBox**
* **Standalone** (ACE and identifiers)

The framework is only used to decide who is an admin and to read a player's name. The admin check is open-source in `server/other.lua`, so it fits any framework.

***

## How It Works

{% stepper %}
{% step %}

### Draw

Type `/shellcreator`, start a new shell from a ready layout or an empty plan, and draw the rooms. The shell appears high in the sky above the Grapeseed fields and builds itself while you draw.

<figure><img src="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FFqEzXr3g6RrXAJfkTpeh%2Fshell-creator-floor-plan.webp?alt=media" alt="Drawing a room on the floor plan"><figcaption><p>Dragging out a new room on the 2D floor plan.</p></figcaption></figure>
{% endstep %}

{% step %}

### Furnish

Add doors, windows, stairs, built-ins, lights and furniture. Paint everything with 104 materials, 64 tint colours or your own textures.

<figure><img src="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2F9VNSQzcChfhAfIgjCbsy%2Fshell-creator-furniture-catalogue.webp?alt=media" alt="The furniture catalogue"><figcaption><p>2,793 props with a picture of every one - and your own props next to them.</p></figcaption></figure>
{% endstep %}

{% step %}

### Walk through it

Walk through the shell with your own character. Doors swing, ladders climb and elevators move.

<figure><img src="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FRPOpHWtBmss0mMSYs9x1%2Fshell-creator-walk-mode.webp?alt=media" alt="Walk mode"><figcaption><p>Walk mode - your own character inside the shell.</p></figcaption></figure>
{% endstep %}

{% step %}

### Finish

Press **Finish**. The whole build becomes one shell model, or a real MLO, and is installed on your server with one click, together with a ready housing config.

<figure><img src="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FlYSjCWOIRAUsIvF8TJnf%2Fshell-creator-finish-shell-or-mlo.webp?alt=media" alt="Finish window"><figcaption><p>Build as a shell or as a real MLO.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Features

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Walls &#x26; rooms</strong></td><td>2D plan, Split view or 3D. Square, round and oval rooms, curved walls.</td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2Fa9QW2bJdrcZ06toUx1p3%2Fshell-creator-walls-in-3d.webp?alt=media">shell-creator-walls-in-3d.webp</a></td><td><a href="/rtxdev/rtx-shell-creator/guides/walls-and-rooms.md">Walls &amp; Rooms</a></td></tr><tr><td><strong>Doors &#x26; windows</strong></td><td>18 kinds of openings, 29 door styles, glass, bars, blinds and the view.</td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FNTe2i8LuJDAz4QHYv3XH%2Fshell-creator-windows.webp?alt=media">shell-creator-windows.webp</a></td><td><a href="/rtxdev/rtx-shell-creator/guides/doors-and-windows.md">Doors &amp; Windows</a></td></tr><tr><td><strong>Stairs, floors &#x26; roofs</strong></td><td>7 stair types that build the floor above, basements and roofs.</td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FFU9v1OF8qP95l4l47joA%2Fshell-creator-stairs.webp?alt=media">shell-creator-stairs.webp</a></td><td><a href="/rtxdev/rtx-shell-creator/guides/stairs-floors-and-roofs.md">Stairs, Floors &amp; Roofs</a></td></tr><tr><td><strong>Pools, kitchens &#x26; details</strong></td><td>Pools, kitchens, built-ins, balconies, gardens and elevators.</td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FZRtTzoUBTaC2EXZqeXlr%2Fshell-creator-pools.webp?alt=media">shell-creator-pools.webp</a></td><td><a href="/rtxdev/rtx-shell-creator/guides/pools-kitchens-and-details.md">Pools, Kitchens &amp; Details</a></td></tr><tr><td><strong>Paint &#x26; materials</strong></td><td>104 materials, 64 tints, your own colours and textures, tile by tile.</td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2F2bCB0xwYZT2NaKDjFjQk%2Fshell-creator-paint-tiles.webp?alt=media">shell-creator-paint-tiles.webp</a></td><td><a href="/rtxdev/rtx-shell-creator/guides/paint-and-materials.md">Paint &amp; Materials</a></td></tr><tr><td><strong>Lights</strong></td><td>9 lamp types with real game lights.</td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FTXBdm46k6kacZb0tIfGi%2Fshell-creator-lights.webp?alt=media">shell-creator-lights.webp</a></td><td><a href="/rtxdev/rtx-shell-creator/guides/lights.md">Lights</a></td></tr><tr><td><strong>Furniture</strong></td><td>2,793 props, your own props, smart placement and the gizmo.</td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FEe7ncvu6XUkag8W5zKVp%2Fshell-creator-gizmo.webp?alt=media">shell-creator-gizmo.webp</a></td><td><a href="/rtxdev/rtx-shell-creator/guides/furniture.md">Furniture</a></td></tr><tr><td><strong>Build together</strong></td><td>Several admins in the same shell at the same time.</td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2Fijd5nK3bH41jrpb6WK9Z%2Fshell-creator-build-together.webp?alt=media">shell-creator-build-together.webp</a></td><td><a href="/rtxdev/rtx-shell-creator/guides/build-together-and-walk-mode.md">Build Together &amp; Walk Mode</a></td></tr><tr><td><strong>Checks &#x26; history</strong></td><td>Find problems, fix them in one click, go back to any version.</td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FxWF62BxHPHeTZlR5HEV8%2Fshell-creator-checks.webp?alt=media">shell-creator-checks.webp</a></td><td><a href="/rtxdev/rtx-shell-creator/guides/checks-undo-and-history.md">Checks, Undo &amp; History</a></td></tr></tbody></table>

* **2D floor plan, Split view and 3D** - build in all of them, the shell builds itself live in the game
* **Square, round and oval rooms**, curved walls and free angles
* **8 ready layouts** - House, Apartment, Studio flat, Garage, Mechanic shop, Office, Shop and Warehouse
* **18 kinds of doors, windows and openings** with **29 door styles** and garage doors
* **7 stair types** that build the floor above, basements and double-height rooms
* **Roofs** - flat, gable or single slope, with a sloped attic ceiling inside
* **Pools** cut into the floor
* **Kitchens and built-ins** - units, islands, wardrobes, vanities, showers, bathtubs, fireplaces and more
* **Structure and outside** - columns, glass walls, railings, ladders, working elevators, balconies, terraces and gardens
* **104 materials**, **64 tint colours** and **your own PNG textures**, painted per room, per wall side, per part of a wall or tile by tile
* **9 lamp types** with real game lights
* **2,793 furniture props** with a picture of every one, **your own props**, smart placement, a gizmo and one-click furnishing
* **Housing points** - exit, management, wardrobe, storage, cooking, sinks, showers and cleaning spots
* **Build together** - several admins in the same shell at the same time
* **Walk mode** with your own character
* **Checks** that find problems and fix most of them with one click
* **Undo, redo and History** with automatic and named versions
* **Finish as one shell model or a real MLO**, installed with one click
* **Ready for RTX Housing and any other housing system**, added to RTX Housing automatically
* **Templates, share codes** and a community gallery
* **Built-in guide** for new builders
* **18 languages**

***

## One Real Shell

Most in-game shell builders save a list of props and spawn them one by one every time a player goes inside.

RTX Shell Creator does it differently. When you press **Finish**, the walls, floors, stairs, built-ins and lights of the whole build are baked into **one model** (`.ydr`) with its collision and textures, plus its `.ytyp`. Doors and furniture stay real objects, spawned by the generated resource, so doors can open and furniture can be moved.

<figure><img src="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FGGyYCJRoZmtMlzgWbOMB%2Fshell-creator-one-real-shell.webp?alt=media" alt="The generated shell resource"><figcaption><p>The finished resource - one streamed model, its collision and textures.</p></figcaption></figure>

The result is a normal shell, used exactly like any other shell you would buy.

***

## Make It Yours

| What                   | How                                                             |
| ---------------------- | --------------------------------------------------------------- |
| **Your own props**     | Any streamed prop, placed by its name or added to the catalogue |
| **Your own textures**  | PNG files in the `custom` folder, baked into the finished shell |
| **Your own colours**   | A colour picker in every shell                                  |
| **Your own templates** | Save any shell as a template                                    |
| **Your own language**  | Every text is in an open language file                          |
| **Your own admins**    | ACE, framework groups, single players or your own check         |

Step by step: [Adding Your Own Content](/rtxdev/rtx-shell-creator/guides/adding-your-own-content.md)

***

## Built With It

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Nightclub</strong></td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2Ftg0agUQxTd7Pniv8X8zW%2Fshell-creator-showcase-nightclub.webp?alt=media">shell-creator-showcase-nightclub.webp</a></td></tr><tr><td><strong>Nightclub - inside</strong></td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FgLVxAwcOnJDRqFefOypi%2Fshell-creator-showcase-nightclub-inside.webp?alt=media">shell-creator-showcase-nightclub-inside.webp</a></td></tr><tr><td><strong>Brick loft</strong></td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2Fnafg74nkZ3x11qufhvq7%2Fshell-creator-showcase-brick-loft.webp?alt=media">shell-creator-showcase-brick-loft.webp</a></td></tr><tr><td><strong>Brick loft - inside</strong></td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FDIzIBjtQMoMURtdWexqN%2Fshell-creator-showcase-brick-loft-inside.webp?alt=media">shell-creator-showcase-brick-loft-inside.webp</a></td></tr><tr><td><strong>Cabin with a pool</strong></td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FfFDwqJplPqN4CqCBD2Ml%2Fshell-creator-showcase-cabin-pool.webp?alt=media">shell-creator-showcase-cabin-pool.webp</a></td></tr><tr><td><strong>Cafe</strong></td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FFxyo8lBct6a3K6s52nbk%2Fshell-creator-showcase-cafe.webp?alt=media">shell-creator-showcase-cafe.webp</a></td></tr></tbody></table>

***

## Performance & Optimization

* A finished shell is **one streamed model**, not hundreds of props
* Shells in the build zone are only spawned for players near them
* Big shells load the floor you are working on first
* Every action is checked on the server, and only your admins can build

***

## Developer Friendly

RTX Shell Creator provides:

* a fully commented config
* open-source client and server bridges (`client/other.lua`, `server/other.lua`)
* exports in every finished shell to enter, leave and spawn it
* exports and events for your own scripts
* Discord logs

***

## Need Help?

If you have any questions, issues or feature requests, feel free to contact us on Discord:

<a href="https://discord.gg/rtxdev" class="button primary">Join our Discord</a> <a href="https://rtx.tebex.io/package/7763334" class="button secondary">Buy on Tebex</a>
