feat: Implement custom/existing NPC appearance system by MaxtorCoder · Pull Request #76 · KaBooMa/S1API

MaxtorCoder · 2025-04-30T12:34:46Z

Implement custom NPC appearance system, also assign existing appearances to already existing NPCs.

Example Usage

Setting pre-defined customizations

public class TestNpc : NPC
{
    public TestNpc() : base("test_npc", "Test", "Npc")
    {
        Appearance.Set<HairStyle>(HairStyle.Afro)
            .Set<HairColor>(0xFF00315C)
            .WithFaceLayer<FacialHair>(FacialHair.Goatee, 0xFF000000)
            .WithFaceLayer<Eyes>(Eyes.EyeShadow, 0xC8000000)
            .WithAccessoryLayer<Head>(Head.BucketHat, 0xFF32C02C);

    }
}

NOTE: Color fields are either Hexadecimal codes (0xAARRGGBB) or Color type from UnityEngine

Random customization:

public class TestNpc : NPC
{
    public TestNpc() : base("test_npc", "Test", "Npc")
    {
        Appearance.GenerateRandomAppearance();
    }
}

Customization Fields (`Set<T>`)

EyeballTint (color field)
EyebrowRestingAngle (float field 0 - 1)
EyebrowRestingHeight (float field 0 - 1)
EyebrowScale (float field 0 - 1)
EyebrowThickness (float field 0 - 1)
EyeLidRestingStateLeft (float field 0 - 1)
EyeLidRestingStateRight (float field 0 - 1)
Gender (float field 0 - 1)
HairColor (color field)
HairStyle
Height (float field 0.8 - 1.2)
PupilDilation (float field 0 - 1)
SkinColor (color field)
Weight (float field 0 - 1)

Body Layer Fields (`WithBodyLayer<T>`)

Pants
Shirt

Face Layer Fields (`WithFaceLayer<T>`)

Eyes
Face
FacialHair

Accessory Fields (`WithAccessoryLayer<T>`)

Bottom
Chest
Feet
Hands
Head
Neck
Waist

MaxtorCoder added 2 commits April 30, 2025 14:24

feat: Implement custom/existing NPC appearance system

6551aa0

fix: Correct NPC name behaviour for gameobject

794457f

KaBooMa merged commit 63b8510 into KaBooMa:bleeding-edge May 2, 2025
1 check failed

MaxtorCoder deleted the npc-appearance branch May 2, 2025 14:49

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Implement custom/existing NPC appearance system#76

feat: Implement custom/existing NPC appearance system#76
KaBooMa merged 2 commits intoKaBooMa:bleeding-edgefrom
MaxtorCoder:npc-appearance

MaxtorCoder commented Apr 30, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

MaxtorCoder commented Apr 30, 2025

Example Usage

Customization Fields (Set<T>)

Body Layer Fields (WithBodyLayer<T>)

Face Layer Fields (WithFaceLayer<T>)

Accessory Fields (WithAccessoryLayer<T>)

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Customization Fields (`Set<T>`)

Body Layer Fields (`WithBodyLayer<T>`)

Face Layer Fields (`WithFaceLayer<T>`)

Accessory Fields (`WithAccessoryLayer<T>`)