> For the complete documentation index, see [llms.txt](https://grp-development.gitbook.io/solid-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://grp-development.gitbook.io/solid-scripts/resources/solid-shellcreator/creator-guide.md).

# Creator guide

Build, paint, furnish and publish a shell in game.

#### Manager

`/shellcreator` opens the manager. Every tab is for admins only.

| Tab           | What it does                                                                                                                                                              |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Shells**    | Every shell with its picture or plan. Edit, visit, publish, rename, duplicate, share code, versions, bake, save as template, delete, and the ready code for other scripts |
| **Templates** | 25 ready templates and your own, by category. Create a shell from one in one click                                                                                        |
| **Community** | Shells shared by other servers: browse, download, rate and share your own                                                                                                 |
| **Doors**     | Teleporters that put a shell behind a door in the city, see [Teleporters](https://grp-development.gitbook.io/solid-scripts/resources/solid-shellcreator/teleporters)      |
| **Guide**     | The steps and keys in game                                                                                                                                                |

#### Build a shell

{% stepper %}
{% step %}
**Create**

Press **New**, give the shell a name and pick a template or an empty plot.
{% endstep %}

{% step %}
**Draw rooms**

Room tool: drag a rectangle. Walls, floor and ceiling appear at once and rooms share walls.
{% endstep %}

{% step %}
**Doors and windows**

Opening tool: pick a shape and click a wall. Doors use real GTA door models and open in game.
{% endstep %}

{% step %}
**Paint**

Paint tool: pick a material and colour, then click a wall side, floor, ceiling or stairs. Shift paints both wall sides.
{% endstep %}

{% step %}
**Furnish**

Furniture tool: search the catalog, click an item and place it. R or the mouse wheel rotates.
{% endstep %}

{% step %}
**Publish and use**

Press **Walk** to try it on foot, then **Publish**. Players only see the published version. Add a teleporter or use the exports.
{% endstep %}
{% endstepper %}

#### Tools

| Tool      | What it does                                                                                            |
| --------- | ------------------------------------------------------------------------------------------------------- |
| Select    | Pick and move walls, openings, furniture, lights and points. Drag a wall to move it                     |
| Room      | Drag a rectangle for a room with four walls, floor and ceiling                                          |
| Wall      | Click every corner. Full wall, half wall, glass wall, glass or metal railing                            |
| Opening   | Doors, windows, arches, roller garage doors and elevators, curtains, blinds or frosted glass on windows |
| Paint     | Materials and colours, skirting and crown moulding per wall side                                        |
| Floor     | Add floor or ceiling, Alt or erase mode removes it for stairwells and open spaces                       |
| Stairs    | Straight, L, U and spiral stairs, each adds a floor (up to four)                                        |
| Furniture | 2,300+ default GTA props with pictures                                                                  |
| Light     | Lights under the ceiling with colour, range and brightness                                              |
| Points    | Entry, exit, stash, wardrobe and garage spots                                                           |
| Build     | Columns, round rooms, kitchen runs, roofs and pools                                                     |

#### Keys

| Key                 | What it does                                  |
| ------------------- | --------------------------------------------- |
| `1` to `0`          | Pick a tool                                   |
| `W A S D`           | Move the camera                               |
| `Q` / `E`           | Camera down and up (3D)                       |
| Right mouse         | Look around or pan                            |
| Mouse wheel         | Zoom                                          |
| `T`                 | Top view or 3D                                |
| `R`                 | Rotate furniture, stairs and points           |
| `Ctrl Z` / `Ctrl Y` | Undo and redo                                 |
| `Delete`            | Delete the selection                          |
| `Ctrl D`            | Duplicate furniture or lights                 |
| `F`                 | Focus the selection                           |
| `Alt`               | Pick a material, erase floors, lift furniture |
| `Shift`             | Faster camera, paint both sides               |
| `Esc`               | Stop drawing or placing                       |

#### Saving and versions

* Drafts save themselves while you build. Every autosave, manual save and publish is kept as a version.
* **Versions** shows them all, **Restore** brings one back.
* Several admins can edit the same shell at the same time and see each other's cursor.
* **Share code** copies the whole shell as text. Another server imports it with **New** > share code.
* Each shell can have a picture: an in-game photo (needs `screenshot-basic`), an uploaded image or a link.