# Install

<div className="fd-steps [&_h3]:fd-step">
  ### Download the Resource [#download-the-resource]
  Download the resource from the [Cfx.re Portal](https://portal.cfx.re/) after purchasing.

  ### Extract and Place into Resources [#extract-and-place-into-resources]
  Download the file, extract it, and place it in your server's resource folder.

  ### Update Config [#update-config]
  Make sure to include the resource in your `server.cfg` if you haven't already.  
  The resource should be started after your framework and `oxmysql`.

  <Tabs groupId="framework" persist items={["ESX", "QB", "Qbox"]}>
    <Tab value="ESX">
      ```
      ensure oxmysql
      ensure es_extended
      ensure vx_multicharacter
      ```
    </Tab>
    <Tab value="QB">
      ```
      ensure oxmysql
      ensure qb-core
      ensure vx_multicharacter
      ```
    </Tab>
    <Tab value="Qbox">
      ```
      ensure oxmysql
      ensure qbx_core
      ensure vx_multicharacter
      ```
    </Tab>
  </Tabs>

  ### Framework Changes [#framework-changes]
  <Tabs groupId="framework" persist items={["ESX", "QB", "Qbox"]}>
    <Tab value="ESX">
      Remove `esx_multicharacter` and `esx_identity`, this resource replaces both.

      Add a "provides" section to the `fxmanifest.lua` of `vx_multicharacter` if it's not there already, so other ESX resources don't throw errors.

      ```lua
      provides({ "esx_identity", "esx_multicharacter" })
      ```
    </Tab>
    <Tab value="QB">
      Remove `qb-multicharacter`, this resource replaces it.
    </Tab>
    <Tab value="Qbox">
      Set these values in `qbx_core/config/client.lua`:

      ```lua
      useExternalCharacters = true
      startingApartment = false
      ```

      `useExternalCharacters` hands character selection to this resource. `startingApartment` is turned off because the multicharacter has its own logic that supports `qbx_properties`.
    </Tab>
  </Tabs>

  ### Configure the Resource [#configure-the-resource]
  You can now configure the resource; all configs are in the `config` folder.

  ### Restart Server [#restart-server]
  Once you've completed all the steps above, you should be set.
</div>
