Bodyparts, Species - Alexofp/BDCC GitHub Wiki

Just a heads up, the system of adding new bodyparts will probably be simplified quite a bit in the future. I have some ideas how to make it way easier but it would take quite some time. So for now this will have to do.

Adding new bodypart

Probably the easiest bodypart type to start with is hair. So let's add some hair

The easiest and the best way of doing so is copying one of the existing hairs and just changing the texture. That’s the best way to add any new bodypart too unless you wanna mess with create a custom mesh in blender. But if you need to do so - look at the DollSkeleton.blend file inside the AssetsSource/character folder, it has all the current meshes and animations. But if you just wanna swap the texture, this tutorial is for you.

Open the game in the godot editor. Navigate to the Player/Player3D/Parts/Hair folder. Duplicate one of the folders and rename it to whatever you want. I will just duplicate PonytailHair and name it RedPonytailHair

Expand it and change the scene name too. Png file can have whatever name.

Now you can draw the new hair, using the old one as the base if you want. I just tinted the texture red outside of godot.

Double click the .tscn file. If you switch to the 3d view you will see that the hair is still using the old texture. That’s because the mesh’s material is still from the old hair. When you duplicate the scene, the materials DON’T get duplicated, they are shared, keep that in mind.

So you gotta make the material ‘unique’ first. To do so click on the mesh, open the materials tab, right click the material and press ‘make unique’

Now open the material by clicking on it. Then find the Albedo section and drag your texture onto the texture field. You should see your hair in 3d viewport now.

That’s it on the model side. You still gotta ‘define’ it as hair for the game. To do so navigate to the Player/Bodyparts/Hair folder and duplicate one of the hair definition files.

Now double click on it. It would look something like this.

id must be unique, I will change it to redponytailhair . I will also change the visible name to ‘red ponytail’ and change the getDoll3DScene() return string to point to the scene file we created before. It should look like this.

extends BodypartHair

func _init():
	visibleName = "red ponytail"
	id = "redponytailhair"

func getDoll3DScene():
	return "res://Player/Player3D/Parts/Hair/RedPonytailHair/RedPonytailHair.tscn"

Now you should be able to just run the game and see that the new hair has appeared in the character creator.

If it did - good. Now you can follow the steps from other tutorials to create a new module and then create a mod. Don’t forget to change the getDoll3DScene() function to point at the new location when moving files.

Here is an example mod that adds the red ponytail.

RedHairTestMod.zip

Adding other types of bodyparts is very similar, just duplicate one of the existing ones, change the texture and assign the new material. Sometimes the scene will contain more than one mesh so you will have to change many materials. Same process though.

Bodyparts can have other functions too.

extends BodypartTail

func _init():
	visibleName = "short tail"
	id = "shorttail"

func getCompatibleSpecies():
	return [Species.Canine, Species.Wolf, Species.Feline, Species.Equine]

func getLewdSizeAdjective():
	return RNG.pick(["short"])

func getLewdAdjective():
	return RNG.pick(["fluffy"])

func getDoll3DScene():
	return "res://Player/Player3D/Parts/Tail/ShortTail/ShortTail.tscn"

getCompatibleSpecies() describes which species are allowed to use this bodypart. You can add a Species.Any in that list to allow any species to use it.

Adding a new species

To add a new species, go into the Species folder and duplicate one of the existing ones. Open it and change the id to a unique one. Using a string there is okay, mods are unable to have globally defined constants.

Then change the visible name and visible description functions, their result is shown in the character creator/in-game. Can also change the default bodyparts, they are applied when the species is first selected in the character creator.

If you did that you might have noticed that you can’t pick most of the bodyparts. For example, how can we allow a short tail for our new species? Easy, just add a function

func getAllowedBodyparts():
	return ["shorttail"]

This function basically allows this species to use these bodyparts.

That should be it. Now you can make it into a mod the same way as other times, by creating a module and making a zip archive out of it. You don’t -have- to make a module but they help organize and group mod files together in one folder, very useful.