Browse docs
Player Documents
Identity and license cards
Open Player interactions → Documents → View identity or the license action in the Radial. The identity card shows the selected character's name, date of birth, gender and height when supplied by the framework. The license card shows name, photo and selected held licenses. Missing information stays unavailable; an empty list does not create a license.
The portrait captures a local copy of the player's current appearance without hat or glasses. The real ped is not changed. Photos are cached only on the viewing client for five minutes, with up to 32 character entries; character unload and resource stop clear the cache. No photo is uploaded or stored in a database. A neutral portrait remains if capture fails. Both cards omit signatures. Long license lists scroll independently using the mouse wheel over the list, the visible scrollbar, or Tab followed by the arrow keys. The bottom data zone restyles the respective card's fields. It does not generate a document number, expiry date or check digits, and is not a validated ICAO machine-readable document. There are no close buttons. Press Return / Enter or Escape to close a shared card. It also closes automatically after 60 seconds. Moving it through configuration does not restart that timer.
Config.PlayerIdentityCard and these exports before using the examples.
Older resource packages do not expose the new exports.Access and integrations
Viewing your own document does not require a job inspection permission. Inspecting another player requires the corresponding identity or licenses permission, including the configured job, grade and duty rules. Both players must be within 2.5 metres and in the same routing bucket. The target must be restrained by Jobs Base (handcuffs or zip ties). This also applies to Crime and Creator job profiles. The server rechecks the selected character, restraints and access after provider work. Document inspection does not ask for consent.
Native integrations for jsfour-idcard, um-idcard and qbx_idcard remain available through
config/player_actions.lua. An authorized native card opens its provider's interface.
The settings below apply to the shared card, not an external interface. Document inspection
does not create, renew, consume or transfer card items and does not grant licenses.
PresentOwnDocument(documentType, recipientServerId)
Shows the sender's own document on one nearby player's screen. The server chooses the authenticated sender's character. No inspection grant is required; the sender cannot be restrained. Both players must remain within 2.5 metres in the same routing bucket. The recipient must have no other focused NUI. Offers are single-use and bound to both players' current characters. Presentation uses the shared card interface.
local success, reason = exports["sky_jobs_base"]:PresentOwnDocument("service", recipientServerId)
The radial also exposes these actions under Player interactions → Documents. This presents a document; it does not transfer an inventory item.
Position, size and optional branding
In /jobconfig, choose Jobs Base → Player interactions → Identity card.
Saved configurator values take precedence over file defaults.
If Config.UseIngameConfigurator is disabled, edit Config.PlayerIdentityCard in
sky_jobs_base/config/config.lua instead.
| Setting | Values and behaviour |
|---|---|
enabled | Master switch for Sky's document actions and exports; default true. Set false when another resource owns your documents. |
serviceEnabled | Service-card and service-number management switch; default true. Set false to keep identity/licenses while disabling service IDs. |
position | left, center, right or custom; default right. |
x, y | Card centre in screen percentages, 0–100; used for custom. |
scale | Size in percent, 50–150; default 85. It also fits smaller viewports. |
issuer | Optional issuer name. Empty by default. |
logo | Optional filename inside config/documents, such as logo.svg. Empty by default. |
licenseTypes | Exact license type IDs visible on Sky's license card. Default: dmv, drive, drive_bike, drive_truck, driver, weapon, business. Use { "*" } for all held types; an empty list hides all. |
Logo filenames cannot be URLs or directory paths. Use letters, numbers, hyphens or underscores
followed by a file extension. No Sky logo, watermark or issuer text appears by default.
Live configuration changes update an open shared card without changing its person or focus.
Disabling a feature closes its open card and removes the related radial/target actions.
The server rejects disabled document requests and presentation offers. Independent external
resources retain their own interfaces and actions.
Reopen the card after changing licenseTypes. Filtering never grants or removes licenses,
and does not change an external provider's own card contents.
Editable appearance
| File | Purpose |
|---|---|
config/documents/identity.css | Both layouts, printed colours, typography, spacing and template dimensions. Use .sky-license-card for license-specific changes. |
config/documents/logo.svg | Replace the artwork, or add another local logo file and select it in configuration. |
config/locales/<language>.lua | Card titles and field labels under Nui.playerActions. |
Editable CSS loads from the resource after the built-in default stylesheet. After changing CSS, fonts, artwork or locales, restart Jobs Base and its active dependent jobs through your normal update process. CSS and artwork changes need no frontend rebuild. Changing the Vue component's markup does require a frontend rebuild.
The client document exports support own views, authorized target inspection and showing your own document to one selected nearby player.
Service IDs
See Service IDs and Numbers for department templates, persistent numbers, Boss Menu assignment, Creator jobs and database installation.