Skip to main content

Installation

Basic installation instructions for wasabi_multichar.

danger

The resource folder must be named wasabi_multichar.

Before installing​

  1. Install the required dependencies.
  2. Remove or disable any existing multicharacter resource for your framework.
  3. Make sure ox_lib and oxmysql start before wasabi_multichar.
  4. Keep the public resource name as wasabi_multichar in your resources folder and server.cfg.
danger

Remove esx_multicharacter, esx_identity, or other replacement multicharacter/identity resources before using wasabi_multichar.

  1. Set ESX multicharacter support in es_extended/config.lua:
Config.Multichar = true
  1. Add the resource to your server resources folder as wasabi_multichar.
  2. Ensure dependencies and the resource in server.cfg:
ensure ox_lib
ensure oxmysql
ensure es_extended
ensure wasabi_multichar
  1. Configure the shared/client/server config files as needed.
  2. If using staff-only logout or admin VIP commands, add ACE permissions shown below.

ACE permissions​

Add only the permissions you actually use.

# Required only if Config.LogoutCommand.onlyStaff = true
add_ace group.admin wasabi_multichar.staff allow

# Required for the configured add VIP slot command
add_ace group.admin wasabi_multichar.addvip allow

# Required only if Config.DeleteCharacterRestricted = true
add_ace group.admin wasabi_multichar.delete allow

Optional webstore / VIP slots​

Extra slots are handled as VIP slots on top of Config.MaxSlots.

  1. Set your base slots in config/shared/config.lua:
Config.MaxSlots = 4
  1. If selling extra slots through Tebex, set your package ID in config/server/config.lua:
Config.TebexPackageID = 123456
  1. Add a webstore link in config/client/config.lua if you want the UI purchase button to open your store:
Config.WebstoreLink = 'https://your-store.example/package/123456'
Config.PurchaseUrl = Config.WebstoreLink

Spawn selector setup​

Current config defaults to the custom spawn selector bridge being enabled. To hand off to a custom spawn selector, keep:

Config.SpawnOptions.skipSpawnSelector = false
Config.SpawnOptions.useCustomSpawnSelector = true
Config.SpawnOptions.spawnSelectOnFirstSpawn = true -- optional

If you do not use a custom spawn selector, set useCustomSpawnSelector = false to use the built-in spawn fallback instead.

Then adjust bridge/spawn/server.lua for your spawn resource if needed.

Final checklist​

  • Resource folder is named wasabi_multichar.
  • Old multicharacter resources are disabled.
  • ox_lib, oxmysql, and your framework start before wasabi_multichar.
  • Config files are reviewed.
  • ACE permissions are added if using restricted logout, VIP slot command, or restricted deletion.
  • Preview locations are tested in-game after any camera/ped changes.