Skip to main content

CharacterAppearance

type CharacterAppearance = {
  components?: Record<number, PedComponent>;
  eyeColor?: number;
  faceFeatures?: number[];
  hairColor?: {
     color: number;
     highlight: number;
  };
  headBlend?: HeadBlend;
  headOverlays?: Record<number, HeadOverlay>;
  model: string;
  props?: Record<number, PedProp>;
};

Defined in: src/modules/core/characters/types.ts:109

Complete character appearance data (computed at runtime). Includes model, components, props, and freemode-specific customization. This is the full appearance applied to the ped, combining base + equipment.

Properties

PropertyTypeDescriptionDefined in
components?Record<number, PedComponent>Ped components indexed by component ID (0-11)src/modules/core/characters/types.ts:114
eyeColor?numberEye colorsrc/modules/core/characters/types.ts:135
faceFeatures?number[]Face features for freemode characters (array of 20 values, -1.0 to 1.0)src/modules/core/characters/types.ts:123
hairColor?{ color: number; highlight: number; }Hair color (primary and highlight)src/modules/core/characters/types.ts:129
hairColor.colornumber-src/modules/core/characters/types.ts:130
hairColor.highlightnumber-src/modules/core/characters/types.ts:131
headBlend?HeadBlendHead blend for freemode characterssrc/modules/core/characters/types.ts:120
headOverlays?Record<number, HeadOverlay>Head overlays indexed by overlay ID (0-12)src/modules/core/characters/types.ts:126
modelstringModel hash or model name (e.g., "mp_m_freemode_01")src/modules/core/characters/types.ts:111
props?Record<number, PedProp>Ped props indexed by prop ID (0, 1, 2, 6, 7)src/modules/core/characters/types.ts:117