You can support me on Patreon:

This is a library for adding new player models. Players can choose a model they want in the character-creation window. All players will see the model they choose. This mod is required both on client and server.

To add your own model to be used with this library, make a content mod that depends on this library. Make the model, skin parts, textures. Then create 'config' folder inside your domain folder, and in it create 'customplayermodels' folder. Add json file with configuration of your model to this folder as it is done in example mods (comming soon).

If you want your shape skin parts to be recolored by texture skin parts, they have to use you main model texture.

For each model use its own main texture.

You can add a list of classes that a specific model can choose, so it is possible to make a races mod with different classes for each model. If you specify no classes, all classes will be available for this model.

You can add a list of classes that won't be available for your model.

You can add a list of additional traits that player will have on top of class traits.

You can specify new clothing/armor models to be used with your model, but these models should use the same textures as the original models.

The library will automatically add all missing animation from seraph model (include moded), so you only need to make animations you want to replace. But if your model is too different from seraph model you might want to rework all animations.

Also, automatically add missing attachment points from vanilla seraph model. But for that to work, you should have same names for shape elements in your custom model as in the vanilla one.

If CollisionBox is specified, player collision box will be changed to specified values. Default vanilla values are [0.6,1.85].

If EyeHeight is specified, it will be used instead of the vanilla value of 1.7.

Example of model configuration file:

{
	"kobold": {
		"ShapePath": "kobold:entity/humanoid/seraph-faceless",
		"MainTextureCode": "seraph",
		"AvailableClasses": ["commoner", "hunter"],
		"SkipClasses": ["commoner"],
		"ExtraTraits": ["precise"],
		"CollisionBox": [ 0.6, 1.85 ],
		"EyeHeight": 1.7,
		"WearableModelReplacers": {
			"game:armor-legs-plate-*": "kobold:entity/humanoid/seraph/armor/plate/legs"
		},
		"WearableModelReplacersByShape": {
			"game:entity/humanoid/seraph/armor/plate/legs": "kobold:entity/humanoid/seraph/armor/plate/legs"
		},
                "SkinnableParts": [
			{
				"code": "baseskin",
				"type": "texture", 
				"variants": [
					{ "code": "skin1", "texture": "kobold:entity/humanoid/seraphskinparts/body/skin1" },
					{ "code": "skin2", "texture": "kobold:entity/humanoid/seraphskinparts/body/skin2" },
					{ "code": "skin3", "texture": "kobold:entity/humanoid/seraphskinparts/body/skin3" },
					{ "code": "skin4", "texture": "kobold:entity/humanoid/seraphskinparts/body/skin4" },
					{ "code": "skin5", "texture": "kobold:entity/humanoid/seraphskinparts/body/skin5" }
				]
			}
		]
	}
}

If you want to make your models be compatible with vanilla and modded animations there are two ways you can choose:

1) You can make your model key body parts to be exactly the same size and position (also names) as seraph model.

For standard animation you want torso and arms to be the same for the majority of animations to be more compatible in first person

Also for standard animations you want also legs and neck to be the same for third person animations

For Combat Overhaul animations torso and arms is sufficient both for fp and tp

2) You can replace animations with your own.

For standard animation you just add them to your model shape file with same codes as ones you want to replace. All missing animations will be added from seraph shape

For Combat Overhaul you want to add your own animations with your model code at the end of animation name. Ask me in discord for more details.

Also make sure to add attachment points required by other mods such is Overhaul lib or Carry On.

If you want to add new clothes/armor models outside of model mod you dont need to patch anything, just put a file named 'model-replacements-bycode.json' in config folder in your assets and specify in it the models like that. First specfiy model code with its domain, then items and models to replace with.

{
  "kobold:kobold": {
    "game:armor-legs-plate-*": "kobold:entity/humanoid/seraph/armor/plate/legs"
  } 
}

You can also specify wearable shape to replace, instead of wearable item code in 'model-replacements-byshape.json' file

{
  "kobold:kobold": {
    "game:entity/humanoid/seraph/armor/plate/legs": "kobold:entity/humanoid/seraph/armor/plate/legs"
  } 
}

Some of the mods that use this library:

• Female Seraph