# Add SSN Generation

***

{% hint style="danger" %}

## READ IT!

**This section is only for ESX users!**
{% endhint %}

1. ### Adjust SSN format

Go to vms\_documentsv2/server/modules/ssn.lua and in the first line you have to customize your birth date format stored on your server.

By default, the date of birth in ESX is stored in the column **dateofbirth**.

<figure><img src="https://3701050178-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6y0J5nnTjSyc65fbCvIU%2Fuploads%2Fwqq1xdXjqj7Xak7KgDW8%2Fimage.png?alt=media&#x26;token=4d7b3fa6-72ba-4062-bfef-602298295737" alt=""><figcaption><p><em><strong>vms_documentsv2/server/modules/ssn.lua</strong></em></p></figcaption></figure>

2. ### Modifications in es\_extended

{% hint style="warning" %}
**If you are NOT using any multicharacter system, skip this step, go to identity.**
{% endhint %}

Go to your es\_extended/server/main.lua and replace the highlighted code in the `createESXPlayer` function.&#x20;

<pre class="language-lua" data-title="es_extended/server/main.lua" data-full-width="false" data-expandable="true"><code class="lang-lua">local function createESXPlayer(identifier, playerId, data)
    local accounts = {}

    for account, money in pairs(Config.StartingAccountMoney) do
        accounts[account] = money
    end

    local defaultGroup = "user"
    if Core.IsPlayerAdmin(playerId) then
        print(("[^2INFO^0] Player ^5%s^0 Has been granted admin permissions via ^5Ace Perms^7."):format(playerId))
        defaultGroup = "admin"
    end
    local parameters = Config.Multichar and
<strong>        { json.encode(accounts), identifier, Core.generateSSN(data.dateofbirth, data.sex), defaultGroup, data.firstname, data.lastname, data.dateofbirth, data.sex, data.height }
</strong>        or { json.encode(accounts), identifier, Core.generateSSN(), defaultGroup }

    if Config.StartingInventoryItems then
        table.insert(parameters, json.encode(Config.StartingInventoryItems))
    end

    MySQL.prepare(newPlayer, parameters, function()
        loadESXPlayer(identifier, playerId, true)
    end)
end
</code></pre>

Find the `loadESXPlayer` function and only the highlighted code

{% hint style="info" %}
Part of the code from the `loadESXPlayer` function has been removed to focus on the required changes.

You need to enter only `xPlayer.set("ssn", result.ssn)` in the highlighted area.

The line: `xPlayer.set("ssn", result.ssn)`

**MUST be placed:**

* inside `loadESXPlayer()`
* after the Identity block
* before `TriggerEvent("esx:playerLoaded")`
  {% endhint %}

<pre class="language-lua"><code class="lang-lua">function loadESXPlayer(identifier, playerId, isNew)
    ...

    -- Identity
    if result.firstname and result.firstname ~= "" then
        ...
    end
    
<strong>    xPlayer.set("ssn", result.ssn)
</strong>
    TriggerEvent("esx:playerLoaded", playerId, xPlayer, isNew)
    
    ....
end
</code></pre>

Go to your es\_extended/server/functions.lua and replace the entire `Core.generateSSN` function.&#x20;

{% code title="es\_extended/server/functions.lua" expandable="true" %}

```lua
---@param dob string?
---@param sex number?
---@return number
function Core.generateSSN(dob, sex)
    if dob == nil or sex == nil then
        return nil
    end
    
    if GetResourceState('vms_cityhall') == 'started' then
        return exports['vms_cityhall']:GenerateSSN(dob, sex)
    elseif GetResourceState('vms_documentsv2') == 'started' then
        return exports['vms_documentsv2']:GenerateSSN(dob, sex)
    end
end
```

{% endcode %}

3. ### Modifications in esx\_identity

{% hint style="warning" %}
**If you are using any multicharacter go back to point two.**
{% endhint %}

If you don't want to use the whole esx\_identity, read carefully the [**README.md**](https://github.com/vames-dev/es_extended/blob/main/README.md) from the above github, there you will find exactly marked changes.

{% embed url="<https://github.com/vames-dev/esx_identity>" %}