Spongie's Character Customisation

Adds faces, freckles, scars, dynamic muscles, and more

This is primarily a mod framework that allows servers and other mods to add more variety to character appearances.

[hr]

SUPPORTS B42.20 STABLE - TESTED AND WORKS IN MULTIPLAYER

B41 VERSION HERE

[h1]COMMON ISSUES[/h1] [list] [*][h2]DISABLE LUA CHECKSUM IF YOU GET "FILE DOESN'T EXIST" ERROR[/h2] [*][h2]IF CRASHING ON WORLD CREATION RESUBSCRIBE TO THE MOD AND IF IT STILL HAPPENS THEN REMOVE THE MOD AND RE-ADD IT AFTER STARTING THE SAVE[/h2] [*]DO NOT USE THE VANILLA FACE PACK WITH OTHER RETEXTURES IT ONLY WORKS WITH THE DEFAULT TEXTURES [*]SET MAX TEXTURE SIZE IN SETTINGS TO WHATEVER PLAYER RETEXTURE YOU ARE USING OR YOU WILL HAVE SEAMS (VANILLA IS 256) [*]NEEDS TO BE LOADED AFTER ELLIE'S TATTOO PARLOR [*]ENABLING RETEXTURES THAT SUPPORT THIS MOD REQUIRES A GAME RESTART [*]IN MULTIPLAYER EVERY PLAYER NEEDS THE MOD + RETEXTURES ENABLED ON THE MAIN MENU OR TEXTURES WON'T BE REPLACED ON STARTUP [/list]

[hr]

Included modules

• Base mod - Framework, DOES NOT ADD ANY CUSTOMISATION OPTIONS.
• Vanilla Faces Pack - Adds 4 male and 4 female faces. Only supports the vanilla body textures [h1]DO NOT USE THIS WITH RETEXTURE MODS[/h1]
• Details Pack - Adds freckles, moles, scars, burns, and missing eyes.
• Missing eyes also affect the players vision cone.
• Details Pack HD Textures - 512x512 textures for the Details Pack.
• [h1]DO NOT USE THE HD TEXTURE PACK with vanilla textures or any retextures that are 256x256 or it will cause seams.[/h1]

[hr]

Fully supported mods

• [h2]Spongie's Character Retexture[/h2]
• [h2]Tomb's Player Body Overhaul[/h2]

[hr]

Faces and Details

Select from different faces and add additional detail textures to your character

Faces work on all skintones and new options can be added by other mods.

[hr]

Dynamic Muscles

Characters will have visible muscles at high strength levels

Muscle intensity increases at level 6 and level 9 strength (Stout and Strong traits in character creation).

Can be toggled globally or set to player preference in sandbox settings.

MUSCLE TEXTURES DO NOT WORK WITH UNSUPPORTED TEXTURE MODS LIKE SIMPLE CHARACTER RETEXTURE. TURN OFF MUSCLES IN SANDBOX IF YOU ARE USING ONE THAT DOESN'T SUPPORT THIS MOD

[hr]

Body Hair and stubble growth

Head stubble, beard stubble, and body hair (formerly chest hair) will grow in-game and can be shaved

The button to shave your stubble and body hair is in the character info panel.

Vanilla chest hair has been completely replaced with a new system that works on both body types.

Can be toggled globally or set to player preference in sandbox settings.

THIS MOD DOES NOT AFFECT VANILLA HAIR OR BEARD GROWTH EXCEPT RESETTING GROWTH WHEN SHAVING STUBBLE

[hr]

Works in existing saves and creating a new character mid-save

Joining a game with a character from before the mod was added will open the character customisation window so that you can pick faces and details.

Stubble and chest hair will be converted to the new system.

[hr]

Change Customisation In-Game

There is a sandbox option to allow players to open the customisation window and change their face or details in-game.

The buttons to change your appearance and shave are in the character info panel.

[hr]

Sandbox Options

• Options for changing appearance in-game, toggling muscles, and changing body hair growth
• Admins can always change their appearance or add body hair but they can spawn an Appearance Changing Spiffo to give this ability to any player when held
• Customisation options with certain tags can be hidden from normal players. Admins can spawn an Appearance Unlocking Bear to unhide these options for any player when held
• Body hair growth and visible muscles can be enabled or disabled or set to player preference
• You can change the vision modifier used by missing eyes

[hr]

Technical Details

See the readme and Example.lua to learn how you can make addons for the mod.

The body hair textures in the base mod will cut off at the underwear which won't look right when using a nude mod. I've included nude versions of the body hair textures in the files for other modders to use if they want to make their mod compatible.

The blood/dirt on the face and muscles are occasionally synced to the body's blood/dirt levels so there will always be a slight delay which I've never noticed during gameplay.

To reduce strain on the server, every few ticks the server will try to sync the blood of a single player until it goes through the list of active players. The tick delay adjusts based on the number of players and currently it will take around 200 ticks to finish checking every player once. This means that in singleplayer it will do a check every 200 ticks but in a 100 player server it would be doing a check every 2 ticks. Basically there is always a roughly 2 second delay for blood on a player's face or muscle to be updated.

[hr]

Incompatibilities

• Some clothing mods might cause transparency issues with customisation. This is caused by having a broken masks folder that is missing textures for bodyparts. To fix this you can copy the missing textures into the masks folder from media\textures\Body\Masks
• Mods affecting stubble or chest hair won't work (Ras' Body Mod, Reorganised Info Screen)