character-creator-shared

Shared runtime for the Odyssey character creator. Two modules:

• RigUtils — applies a CharacterData table to a Roblox rig. Strips default avatar accessories + face decal, scales the body for R6 / R15, attaches face decals (handles folder-of-decals layouts like Eyes1/EyeColor + EyeWhites + Eyes), welds hair Accessories with manual attachment alignment for custom rigs missing the standard HatAttachment, recolours skin / eyes / brows, and applies the chosen swatch + lightness Tone.
• Config — palettes, ranges, and birthplace/horse mapping the start-place creator and the main-game spawn flow both read from. Asset names themselves are NOT in here; they're discovered at runtime from ReplicatedStorage.CharacterAssets.

Usage

After wally install the package lands at ReplicatedStorage.Packages.CharacterCreator:

local CharacterCreator = require(ReplicatedStorage.Packages.CharacterCreator)
CharacterCreator.RigUtils.applyAll(character, profile.Data.CharacterData)

Or require either submodule directly:

local RigUtils = require(ReplicatedStorage.Packages.CharacterCreator.RigUtils)

Required runtime instances

RigUtils looks up asset templates at one of:

• ReplicatedStorage.CharacterAssets
• ReplicatedStorage.Assets.CharacterAssets

The folder must contain whatever subfolders Config.AssetFolders names (default: Eyes, Eyebrows, Noses, Mouths, Hairs/<Sex>, optionally Accessories and a Face MeshPart).

Versioning

Bumped manually in wally.toml. Follow semver: bump the patch on bug fixes, the minor on new optional CharacterData fields, the major on saved-data shape changes that would invalidate existing profiles.