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

# Installation

1. Stop and remove `qb-multicharacter` and `qb-spawn`. SB MultiSpawn replaces both.
2. Drop `sbmultispawn` into your resources folder.
3. Start it after `qb-core`, `oxmysql`, your clothing, inventory, phone and housing resources:

```cfg
ensure sbmultispawn
```

4. No SQL is needed. It uses the normal QBCore `players` and `playerskins` tables.

### Files you'll edit

| File                               | What it does                                                                                          |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `config.lua`                       | Everything: language, slots, animations, creation rules, spawns, housing, map, wake-up and anticheat. |
| `anticheat.lua`                    | Your own anticheat, used when `Config.Anticheat = 'custom'`.                                          |
| `custom.lua`                       | Extra functions that run on load, create, delete, logout and spawn.                                   |
| `config_slots.lua`                 | Per-player slot counts by licence, Discord or Steam. **Server only.** It is never sent to clients.    |
| `shared/blacklist.lua`             | Blocked words and reserved names for character names.                                                 |
| `locales/en.lua`, `locales/es.lua` | Translations. Copy one to add a language, then set `Config.Language`.                                 |
| `html/images/`                     | Spawn location images (jpg or png). Leave `image = nil` to use a crop of the map instead.             |