Thank you so much for working on this. It has been my top 1 most anticipated feature and you are making it happen!
Would it be possible to add the scan's selected portrait to the npcs as soon as we enter battle? I think that would be cool.
I want to rename all images from the MGQ pack (and possibly other packs afterwards) to fit your criteria but Im not quite sure how.
I took a look at info.txt as well as the code in constructor.gd (Im no programmer) and I cant figure out which tags/filters would work for Hair Color. Perhaps "BlondHair" would do? About races, would a HalfkinCat filter work? Does your mod differentiate between Beastkin and Halfkin? Is it even worth to differentiate them?
And also it seems you dont have Eye color scans?
I dont know how well the weighting logic performs, I havent fully tested yet since Im waiting for your reply to rename the images I have.
Even if its pretty accurate you might want to check my version of what the scan's logic should be(I had thought about this before you started working on this mod)(link here). Its much simpler but it hopefully opens your mind to some kind of improvement over your current logic.
Also just a thought, hypothetically in the future if we have like 2Gb of portraits wouldnt it be much better to scan specific folders? I think that would be easily achievable If all images were organized by this folder structure:"Portraits\Sex\Race\" (example:"Portraits\Female\Harpy\"). That way most images would be excluded from the scans which should result in much faster scanning and might even prevent lag or even crashes on low-end pc's.