Models

_images/icon_models.webp

A 3D model in Blockbench.

File location

/assets/minecraft/optifine/cem/**/*.jem

CEM model files contain the definition of a whole entity model. It is written in JSON.

They may be located anywhere inside the cem folder. The name of the file must match one of the entity names in Entity names, or be in the folder /assets/minecraft/optifine/cem/<entity name>.

Keys

texture

Values: File path
Optional

Texture used by entity model.

textureSize

Values: Array of 2 integers
Optional

Texture size in pixels; [width, height].

shadowSize

Values: Decimal
Optional

Shadow size as a scale, from 0.0 to 1.0.

models

Values: List of objects
Required

Array of model objects that make up the entity's full model.

baseId

Values: String
Optional

Model parent ID. If specified, all parent properties are inherited and do not need to be explicitly put.

model

Values: File path
Optional

Path to a part model file (.jpm) from which to load the part model definition.

If this is not specified, the items in a JPM can be specified inline to this object, the parent of "model".

id

Values: String
Optional

Model ID, can be used to reference the model as parent.

part

Values: String
Required

Entity part to which the part model is attached.

See Entity names for a list of part names for each entity.

Important

Make sure that the part names correspond with your model's applicable entity.

attach

Values: Boolean
Optional

How to handle replacing overlapping parts.

  • True: Attach (add) to the entity part.

  • False: Replace the entity part.

scale

Values: Float
Optional
Default: 1.0

Render scale. 0.0 makes it "invisible".

Part model definitions

All of the items in a CEM parts file can be put here instead, if model is absent.

animations

Values: List of objects
Optional
Default: []

Refer to CEM animation for what to place in each object in this list.

Randomized models

The alternative models use the same name as the main model with a number suffix.

For example:

  • wolf.jem - main model (index 1)

  • wolf2.jem - alternative model (index 2)

  • wolf3.jem - alternative model (index 3)

The alternative models are selected randomly based on the entity ID.

To customize the use of the alternative models, add a <model_name>.properties file in the folder where the models are located.

The properties file works identically to the properties file used by Random Entities. The models to be used are selected with the setting models.<n>=<list> instead of textures.<n>=<list>. The index of the current matching rule is available as the animation parameter rule_index, and can be used to cutomize the model depending on entity properties.

For more details, see Random Entities.

Examples

creeper.properties, creeper.jem, creeper2.jem
models.1=2
name.1=James
boat.properties, boat.jem, boat2.jem, boat3.jem
models.1=2
nbt.1.Type=spruce

models.2=3
nbt.2.Type=birch
bed.properties, bed.jem, bed2.jem, bed3.jem
models.1=2
models.1=2
name.1=James
blocks.1=black_bed

models.2=3
blocks.2=orange_bed

JSON schema

{
	"$schema": "http://json-schema.org/draft/2020-12/schema",
	"$id": "https://gitlab.com/whoatemybutter/optifinedocs/-/blob/master/schemas/cem_model.schema.json",
	"title": "Custom Entity Models Model",
	"description": "CEM model files contain the definition of a whole entity model.",
	"type": "object",
	"properties": {
		"texture": {
			"$ref": "common.schema.json#/$defs/resource",
			"description": "Texture used by entity model."
		},
		"textureSize": {
			"type": "array",
			"minItems": 2,
			"maxItems": 2,
			"items": {
				"type": "integer"
			},
			"description": "Texture size in pixels; [width, height]."
		},
		"shadowSize": {
			"type": "number",
			"minimum": 0,
			"maximum": 1,
			"description": "Shadow size as a scale, from 0.0 to 1.0."
		},
		"models": {
			"type": "array",
			"description": "Array of model objects that make up the entity's full model.",
			"items": {
				"type": "object",
				"properties": {
					"baseId": {
						"type": "string",
						"description": "Model parent ID. If specified, all parent properties are inherited and do not need to be explicitly put."
					},
					"model": {
						"type": "string",
						"$ref": "common.schema.json#/$defs/resource",
						"description": "Path to a JPM from which to load the part model definition. If this is not specified, the items in a JPM can be specified inline to this object, the parent of \"model\"."
					},
					"id": {
						"type": "string",
						"description": "Model ID, can be used to reference the model as parent."
					},
					"part": {
						"type": "string",
						"description": "Entity part to which the part model is attached."
					},
					"attach": {
						"type": "boolean",
						"description": "How to handle replacing overlapping parts. If true, attach. If false, replace."
					},
					"scale": {
						"type": "number",
						"minimum": 0,
						"description": "Render scale. 0.0 is invisible."
					},
					"animations": {
						"$ref": "cem_anim.schema.json#/properties/animations"
					}
				},
				"required": [
					"part"
				],
				"allOf": [
					{
						"$ref": "cem_part.schema.json"
					}
				]
			}
		}
	},
	"required": [
		"models"
	],
	"additionalProperties": false
}
Assumes the latest OptiFine version.
Updated to commit 15ef3106.
Open source at https://gitlab.com/whoatemybutter/optifinedocs.
Last update: 2024 April 30