[{"data":1,"prerenderedAt":201},["ShallowReactive",2],{"guide:arcanum:en":3},{"id":4,"title":5,"body":6,"confidence":148,"dataGaps":149,"description":137,"extension":151,"faq":152,"gameId":165,"installPaths":166,"lastReviewed":175,"meta":176,"navigation":177,"path":178,"requiresMod":179,"seo":180,"slug":165,"sources":183,"stem":198,"summary":199,"__hash__":200},"guides\u002Fguides\u002Farcanum.md","Arcanum Custom Portraits",{"type":7,"value":8,"toc":136},"minimark",[9,14,18,48,55,59,98,102,107,110,114,123,127],[10,11,13],"h2",{"id":12},"before-you-start","Before you start",[15,16,17],"p",{},"Arcanum is one of the more technical engines. Two things matter most:",[19,20,21,33],"ul",{},[22,23,24,28,29,32],"li",{},[25,26,27],"strong",{},"Color depth:"," both BMP files must be ",[25,30,31],{},"8-bit indexed"," (256-color palette). A 24-bit BMP is rejected silently and shows up as missing.",[22,34,35,38,39,43,44,47],{},[25,36,37],{},"Registration:"," each portrait is listed in ",[40,41,42],"code",{},"portraits.mes"," (or a ",[40,45,46],{},"userport.mes"," override) that maps an ID to a file base name.",[15,49,50,51,54],{},"PortraitCrafter exports both the big and small BMP as 8-bit indexed for you, so the format is handled. You still register the entry in the ",[40,52,53],{},".mes"," index yourself.",[10,56,58],{"id":57},"step-by-step-installation","Step-by-step installation",[60,61,62,69,72,83,86,95],"ol",{},[22,63,64,65,68],{},"Open PortraitCrafter and select ",[25,66,67],{},"Arcanum"," from the catalog.",[22,70,71],{},"Upload your image and crop or fit it. The editor produces the big and small 8-bit BMP files.",[22,73,74,75,78,79,82],{},"Enter a base name (for example ",[40,76,77],{},"HUM5","). The export adds the ",[40,80,81],{},"_b"," suffix to the big file.",[22,84,85],{},"Download the BMP files and copy them into the game's portrait folder.",[22,87,88,89,91,92,94],{},"Open ",[40,90,42],{}," (or create a ",[40,93,46],{}," override) and add an entry mapping a free ID to your base name.",[22,96,97],{},"Launch the game; the new portrait appears in the selection list for the matching race and gender.",[10,99,101],{"id":100},"troubleshooting","Troubleshooting",[103,104,106],"h3",{"id":105},"the-portrait-is-black-or-does-not-load","The portrait is black or does not load",[15,108,109],{},"The BMP is almost certainly 24-bit. Re-export from PortraitCrafter, which writes 8-bit indexed BMP files that the engine accepts.",[103,111,113],{"id":112},"the-portrait-never-shows-in-the-list","The portrait never shows in the list",[15,115,116,117,119,120,122],{},"It is not registered. Confirm you added the entry to ",[40,118,42],{},"\u002F",[40,121,46],{}," and that the file base name matches exactly.",[103,124,126],{"id":125},"the-big-and-small-images-are-swapped","The big and small images are swapped",[15,128,129,130,132,133,135],{},"The big image uses the ",[40,131,81],{}," suffix; the small image uses the plain base name. Double-check the file names against your ",[40,134,53],{}," entry.",{"title":137,"searchDepth":138,"depth":138,"links":139},"",3,[140,142,143],{"id":12,"depth":141,"text":13},2,{"id":57,"depth":141,"text":58},{"id":100,"depth":141,"text":101,"children":144},[145,146,147],{"id":105,"depth":138,"text":106},{"id":112,"depth":138,"text":113},{"id":125,"depth":138,"text":126},"high",[150],"Exact .mes ID ranges that are safe to use vary by version and mod; check your portraits.mes before assigning new IDs.","md",[153,156,159,162],{"question":154,"answer":155},"Why does Arcanum show a black or missing portrait?","Almost always because the BMP is 24-bit. Arcanum only accepts 8-bit indexed (256-color) BMP files. PortraitCrafter exports the correct 8-bit format, so re-export if you converted the image elsewhere.",{"question":157,"answer":158},"What files do I need per portrait?","A big file and a small file, both 8-bit BMP. The small file uses the base name; the big file adds the _b suffix (for example HUM5.bmp and HUM5_b.bmp).",{"question":160,"answer":161},"What is portraits.mes for?","It is the text index that maps a numeric portrait ID to a file base name. To add a portrait you register it there (or in a userport.mes override) so the game knows the slot exists.",{"question":163,"answer":164},"Can I just drop files in without editing portraits.mes?","No. Unlike newer games, Arcanum needs the portrait registered in the .mes index to appear in the selection list.","arcanum",[167,171],{"platform":168,"path":169,"notes":170},"Windows (Steam \u002F GOG)","\u003Cgame install folder>\\data\\portraits\\","Registration happens in data\\portraits.mes (or a userport.mes override) which maps an ID to the file base name.",{"platform":172,"path":173,"notes":174},"Linux \u002F Steam Deck (Proton)","...\u002Fsteamapps\u002Fcommon\u002FArcanum\u002FData\u002FPortrait\u002F","No native build; runs via Wine\u002FProton. Does not use Documents or AppData.","2026-06-17",{},true,"\u002Fguides\u002Farcanum",null,{"metaDescription":181,"primaryKeyword":182,"title":5,"description":137},"How to install custom portraits in Arcanum: the 8-bit indexed BMP requirement, the big\u002Fsmall file naming, and how portraits.mes registers each portrait.","arcanum custom portrait bmp 8-bit",[184,188,191,194],{"url":185,"title":186,"type":187,"consultedOn":175},"https:\u002F\u002Fterra-arcanum.com\u002Fsierra\u002Fgame\u002Ffaq_page02.html","Arcanum FAQ (portraits) — Terra Arcanum","wiki",{"url":189,"title":190,"type":187,"consultedOn":175},"https:\u002F\u002Farcanumclub.org\u002Fsierra\u002Fgame\u002Ffaq_page02.html","Arcanum FAQ (portraits) — Arcanum Club",{"url":192,"title":193,"type":187,"consultedOn":175},"https:\u002F\u002Farcanum.fandom.com\u002Fwiki\u002FModding_Tips","Modding Tips — Arcanum Wiki",{"url":195,"title":196,"type":197,"consultedOn":175},"https:\u002F\u002Fsteamcommunity.com\u002Fapp\u002F500810\u002Fdiscussions\u002F0\u002F1746765743929380482\u002F","Custom portraits discussion — Steam Community","steam","guides\u002Farcanum","Arcanum needs a big and a small BMP per portrait, both 8-bit indexed (256 colors) — the engine silently rejects 24-bit BMP. Files go in the game's portrait folder and are registered through portraits.mes (or userport.mes). PortraitCrafter exports both BMP files as 8-bit indexed automatically.","K6uS1NoqbcPD7I3xzbMqV32B_YE4zMgoD82cqcp2gVQ",1795033343119]