✨ Add as_camera function

Author: SnaveSutit

src/pluginPackage/changelog.json

@@ -139,6 +139,7 @@
 					"Added a new function: `animated_java:<export_namespace>/at_all_locators {command: string}` that runs a command at all of a rig's entity-less locator positions.",
 					"Added a new function: `animated_java:<export_namespace>/as_locator {name: string, command: string}` that runs a command as and at a named locator's entity.",
 					"Added a new function: `animated_java:<export_namespace>/at_locator {name: string, command: string}` that runs a command at an entity-less locator's position.",
+					"Added a new function: `animated_java:<export_namespace>/as_camera {name: string, command: string}` that runs a command as and at a camera's entity.",
 					"Added a new function: `animated_java:<export_namespace>/remove/entities` that kills all entities owned by a rig, whether they are attached to a root entity or not.",
 					"Added a new Blueprint setting: `On-Remove Commands`.",
 					"Added support for `shadow_color` to JSON Text Components.",

src/systems/datapackCompiler/1.21.5/animation.mcb

@@ -792,6 +792,32 @@ dir <%export_namespace%> {
 		}
 	}
 
+	IF (has_cameras) {
+		function as_camera {
+			#ARGS: {name: string, command: string}
+			IF (show_function_errors) {
+				# Assert that the function is being run as the root entity.
+				execute unless entity @s[type=item_display,tag=<%TAGS.PROJECT_ROOT(export_namespace)%>] run return run \
+					function *global/errors/function_not_executed_as_root_entity \
+						{'export_namespace': '<%export_namespace%>', 'function_path': '<%arguments[1].functions.at(-1)%>'}
+			}
+			data remove storage aj:temp args
+			$data modify storage aj:temp args merge value {name:'$(name)', command:'$(command)'}
+			$execute \
+				on passengers \
+				if entity @s[tag=<%TAGS.GLOBAL_DATA()%>] \
+			run block zzz/as_camera/as_data { {name: $(name)}
+				data modify storage aj:temp args.uuid set from entity @s data.cameras.$(name)
+				scoreboard players set #aj.check <%OBJECTIVES.I()%> 0
+				block execute_as_uuid { with storage aj:temp args
+					$execute as $(uuid) at @s run $(command)
+					scoreboard players set #aj.check <%OBJECTIVES.I()%> 1
+				}
+				execute if score #aj.check <%OBJECTIVES.I()%> matches 0 run tellraw @a <%TELLRAW.CAMERA_NOT_FOUND_ENTITY()%>
+			}
+		}
+	}
+
 	dir remove {
 		function all {
 			# Removes all instances of this rig from the world.

src/systems/datapackCompiler/index.ts

@@ -634,6 +634,19 @@ namespace TELLRAW {
 			},
 			TELLRAW_SUFFIX(),
 		])
+	export const CAMERA_NOT_FOUND_ENTITY = () =>
+		new JsonText([
+			TELLRAW_PREFIX(),
+			{ text: 'Camera ', color: 'red' },
+			{ nbt: 'args.name', storage: 'aj:temp', color: 'aqua' },
+			{ text: ' not found!', color: 'red' },
+			{
+				text: "\nPlease ensure that it's name is spelled correctly.",
+				color: 'gray',
+				italic: true,
+			},
+			TELLRAW_SUFFIX(),
+		])
 }
 
 async function generateRootEntityPassengers(

test-packs/1.21.5/blueprints/armor_stand.ajblueprint

@@ -1,7 +1,7 @@
 {
 	"meta": {
 		"format": "animated_java_blueprint",
-		"format_version": "1.7.0",
+		"format_version": "1.7.0-pre1",
 		"uuid": "167b27cd-b559-3f13-a97c-0841fe21f1d1",
 		"save_location": "D:\\github-repos\\animated-java\\animated-java\\test-packs\\1.21.5\\blueprints\\armor_stand.ajblueprint",
 		"last_used_export_namespace": "armor_stand"