> For the complete documentation index, see [llms.txt](https://prompt-studio.gitbook.io/prompt-studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prompt-studio.gitbook.io/prompt-studio/sandy-maps/sandy-installation.md).

# Installation Guide

One page to install any Sandy Shores map — start lines, load order, and what each map needs

Every Sandy Shores map installs the same way. This page is the short version for all of them — the per-map pages only add location, features and doorlock data.

{% hint style="info" %}
Sandy Shores is split into **one resource per map** on purpose. Install only the maps you own; nothing here requires you to run the full set.
{% endhint %}

***

## Quick install (any Sandy map)

{% stepper %}
{% step %}

#### Step 1 — Add the resource

Drop the map folder into your `resources` directory. We recommend grouping them so load order is easy to manage:

<pre><code><strong>resources/[promptsandy]/prompt_sandy_bank
</strong></code></pre>

{% endstep %}

{% step %}

#### Step 2 — Add it to server.cfg

<pre class="language-cfg"><code class="lang-cfg"><strong>start prompt_sandy_bank
</strong></code></pre>

Using a folder like `[promptsandy]`? A single `ensure [promptsandy]` starts everything inside it.
{% endstep %}

{% step %}

#### Step 3 — Install the Sandy MapData

**This is the step people miss.** Almost every Sandy map needs the matching [**Sandy MapData**](/prompt-studio/sandy-maps/sandy-mapdata.md) or it will load wrong — floating props, missing ground, or no interior at all.

Start it **after** your maps in `server.cfg`.
{% endstep %}

{% step %}

#### Step 4 — Restart and check

Restart the server, travel to the map, and confirm the exterior and interior load ✅
{% endstep %}
{% endstepper %}

***

## Load order

Order matters in three places only:

```cfg
ensure ox_lib                   # before any map that uses it
start prompt_sandy_shared       # before Sandy Houses
start [promptsandy]             # all your Sandy maps
start cfx_prompt_sandy_mapdata  # MapData LAST, after every map that uses it
```

{% hint style="warning" %}
**MapData goes last.** It must start **after** every map that uses it — starting it first is the most common cause of a map loading wrong.

`ox_lib` starts **before** the maps that depend on it, and `prompt_sandy_shared` **before** Sandy Houses. Everything else is a pure map resource and is order-independent.
{% endhint %}

***

## All Sandy resources

Resource names are exact — copy them straight into `server.cfg`.

{% hint style="danger" %}
**Some of these are alternatives, not additions.** Each pair below occupies the same lot — installing both puts two builds in one place. Pick one:

| Install this              | …or this                                    | Not both      |
| ------------------------- | ------------------------------------------- | ------------- |
| Sandy Hospital **V2**     | Sandy Hospital (original)                   | same building |
| Sandy Fire Station **V2** | Sandy Fire Department (original)            | same building |
| The Corner                | Corner Construction *(the pre-build lot)*   | same lot      |
| Sandy Shores Downtown     | Downtown Construction *(the pre-build lot)* | same lot      |

The construction packs are the "work in progress" version of those lots — use them **instead of** the finished map, e.g. to stage a build-up on your server.
{% endhint %}

| Map                                                                                                            | Resource                                                                                                      |                                                                            Download                                                                           | Also needs                                                 | Exterior-Only |
| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | :-----------------------------------------------------------------------------------------------------------------------------------------------------------: | ---------------------------------------------------------- | :-----------: |
| [Sandy MapData](/prompt-studio/sandy-maps/sandy-mapdata.md)                                                    | `cfx_prompt_sandy_mapdata`                                                                                    |             [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Map+Data)            | —                                                          |       —       |
| [Sandy Shores Downtown](/prompt-studio/sandy-maps/sandy-downtown.md)                                           | `prompt_sandy_downtown`                                                                                       |             [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Downtown)            | ⚠️ not with Downtown Construction                          |       ✓       |
| [Custom Roads & Traffic](/prompt-studio/sandy-maps/custom-roads-and-traffic.md)                                | `prompt_sandy_roads`                                                                                          |     [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Roads+Rework+%2B+Traffic)    | —                                                          |       —       |
| [The Corner](/prompt-studio/sandy-maps/the-corner.md)                                                          | `prompt_sandy_corner`                                                                                         | [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Corner+%5BBowling%2C+Diner%2C+S) | `ox_lib` · ⚠️ not with Corner Construction                 |       ✓       |
| [University](/prompt-studio/sandy-maps/university.md)                                                          | `prompt_sandy_university`                                                                                     |      [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+University+%7C+School)      | —                                                          |       ✓       |
| [Sandy Fire Station V2](/prompt-studio/sandy-maps/sandy-fire-station-v2.md)                                    | `prompt_sandy_fire2`                                                                                          |      [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Shores+FireStation+V2)      | ⚠️ replaces Fire Department                                |       ✓       |
| [Sandy Hospital V2](/prompt-studio/sandy-maps/sandy-hospital-v2.md)                                            | `prompt_sandy_hospital2`                                                                                      |        [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Shores+Hospital+V2)       | `ox_lib` · ⚠️ replaces Hospital                            |       ✓       |
| [Sandy Apartments](/prompt-studio/sandy-maps/sandy-apartments.md)                                              | `prompt_sandy_apts`                                                                                           |            [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Apartments)           | —                                                          |       ✓       |
| [Sandy Bank](/prompt-studio/sandy-maps/sandy-bank.md)                                                          | `prompt_sandy_bank`                                                                                           |               [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Bank)              | —                                                          |       ✓       |
| [Sandy Market](/prompt-studio/sandy-maps/sandy-market.md)                                                      | `prompt_sandy_market`                                                                                         |              [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Market)             | —                                                          |       ✓       |
| [Sandy Motel](/prompt-studio/sandy-maps/sandy-motel.md)                                                        | `prompt_sandy_motel`                                                                                          |              [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Motel)              | —                                                          |       ✓       |
| [Sandy Mechanic](/prompt-studio/sandy-maps/sandy-mechanic.md)                                                  | `prompt_sandy_mechanic`                                                                                       |         [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Shores+Mechanic)         | `ox_lib`                                                   |       ✓       |
| [Illegal Garage & Gas Station](/prompt-studio/sandy-maps/sandy-illegal-garage-and-gas-station-with-carwash.md) | `prompt_sandy_illegal_garage`                                                                                 |             [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Illegal)             | `ox_lib`                                                   |       ✓       |
| [Sandy Church](/prompt-studio/sandy-maps/sandy-church.md)                                                      | `prompt_sandy_church`                                                                                         |              [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Church)             | —                                                          |       ✓       |
| [Sandy Car Dealership](/prompt-studio/sandy-maps/sandy-car-dealership.md)                                      | `prompt_sandy_classic_car_dealership`                                                                         |          [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Car+Dealership)         | —                                                          |       ✓       |
| [Sandy City Hall](/prompt-studio/sandy-maps/sandy-city-hall.md)                                                | `prompt_sandy_cityhall`                                                                                       |            [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+City+hall)            | `ox_lib`                                                   |       ✓       |
| [Sandy Houses](/prompt-studio/sandy-maps/sandy-houses.md)                                                      | `prompt_sandy_houses_part1`                                                                                   |          [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Shores+Houses)          | `prompt_sandy_shared`                                      |       ✓       |
| [Sandy Train Station](/prompt-studio/sandy-maps/sandy-train-station.md)                                        | `prompt_sandy_train_station`                                                                                  |              [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Train)              | —                                                          |       ✓       |
| [Sandy Sheriff](/prompt-studio/sandy-maps/sandy-sheriff.md)                                                    | `prompt_sandy_sheriff`                                                                                        |             [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Sheriff)             | —                                                          |       ✓       |
| [Sandy Airport](/prompt-studio/sandy-maps/sandy-airport.md)                                                    | `prompt_sandy_airfield`                                                                                       |            [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Shores+Air)           | —                                                          |       —       |
| [Sandy Hospital *(original)*](/prompt-studio/sandy-maps/sandy-hospital.md)                                     | `prompt_sandy_hospital`                                                                                       |      [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Shores+Hospital\&row=0)     | ⚠️ superseded by V2                                        |       ✓       |
| [Sandy Fire Department *(original)*](/prompt-studio/sandy-maps/sandy-fire-department.md)                       | `cfx_prompt_sandy_shores_fire_department`                                                                     |            [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Sandy+Shores+Fire+Department)            | ⚠️ superseded by Fire Station V2                           |       ✓       |
| [Sandy Marina](/prompt-studio/sandy-maps/sandy-marina.md)                                                      | `cfx_prompt_sandy_marina`                                                                                     |        [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Marina+%7C+Beaches)       | —                                                          |       —       |
| [Boat House](/prompt-studio/sandy-maps/boat-house.md)                                                          | `cfx_chuz_sandy_shores_boat_house`                                                                            |           [Portal](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Chuz+Mapping+-+Sandy+Boat+House)          | —                                                          |       —       |
| [\[FREE\] Construction Zones](/prompt-studio/sandy-maps/free-construction-zones.md)                            | <p><code>prompt\_sandy\_corner\_construction</code><br><code>prompt\_sandy\_downtown\_construction</code></p> |                                                                               —                                                                               | ⚠️ pre-build lots — use *instead of* The Corner / Downtown |       —       |

***

## Add-ons

{% tabs %}
{% tab title="Sandy Shared Files" %}
Required for **Sandy Houses interiors**. The house interiors ship in their own resource:

```cfg
start prompt_sandy_shared
start prompt_sandy_houses_part1
```

Without it the houses still load — as exteriors only, with no interiors. [**Download Sandy Shared Files**](https://portal.cfx.re/assets/granted-assets?page=1\&sort=asset.updated_at\&direction=asc\&search=Prompt%27s+-+Sandy+Shared+Files) from the CFX Portal.
{% endtab %}

{% tab title="Exterior-Only Add-On" %}
Free drag-and-drop patch that strips interiors from the maps marked ✓ above, keeping the exteriors fully intact. Useful for lower-end servers.

→ [**Exterior-Only Add-On**](/prompt-studio/sandy-maps/exterior-only-add-on.md)
{% endtab %}

{% tab title="Compatibility" %}
Some Prompt Studio maps edit the same vanilla-area files as each other. If two of ours conflict — missing ground, floating props, broken collision — run the [**Vertex Hub Merger**](https://app.vertex-hub.com/merger): it merges the shared files for exactly the combination you have installed.

{% hint style="success" %}
**Merging our maps between each other with Vertex Hub is completely FREE of charge** — any Prompt Studio map with any other, no cost, no limit.
{% endhint %}
{% endtab %}

{% tab title="Doorlocks" %}
Most Sandy maps ship community-submitted [`ox_doorlock`](https://github.com/overextended/ox_doorlock) SQL on their own page — import it and restart `ox_doorlock`.

{% hint style="success" %}
All our doorlock SQL uses `DEFAULT` for the `id` column, so your database assigns free IDs on import. It will never collide with doorlocks you already have, no matter how many of our maps you install.
{% endhint %}
{% endtab %}
{% endtabs %}

***

## Troubleshooting

<details>

<summary>The map doesn't appear at all</summary>

1. Check the resource is actually started — look for it in the server console on boot.
2. Confirm the folder name matches the `start` line exactly (they're case-sensitive on Linux).
3. Clear your client cache: `%localappdata%\FiveM\FiveM Application Data\data\cache`, then rejoin.

</details>

<details>

<summary>Exterior loads but the interior is missing or floating</summary>

Almost always the **MapData**. Make sure you have the correct [Sandy MapData](/prompt-studio/sandy-maps/sandy-mapdata.md) installed, and that it starts **after** the maps in your `server.cfg` — not before.

For Sandy Houses specifically, missing interiors usually means `prompt_sandy_shared` isn't installed.

</details>

<details>

<summary>Props or ground are in the wrong place after an update</summary>

Update the MapData too. MapData and maps are versioned together — a new map release can expect a newer MapData.

</details>

<details>

<summary>Doorlocks didn't import</summary>

Import the SQL from the map's own page, then `restart ox_doorlock`. If a query fails, check you copied the full statement including the closing `;`.

</details>

***

Still stuck? Join the [Prompt Studio Discord](https://discord.gg/rKbHHdfZFU) with your resource name, console errors, and a screenshot — that's usually enough for us to spot it straight away.
