[{"data":1,"prerenderedAt":486},["ShallowReactive",2],{"/docs/base/jobs-base/features/player-documents":3,"/docs/base/jobs-base/features/player-documents-surround":473,"/docs/base/jobs-base/features/player-documents-implemented-suggestions":485},{"id":4,"title":5,"body":6,"description":462,"extension":463,"head":464,"implementedSuggestions":464,"meta":465,"navigation":466,"path":468,"schemaOrg":464,"seo":469,"sitemap":470,"stem":471,"__hash__":472},"docs/1.docs/base/2.jobs-base/2.features/5.player-documents.md","Player Documents",{"type":7,"value":8,"toc":453},"minimark",[9,14,23,38,51,55,69,88,92,98,155,162,166,188,359,365,369,420,423,432,436,444,449],[10,11,13],"h2",{"id":12},"identity-and-license-cards","Identity and license cards",[15,16,17,18,22],"p",{},"Open ",[19,20,21],"strong",{},"Player interactions → Documents → View identity"," or the license action in the Radial.\nThe identity card shows the selected character's name, date of birth, gender and height\nwhen supplied by the framework. The license card shows name, photo and selected held licenses.\nMissing information stays unavailable; an empty list does not create a license.",[15,24,25,26,29,30,33,34,37],{},"The portrait captures a local copy of the player's current appearance without hat or glasses.\nThe real ped is not changed. Photos are cached only on the viewing client for five minutes,\nwith up to 32 character entries; character unload and resource stop clear the cache.\nNo photo is uploaded or stored in a database. A neutral portrait remains if capture fails.\nBoth cards omit signatures. Long license lists scroll independently using the mouse wheel\nover the list, the visible scrollbar, or Tab followed by the arrow keys.\nThe bottom data zone restyles the respective card's fields. It does not generate a document number,\nexpiry date or check digits, and is not a validated ICAO machine-readable document.\nThere are no close buttons. Press ",[19,27,28],{},"Return / Enter"," or ",[19,31,32],{},"Escape"," to close a shared card.\nIt also closes automatically after ",[19,35,36],{},"60 seconds",". Moving it through configuration does not\nrestart that timer.",[39,40,43],"callout",{"color":41,"icon":42},"warning","i-lucide-info",[15,44,45,46,50],{},"This page describes the new document-card update. Install the update containing\n",[47,48,49],"code",{},"Config.PlayerIdentityCard"," and these exports before using the examples.\nOlder resource packages do not expose the new exports.",[10,52,54],{"id":53},"access-and-integrations","Access and integrations",[15,56,57,58,29,61,64,65,68],{},"Viewing your own document does not require a job inspection permission. Inspecting another\nplayer requires the corresponding ",[19,59,60],{},"identity",[19,62,63],{},"licenses"," permission, including the\nconfigured job, grade and duty rules. Both players must be within ",[19,66,67],{},"2.5 metres"," and in the\nsame routing bucket. The target must be restrained by Jobs Base (handcuffs or zip ties).\nThis also applies to Crime and Creator job profiles. The server rechecks the selected\ncharacter, restraints and access after provider work.\nDocument inspection does not ask for consent.",[15,70,71,72,75,76,79,80,83,84,87],{},"Native integrations for ",[47,73,74],{},"jsfour-idcard",", ",[47,77,78],{},"um-idcard"," and ",[47,81,82],{},"qbx_idcard"," remain available through\n",[47,85,86],{},"config/player_actions.lua",". An authorized native card opens its provider's interface.\nThe settings below apply to the shared card, not an external interface. Document inspection\ndoes not create, renew, consume or transfer card items and does not grant licenses.",[10,89,91],{"id":90},"presentowndocumentdocumenttype-recipientserverid","PresentOwnDocument(documentType, recipientServerId)",[15,93,94,95,97],{},"Shows the sender's own document on one nearby player's screen. The server chooses the\nauthenticated sender's character. No inspection grant is required; the sender cannot be\nrestrained. Both players must remain within ",[19,96,67],{}," in the same routing bucket.\nThe recipient must have no other focused NUI. Offers are single-use and bound to both\nplayers' current characters. Presentation uses the shared card interface.",[99,100,105],"pre",{"className":101,"code":102,"language":103,"meta":104,"style":104},"language-lua shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","local success, reason = exports[\"sky_jobs_base\"]:PresentOwnDocument(\"service\", recipientServerId)\n","lua","",[47,106,107],{"__ignoreMap":104},[108,109,112,116,120,123,126,129,133,135,138,142,145,147,150,152],"span",{"class":110,"line":111},"line",1,[108,113,115],{"class":114},"sMK4o","local",[108,117,119],{"class":118},"sTEyZ"," success, reason ",[108,121,122],{"class":114},"=",[108,124,125],{"class":118}," exports[",[108,127,128],{"class":114},"\"",[108,130,132],{"class":131},"sfazB","sky_jobs_base",[108,134,128],{"class":114},[108,136,137],{"class":118},"]:",[108,139,141],{"class":140},"s2Zo4","PresentOwnDocument",[108,143,144],{"class":118},"(",[108,146,128],{"class":114},[108,148,149],{"class":131},"service",[108,151,128],{"class":114},[108,153,154],{"class":118},", recipientServerId)\n",[15,156,157,158,161],{},"The radial also exposes these actions under ",[19,159,160],{},"Player interactions → Documents",".\nThis presents a document; it does not transfer an inventory item.",[10,163,165],{"id":164},"position-size-and-optional-branding","Position, size and optional branding",[15,167,168,169,172,173,176,177,180,181,183,184,187],{},"In ",[47,170,171],{},"/jobconfig",", choose ",[19,174,175],{},"Jobs Base → Player interactions → Identity card",".\nSaved configurator values take precedence over file defaults.\nIf ",[47,178,179],{},"Config.UseIngameConfigurator"," is disabled, edit ",[47,182,49],{}," in\n",[47,185,186],{},"sky_jobs_base/config/config.lua"," instead.",[189,190,191,204],"table",{},[192,193,194],"thead",{},[195,196,197,201],"tr",{},[198,199,200],"th",{},"Setting",[198,202,203],{},"Values and behaviour",[205,206,207,226,241,266,281,295,305,323],"tbody",{},[195,208,209,215],{},[210,211,212],"td",{},[47,213,214],{},"enabled",[210,216,217,218,221,222,225],{},"Master switch for Sky's document actions and exports; default ",[47,219,220],{},"true",". Set ",[47,223,224],{},"false"," when another resource owns your documents.",[195,227,228,233],{},[210,229,230],{},[47,231,232],{},"serviceEnabled",[210,234,235,236,221,238,240],{},"Service-card and service-number management switch; default ",[47,237,220],{},[47,239,224],{}," to keep identity/licenses while disabling service IDs.",[195,242,243,248],{},[210,244,245],{},[47,246,247],{},"position",[210,249,250,75,253,75,256,29,259,262,263,265],{},[47,251,252],{},"left",[47,254,255],{},"center",[47,257,258],{},"right",[47,260,261],{},"custom","; default ",[47,264,258],{},".",[195,267,268,276],{},[210,269,270,75,273],{},[47,271,272],{},"x",[47,274,275],{},"y",[210,277,278,279,265],{},"Card centre in screen percentages, 0–100; used for ",[47,280,261],{},[195,282,283,288],{},[210,284,285],{},[47,286,287],{},"scale",[210,289,290,291,294],{},"Size in percent, 50–150; default ",[47,292,293],{},"85",". It also fits smaller viewports.",[195,296,297,302],{},[210,298,299],{},[47,300,301],{},"issuer",[210,303,304],{},"Optional issuer name. Empty by default.",[195,306,307,312],{},[210,308,309],{},[47,310,311],{},"logo",[210,313,314,315,318,319,322],{},"Optional filename inside ",[47,316,317],{},"config/documents",", such as ",[47,320,321],{},"logo.svg",". Empty by default.",[195,324,325,330],{},[210,326,327],{},[47,328,329],{},"licenseTypes",[210,331,332,333,75,336,75,339,75,342,75,345,75,348,75,351,354,355,358],{},"Exact license type IDs visible on Sky's license card. Default: ",[47,334,335],{},"dmv",[47,337,338],{},"drive",[47,340,341],{},"drive_bike",[47,343,344],{},"drive_truck",[47,346,347],{},"driver",[47,349,350],{},"weapon",[47,352,353],{},"business",". Use ",[47,356,357],{},"{ \"*\" }"," for all held types; an empty list hides all.",[15,360,361,362,364],{},"Logo filenames cannot be URLs or directory paths. Use letters, numbers, hyphens or underscores\nfollowed by a file extension. No Sky logo, watermark or issuer text appears by default.\nLive configuration changes update an open shared card without changing its person or focus.\nDisabling a feature closes its open card and removes the related radial/target actions.\nThe server rejects disabled document requests and presentation offers. Independent external\nresources retain their own interfaces and actions.\nReopen the card after changing ",[47,363,329],{},". Filtering never grants or removes licenses,\nand does not change an external provider's own card contents.",[10,366,368],{"id":367},"editable-appearance","Editable appearance",[189,370,371,381],{},[192,372,373],{},[195,374,375,378],{},[198,376,377],{},"File",[198,379,380],{},"Purpose",[205,382,383,397,407],{},[195,384,385,390],{},[210,386,387],{},[47,388,389],{},"config/documents/identity.css",[210,391,392,393,396],{},"Both layouts, printed colours, typography, spacing and template dimensions. Use ",[47,394,395],{},".sky-license-card"," for license-specific changes.",[195,398,399,404],{},[210,400,401],{},[47,402,403],{},"config/documents/logo.svg",[210,405,406],{},"Replace the artwork, or add another local logo file and select it in configuration.",[195,408,409,414],{},[210,410,411],{},[47,412,413],{},"config/locales/\u003Clanguage>.lua",[210,415,416,417,265],{},"Card titles and field labels under ",[47,418,419],{},"Nui.playerActions",[15,421,422],{},"Editable CSS loads from the resource after the built-in default stylesheet.\nAfter changing CSS, fonts, artwork or locales, restart Jobs Base and its active dependent jobs\nthrough your normal update process. CSS and artwork changes need no frontend rebuild.\nChanging the Vue component's markup does require a frontend rebuild.",[15,424,425,426,431],{},"The client ",[427,428,430],"a",{"href":429},"/docs/base/jobs-base/client-exports/documents","document exports"," support own views,\nauthorized target inspection and showing your own document to one selected nearby player.",[10,433,435],{"id":434},"service-ids","Service IDs",[15,437,438,439,443],{},"See ",[427,440,442],{"href":441},"./service-ids-and-numbers","Service IDs and Numbers"," for department templates, persistent numbers, Boss Menu assignment, Creator jobs and database installation.",[15,445,446],{},[108,447],{"id":448},"number-persistence-and-installation",[450,451,452],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":104,"searchDepth":111,"depth":454,"links":455},2,[456,457,458,459,460,461],{"id":12,"depth":454,"text":13},{"id":53,"depth":454,"text":54},{"id":90,"depth":454,"text":91},{"id":164,"depth":454,"text":165},{"id":367,"depth":454,"text":368},{"id":434,"depth":454,"text":435},"View identity, license and service cards, customize their appearance, and configure department service numbers.","md",null,{},{"icon":467},"i-lucide-id-card","/docs/base/jobs-base/features/player-documents",{"title":5,"description":462},{"loc":468},"1.docs/base/2.jobs-base/2.features/5.player-documents","PHeA03-M37UTFL9rrR2hjUMOASQR3YO5AncgpV4Vtng",[474,480],{"title":475,"path":476,"stem":477,"description":478,"icon":479,"children":-1},"File Explorer and Shared Documents","/docs/base/jobs-base/features/file-explorer-and-shared-documents","1.docs/base/2.jobs-base/2.features/4.file-explorer-and-shared-documents","Browse job records, print saved documents, and manage document access across installed Sky jobs.","i-lucide-folder-open",{"title":481,"path":482,"stem":483,"description":484,"children":-1},"Radial and Player Interactions","/docs/base/jobs-base/features/radial-and-player-interactions","1.docs/base/2.jobs-base/2.features/6.radial-and-player-interactions","Configure the shared radial, natural player targeting and authorized restraint/document workflows.",[],1792936620029]