> For the complete documentation index, see [llms.txt](https://royals-store.gitbook.io/royals-store-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://royals-store.gitbook.io/royals-store-docs/documentation/getting-started/installing-a-resource.md).

# Installing a resource

The five steps that are identical for every RS Store resource.

Each resource has its own installation page with its specific steps. This page covers what is true for all of them — read it once, then jump to your resource.

## 1. Do not rename the folder

{% hint style="danger" %}
Every RS Store resource checks its own folder name when it starts and **stops itself** if it was renamed. This is not a bug — it is what keeps `@Resource/file.lua` references and NUI paths working.
{% endhint %}

| Resource              | Folder must be exactly  |
| --------------------- | ----------------------- |
| Advanced Store        | `Advanced_Store`        |
| Advanced Player Store | `Advanced_Player_Store` |
| Rs CryptoMining       | `Rs_CryptoMining`       |
| Rs Banking            | `Rs_Banking`            |
| Rs SolarPanel         | `Rs_SolarPanel`         |

{% hint style="info" %}
**Rs Banking does not stop itself** — but renaming it still breaks things silently. Its items are wired to your inventory through `client = { export = 'Rs_Banking.useTerminal' }` and friends, which name the resource. Rename the folder and "use item" stops working on the terminal, the chequebook and the cheque until you update every one of those lines.
{% endhint %}

Unzipping sometimes produces a wrapper folder (`Advanced_Store-1.3.1/Advanced_Store/`). Move the **inner** folder into `resources/`, not the wrapper.

## 2. Drop it in your resources folder

Anywhere under `resources/` works, including inside a `[rs]` bracket folder:

```
resources/
└── [rs]/
    ├── Advanced_Store/
    ├── Advanced_Player_Store/
    └── Rs_CryptoMining/
```

## 3. Start it in the right order

Order matters. A resource must start **after** everything it depends on:

{% code title="server.cfg" %}

```cfg
ensure oxmysql
ensure ox_lib
ensure es_extended          # or qb-core / qbx_core
ensure ox_inventory
ensure ox_target

ensure Advanced_Store
ensure Advanced_Player_Store   # DLC — always after Advanced_Store
ensure Rs_CryptoMining
```

{% endcode %}

{% hint style="warning" %}
`Advanced_Player_Store` is a DLC. Starting it before `Advanced_Store` fails, because it loads the base resource's config, bridge and locales through `@Advanced_Store/...`.
{% endhint %}

## 4. Import the database (when required)

| Resource              | Database                                                                              |
| --------------------- | ------------------------------------------------------------------------------------- |
| Advanced Store        | none — unless you want shop company accounts, see its installation page               |
| Advanced Player Store | tables are **created automatically** on first start; `sql/` is provided for reference |
| Rs Banking            | **self-installing** — it reads `sql/banking.sql` on first start, nothing to import    |
| Rs CryptoMining       | import `install/sql.sql` **once**, by hand                                            |
| Rs SolarPanel         | import `install/sql.sql` **once**, by hand                                            |

## 5. Configure, then restart

Open the config file, set the two or three settings at the top (framework, language, payment), then restart the server — not just the resource, so dependencies reload cleanly.

| Resource              | Config file         |
| --------------------- | ------------------- |
| Advanced Store        | `config.lua`        |
| Advanced Player Store | `config.lua`        |
| Rs Banking            | `config.lua`        |
| Rs CryptoMining       | `shared/config.lua` |
| Rs SolarPanel         | `shared/config.lua` |

## Checking it worked

Run `/scriptinfo` in the **server console**. Each resource prints its version and the result of its version check. If the command does not exist, the resource is not running — scroll the console back to the start for the reason.

## Next steps

{% content-ref url="/pages/BNZu08Tte96HJ4oUVoRi" %}
[Installation](/royals-store-docs/documentation/advanced-store/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/FatCiMldD3t71d89VooZ" %}
[Installation](/royals-store-docs/documentation/advanced-player-store/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/cn0npm2e9Evjx44qldPu" %}
[Installation](/royals-store-docs/documentation/advanced-banking/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/uig4cZ3m6okz5U7t0MyL" %}
[Installation](/royals-store-docs/documentation/advanced-cryptomining/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/LH2VWDGuTf28pe095SGk" %}
[Installation](/royals-store-docs/documentation/advanced-solarpanel/installation.md)
{% endcontent-ref %}
