✨ Add Texture Slots

- faces assigned to a slot can switch between the slot's textures
- 1.21.4+ can switch each slot on its own via texture_slots functions
- variants pick a texture per slot instead of mapping textures
- default variant can now be renamed
- 1.11.0 blueprint upgrade migrates old texture maps
- plugin JSON format v3 replaces texture_palettes with texture_slots

Author: SnaveSutit

schemas/example-plugin-blueprint.json

@@ -1,6 +1,6 @@
 {
 	"$schema": "./plugin-blueprint.schema.json",
-	"format_version": 2,
+	"format_version": 3,
 	"settings": {
 		"id": "animated_java:blueprint"
 	},
@@ -19,13 +19,10 @@
 			"resource_location": "minecraft:block/stone"
 		}
 	},
-	"texture_palettes": {
-		"default_palette": {
-			"active_state": "default",
-			"states": {
-				"default": { "texture": "custom_texture" },
-				"alternative": { "texture": "reference_texture" }
-			}
+	"texture_slots": {
+		"body": {
+			"default_texture": "custom_texture",
+			"textures": ["custom_texture", "reference_texture"]
 		}
 	},
 	"nodes": {
@@ -90,8 +87,8 @@
 						"down": {
 							"uv": [0, 0, 16, 16],
 							"texture_provider": {
-								"type": "texture_palette",
-								"texture_palette": "default_palette"
+								"type": "texture_slot",
+								"texture_slot": "body"
 							}
 						}
 					},
@@ -138,8 +135,8 @@
 						"down": {
 							"uv": [0, 0, 16, 16],
 							"texture_provider": {
-								"type": "texture_palette",
-								"texture_palette": "default_palette"
+								"type": "texture_slot",
+								"texture_slot": "body"
 							}
 						}
 					},
@@ -180,8 +177,8 @@
 						"down": {
 							"uv": [0, 0, 16, 16],
 							"texture_provider": {
-								"type": "texture_palette",
-								"texture_palette": "default_palette"
+								"type": "texture_slot",
+								"texture_slot": "body"
 							}
 						}
 					},
@@ -260,9 +257,9 @@
 			"start_delay": "0.0",
 			"length": 3.0,
 			"global_keyframes": {
-				"texture": {
-					"0.0": { "default_palette": "default" },
-					"1.5": { "default_palette": "alternative" }
+				"texture_slot": {
+					"0.0": { "body": "custom_texture" },
+					"1.5": { "body": "reference_texture" }
 				},
 				"event": {
 					"1.5": { "events": ["event_1", "event_2"] },

schemas/plugin-blueprint.schema.json

@@ -27,12 +27,12 @@
 				}
 			}
 		},
-		"texture_palettes": {
+		"texture_slots": {
 			"type": "object",
 			"default": {},
 			"patternProperties": {
 				"^[a-z0-9_]+$": {
-					"$ref": "#/definitions/texture_palette"
+					"$ref": "#/definitions/texture_slot"
 				}
 			}
 		},
@@ -128,31 +128,23 @@
 				}
 			]
 		},
-		"texture_palette": {
+		"texture_slot": {
 			"type": "object",
-			"required": ["active_state", "states"],
+			"description": "A group of faces that can be switched to any of the slot's textures.",
+			"required": ["default_texture", "textures"],
 			"properties": {
-				"active_state": {
+				"default_texture": {
 					"type": "string",
-					"description": "The name of the currently active state. This value must match one of the keys defined in the 'states' map.",
+					"description": "The key of the texture the slot starts with. Must be one of 'textures'.",
 					"pattern": "^[a-z0-9_]+$"
 				},
-				"states": {
-					"type": "object",
-					"description": "A map that links state names to objects representing individual states.",
-					"minProperties": 1,
-					"patternProperties": {
-						"^[a-z0-9_]+$": {
-							"type": "object",
-							"required": ["texture"],
-							"properties": {
-								"texture": {
-									"type": "string",
-									"description": "The key of the texture used for this state, referencing an entry from the 'textures' section.",
-									"pattern": "^[a-z0-9_]+$"
-								}
-							}
-						}
+				"textures": {
+					"type": "array",
+					"description": "Keys of the textures the slot can switch to, from the 'textures' section.",
+					"minItems": 1,
+					"items": {
+						"type": "string",
+						"pattern": "^[a-z0-9_]+$"
 					}
 				}
 			}
@@ -438,14 +430,14 @@
 							}
 						},
 						{
-							"required": ["type", "texture_palette"],
+							"required": ["type", "texture_slot"],
 							"properties": {
 								"type": {
-									"const": "texture_palette"
+									"const": "texture_slot"
 								},
-								"texture_palette": {
+								"texture_slot": {
 									"type": "string",
-									"description": "A valid key from the 'texture_palettes' section."
+									"description": "A valid key from the 'texture_slots' section."
 								}
 							}
 						}
@@ -683,13 +675,13 @@
 					"type": "object",
 					"default": {},
 					"properties": {
-						"texture": {
+						"texture_slot": {
 							"type": "object",
 							"default": {},
-							"description": "A collection of texture keyframes, identified by a floating-point timestamp.",
+							"description": "A collection of texture slot keyframes, identified by a floating-point timestamp.",
 							"patternProperties": {
 								"^\\d+\\.\\d+$": {
-									"$ref": "#/definitions/texture_keyframe"
+									"$ref": "#/definitions/texture_slot_keyframe"
 								}
 							}
 						},
@@ -759,10 +751,10 @@
 			"minItems": 3,
 			"maxItems": 3
 		},
-		"texture_keyframe": {
+		"texture_slot_keyframe": {
 			"type": "object",
 			"default": {},
-			"description": "Maps texture palettes to active states. Each key corresponds to a valid texture palette key from the 'texture_palette' section, and the value defines its active state.",
+			"description": "Maps keys from the 'texture_slots' section to the texture each slot switches to. Slots not listed are unchanged.",
 			"patternProperties": {
 				"^[a-z0-9_]+$": {
 					"type": "string",