Character Manager PRO

{:links-list}

INSTALLATION

  1. Extract BigDaddy-CharacterManager and the included BigDaddy-Appearance resource into your server's resources folder.
  2. Add your product key (get it here) to each resource's settings.ini as supplied with your download.
  3. Configure the MySQL connection and run the included sql.sql as described below.
  4. Start Appearance before Character Manager in server.cfg:
ensure BigDaddy-Appearance
ensure BigDaddy-CharacterManager

DO NOT RENAME THE FOLDER.

If you change the name of the folder it will not function correctly so leave the name as it is.

{:is-danger}

BigDaddy-Appearance provides the appearance editor and is a declared dependency. The old fivem-appearance installation instructions belong to the obsolete Character Manager, not PRO. Keep Character Manager's included stream assets installed for its editing room.

DATABASE

This resource requires a MySQL database. Its bundled bdsql.js connects directly using mysql_connection_string; it does not require a separate oxmysql, mysql-async, or ghmattimysql resource. Set the connection string before starting Character Manager.

Run the included sql.sql against your selected database. The resource does not create this schema automatically on startup. Back up an existing database before running the upgrade script; it also clears parent links whose referenced character no longer exists.

{:links-list}

COMMANDS

COMMAND DESCRIPTION
/manageme Opens the full character manager in the editing room.
/chooseme Opens the quick character chooser at your current location, with creation and editing actions hidden.

CONFIGURATION

These values match the checked project's settings.ini. Restart the resource after changing settings.

SECTION SETTING SUPPLIED VALUE DESCRIPTION
licensing key1 Your product key Enter the key supplied for your purchase.
settings disableWalkOut false Set to true to skip the walk-out/walk-in animation when previewing another character in the full manager. The quick chooser skips it automatically.
settings EditCoords-X 1450.9371 Editing room X coordinate.
settings EditCoords-Y 3560.0149 Editing room Y coordinate.
settings EditCoords-Z -26.0449 Editing room Z coordinate; preserve the negative sign for the included room.
settings EditCoords-W 269.9457 Editing heading.
settings debug false Enables diagnostic logging.

Leave the supplied DesyncKey unchanged. The CAD settings (cad, imperialFields, and the sonoran... settings) are marked inactive in the supplied INI. The normal CAD retrieval and save paths are not enabled yet, so entering credentials does not enable CAD synchronization.

HOW TO

Inside the manageme screen is a list of your saved characters on the left and a menu on the right.

Select a character to preview it, then choose DONE to keep that selection. CANCEL restores the appearance you had when opening the manager; it does not undo database edits already saved.

ACTION DESCRIPTION
CREATE NEW Starts a new character in BigDaddy-Appearance.
EDIT Edits the selected saved character.
CLONE Creates a separate preset from your current appearance.
SUB-CHAR Creates a linked variant grouped under the selected parent character. Selecting the variant uses the parent's character name.
RENAME Changes the selected preset's name.
DELETE Permanently deletes the selected preset after confirmation. With the supplied database foreign key, delete linked sub-characters before deleting their parent.

Saved appearances are stored in bd_character. Character retrieval matches the player's license or legacy Steam identifier together with their Discord identifier. If a player's saved characters disappear after an identifier change, check those database fields before creating replacements.

Please watch the tutorial video to see details of how to use this resource. Tutorial Video

QB/QBX/ESX/FRAMEWORK USERS

The standalone /manageme and /chooseme menus manage appearance presets. They do not replace a framework's character login, identity, inventory, or progression system. See next section if running a framework server.

BIGDADDY-MULTICHARACTER INTEGRATION

Character Manager Pro includes an optional appearance editor integration for BigDaddy-MultiCharacter. BigDaddy-MultiCharacter remains responsible for character identity and persistence in framework servers.