[{"data":1,"prerenderedAt":232},["ShallowReactive",2],{"guide:shadowrun:en":3},{"id":4,"title":5,"body":6,"confidence":171,"dataGaps":172,"description":159,"extension":173,"faq":174,"gameId":190,"installPaths":191,"lastReviewed":208,"meta":209,"navigation":210,"path":211,"requiresMod":172,"seo":212,"slug":215,"sources":216,"stem":229,"summary":230,"__hash__":231},"guides\u002Fguides\u002Fshadowrun.md","Shadowrun Returns \u002F Dragonfall \u002F Hong Kong Custom Portraits",{"type":7,"value":8,"toc":158},"minimark",[9,14,27,37,41,90,94,97,120,124,129,132,136,139,143],[10,11,13],"h2",{"id":12},"before-you-start","Before you start",[15,16,17,18,22,23,26],"p",{},"The Shadowrun trilogy — Returns, Dragonfall: Director's Cut, and Hong Kong — is developed by ",[19,20,21],"strong",{},"Harebrained Schemes",". All three games use 212×278 PNG portraits stored inside the game's ",[19,24,25],{},"installation folder"," under a StreamingAssets path, not in Documents.",[15,28,29,32,33,36],{},[19,30,31],{},"Key caveat:"," a \"free name\" portrait only works if you ",[19,34,35],{},"replace an existing portrait"," using its exact original file name. To add a brand-new portrait slot requires the Shadowrun Returns Editor or hex-editing the content pack.",[10,38,40],{"id":39},"step-by-step-installation-replace-method","Step-by-step installation (replace method)",[42,43,44,52,55,63,66,73,81,84,87],"ol",{},[45,46,47,48,51],"li",{},"Open PortraitCrafter and select ",[19,49,50],{},"Shadowrun Returns \u002F Dragonfall \u002F HK"," from the catalog.",[45,53,54],{},"Upload your image. The editor crops to 212×278.",[45,56,57,58,62],{},"Export the file. You get a ",[59,60,61],"code",{},"\u003Cname>.png"," (212×278).",[45,64,65],{},"Navigate to the portraits folder for the game you want to modify (see install paths above).",[45,67,68,69,72],{},"Identify an existing portrait file to replace (for example ",[59,70,71],{},"pc_humanmale_1.png",").",[45,74,75,78,79,72],{},[19,76,77],{},"Rename your exported PNG"," to match that file name exactly (e.g. ",[59,80,71],{},[45,82,83],{},"Back up the original file if you want to restore it later.",[45,85,86],{},"Overwrite the original file with your renamed portrait.",[45,88,89],{},"Launch the game. Your image now appears in place of the replaced portrait.",[10,91,93],{"id":92},"adding-a-new-portrait-slot-advanced","Adding a new portrait slot (advanced)",[15,95,96],{},"To add a new portrait without replacing an existing one:",[42,98,99,106,113],{},[45,100,101,102,105],{},"Install the ",[19,103,104],{},"Shadowrun Returns Editor"," (available on Steam as a free tool for Shadowrun Returns owners).",[45,107,108,109,112],{},"In the editor, create a new content pack and add a portrait entry with a file name matching the ",[59,110,111],{},"pc_\u003Cracegender>_\u003CN>"," pattern (start N at 11 to avoid collisions with defaults).",[45,114,115,116,119],{},"Alternatively, a hex editor can modify the content pack ",[59,117,118],{},".pl"," file to add new portrait references.",[10,121,123],{"id":122},"troubleshooting","Troubleshooting",[125,126,128],"h3",{"id":127},"the-custom-portrait-does-not-appear-in-the-game","The custom portrait does not appear in the game",[15,130,131],{},"Confirm the file name matches exactly an existing portrait file (case-sensitive on macOS\u002FLinux). Also verify the PNG is placed in the correct game-specific folder — the three games do not share portrait paths.",[125,133,135],{"id":134},"the-image-looks-stretched-or-distorted","The image looks stretched or distorted",[15,137,138],{},"The portrait must be exactly 212×278. Verify dimensions with an image viewer before placing the file.",[125,140,142],{"id":141},"macos-cannot-navigate-to-the-portraits-folder","macOS: cannot navigate to the portraits folder",[15,144,145,146,149,150,153,154,157],{},"Right-click the game's ",[59,147,148],{},".app"," file in Finder and choose ",[19,151,152],{},"Show Package Contents",". The portraits folder is at ",[59,155,156],{},"Contents\u002FData\u002FStreamingAssets\u002FContentPacks\u002F\u003Cpack>\u002Fart\u002Fportraits\u002F",".",{"title":159,"searchDepth":160,"depth":160,"links":161},"",3,[162,164,165,166],{"id":12,"depth":163,"text":13},2,{"id":39,"depth":163,"text":40},{"id":92,"depth":163,"text":93},{"id":122,"depth":163,"text":123,"children":167},[168,169,170],{"id":127,"depth":160,"text":128},{"id":134,"depth":160,"text":135},{"id":141,"depth":160,"text":142},"high",null,"md",[175,178,181,184,187],{"question":176,"answer":177},"Who made the Shadowrun trilogy?","Harebrained Schemes (not 'Hairbrained'). The studio is Harebrained Schemes, a frequent source of misspelling in community guides.",{"question":179,"answer":180},"Can I add a truly new portrait or do I have to replace one?","Replacing an existing portrait by its exact file name is the simple method. To add a genuinely new portrait without overwriting anything you need the Shadowrun Returns Editor or hex-editing the content pack data with a pattern of pc_\u003Cracegender>_\u003Cnumber> starting from 11.",{"question":182,"answer":183},"What naming pattern do existing portrait files use?","Files follow the pattern pc_\u003Cracegender>_\u003Cnumber>.png, for example pc_humanmale_1.png, pc_humanfemale_3.png. To replace one, overwrite its file keeping the exact name.",{"question":185,"answer":186},"Are the three games' portrait files in the same folder?","No. Each game has its own data folder (Shadowrun_Data \u002F Dragonfall_Data \u002F SRHK_Data) and its own content pack name (shadowrun_returns \u002F DragonfallExtended \u002F HongKong). The paths are separate.",{"question":188,"answer":189},"Does the portrait need to be exactly 212×278?","Yes. All three games use 212×278 PNG portraits. PortraitCrafter exports the correct dimensions.","shadowrun",[192,196,200,204],{"platform":193,"path":194,"notes":195},"Windows — Shadowrun Returns (Steam)","\u003CSteam>\\steamapps\\common\\Shadowrun Returns\\Shadowrun_Data\\StreamingAssets\\ContentPacks\\shadowrun_returns\\art\\portraits\\","Replace an existing portrait file (e.g. pc_humanmale_1.png) with your 212×278 PNG keeping the exact same file name.",{"platform":197,"path":198,"notes":199},"Windows — Dragonfall DC (Steam)","\u003CSteam>\\steamapps\\common\\Shadowrun Dragonfall - Director's Cut\\Dragonfall_Data\\StreamingAssets\\ContentPacks\\DragonfallExtended\\art\\portraits\\","Note: Dragonfall_Data and DragonfallExtended pack name.",{"platform":201,"path":202,"notes":203},"Windows — Hong Kong (Steam)","\u003CSteam>\\steamapps\\common\\Shadowrun Hong Kong - Extended Edition\\SRHK_Data\\StreamingAssets\\ContentPacks\\HongKong\\art\\portraits\\","Note: SRHK_Data and HongKong pack name.",{"platform":205,"path":206,"notes":207},"macOS (any title)","\u003CTitle>.app\u002FContents\u002FData\u002FStreamingAssets\u002FContentPacks\u002F\u003Cpack>\u002Fart\u002Fportraits\u002F","Right-click the .app and choose 'Show Package Contents' to navigate inside the bundle.","2026-06-17",{},true,"\u002Fguides\u002Fshadowrun",{"metaDescription":213,"primaryKeyword":214,"title":5,"description":159},"How to install custom portraits in Shadowrun Returns, Dragonfall DC, and Hong Kong: 212×278 PNG inside the installation StreamingAssets folder, replace vs add new portraits, and macOS notes.","shadowrun returns dragonfall hong kong custom portrait png install harebrained","shadowrun-trilogy",[217,221,225],{"url":218,"title":219,"type":220,"consultedOn":208},"https:\u002F\u002Fsteamcommunity.com\u002Fsharedfiles\u002Ffiledetails\u002F?id=1648857745","Custom portraits guide — Steam Community (Shadowrun trilogy)","steam",{"url":222,"title":223,"type":224,"consultedOn":208},"https:\u002F\u002Fstore.steampowered.com\u002Fapp\u002F234650\u002FShadowrun_Returns\u002F","Shadowrun Returns — Steam store page (developer: Harebrained Schemes)","official",{"url":226,"title":227,"type":228,"consultedOn":208},"https:\u002F\u002Fwww.nexusmods.com\u002Fshadowrunreturns\u002Fmods\u002F18","Custom portrait replacement guide — Nexus Mods","nexus","guides\u002Fshadowrun","The Shadowrun trilogy (Harebrained Schemes) uses 212×278 PNG portraits stored inside each game's installation folder — not in Documents. Adding a truly new portrait (not replacing an existing one) requires using the official editor or hex-editing the content pack. Replacing an existing portrait by its exact file name is the straightforward method.","THrXgGJaMCD3NKKWqoTG-2T43_NJlwEg_rJwYLqU_3o",1795033343119]