Understanding recolors

[andreas-volz]

Hi,

I've rough implemented support for the new recolor possibility. I understand the format in body.json

"recolors": {
"material": "body",
"palettes": [
"ulpc",
"lpcr",
"all.lpcr"
]
},

But I've problems to understand the logic from heads_human_male.json

"recolors": {
"color_1": {
"material": "body",
"palettes": [
"ulpc",
"lpcr",
"all.lpcr"
]
},
"color_2": {
"type_name": "eyes",
"label": "Eye Color",
"material": "eye",
"palettes": [
"ulpc",
"lpcr"
]
}

I don't get the meaning of the parameter "type_name": "eyes" in this context and when to apply the color here. Could you explain this?

[jrconway3]

If you check the overall sheet, type_name is there, too:

  ],
  "recolors": {
    "color_1": {
      "material": "body",
      "palettes": [
        "ulpc",
        "lpcr",
        "all.lpcr"
      ]
    },
    "color_2": {
      "type_name": "eyes",
      "label": "Eye Color",
      "material": "eye",
      "palettes": [
        "ulpc",
        "lpcr"
      ]
    }
  },
  "type_name": "head"

type_name just tells the script that only one of that asset can exist at a time. Its also used to match recolors if you switch to another asset.

For example, if you set a head asset with eyes, recolor set, if you then toggle another asset that has a secondary recolor with "eyes" as a type_name, it will color match by default. This even applies when switching to totally other assets.

Heads mostly have skintone + eyes. Faces also have skintone + eyes, so if you choose a head and eye color, then choose a custom face, the eye color on the new facial expression will match the eye color you chose on the head asset.

[andreas-volz]

Thanks for this explanation - I understand.

I searched and there's no color_3 in the complete data. But is this theoretical possible in this concept or does your concept limit to color_1 and color_2? So is there a reason why the assets with only one color not have always color_1 only instead of having the properties in the Json level above?

[jrconway3]

At this time its configured to support as many colors as needed. At some point I think we will likely have more than 2, I just haven't gotten to that point yet. There's still tons of recolors to map out.

[andreas-volz]

Ok I got recolor now working with all normal material palettes. I've just some problems with "all.lpcr" as the logic is not really straight forward as the others. For e.g. body.json it should replace all colors from ulpc/light palette with what ever palette from body_lpcr.json or body_ulpc.json.
It seems the "all.lpcr" is special and pulls all/all_lpcr.json into the game. But there in meta_all.json is base=white. So I'm confused which palette colors are the source palette in this case.
I search the sources where you pull all.lpcr but didn't find it.

[jrconway3]

Its based on whatever the first asset is in the recolor list, though some assets may have manual overrides.

The all.lpcr's default color is ONLY if the asset starts in LPC Revised to begin with. If the asset starts in ULPC, it follows the default ULPC color instead.

[andreas-volz]

Thank, I implemented some more cases and now found more special cases:

arms_hands_ring_stud.json

  "recolors": {
    "material": "cloth",
    "base": "teal",
    "palettes": [
      "ulpc",
      "metal.ulpc",
      "all.lpcr"
    ]
  },

I thought all.lpcr is a "special case" now with metal.ulpc I understand this mechanism.

or hair_pigtails.json

  "recolors": {
    "color_1": {
      "material": "hair",
      "palettes": [
        "ulpc",
        "lpcr",
        "all.lpcr"
      ]
    },
    "color_2": {
      "type_name": "hair_tie",
      "label": "Hair Tie",
      "material": "cloth",
      "base": null,
      "source": ["#180716", "#0E4E72", "#156c99", "#0098b2", "#00cfdf", "#ffffff"],
      "palettes": [
        "ulpc",
        "all.lpcr"
      ]
    }
  },

Everytime I think that I understood one data concept I find more special rules. :-(

Are those recolor case only historical and you plan to move this into the generic palette folder or is this a normal case?

[jrconway3]

I basically just added all.lpcr as an option for all assets. However, LPCR doesn't have a dedicated "cloth" color as far as I can tell so for clothing or fabric related assets, its just always any color when it comes to Revised color schmes.

The point of doing some first and not just all every time is so that the relevant colors show up first, before letting you do a fallback to everything. That's the standard Eliza uses and Vitruvian as well.