✨ Add tween_paused function

- Implements #382
- Adds `tween_paused`, a function that tweens from the current pose, to the target animation, but does not play the target animation.

Author: SnaveSutit

src/systems/datapackCompiler/1.20.4/main.mcb

@@ -296,6 +296,15 @@ IF (has_animations) {
 					execute on passengers store result entity @s interpolation_duration int 1 run scoreboard players get #this <%OBJECTIVES.I()%>
 				}
 
+				function tween_paused {
+					# Same as the tween function, except it does not play the animation afterwards
+					#ARGS: {duration: int, to_frame: int}
+					debug assert executed_as_root_entity <%TAGS.PROJECT_ROOT(blueprint_id)%>
+
+					tag @s add <%TAGS.PAUSE_AFTER_TWEEN()%>
+					$function ./tween {duration: $(duration), to_frame: $(to_frame)}
+				}
+
 				dir zzz {
 					function on_tick {
 						# Tweening logic

src/systems/datapackCompiler/1.20.5/main.mcb

@@ -298,6 +298,15 @@ IF (has_animations) {
 					execute on passengers store result entity @s interpolation_duration int 1 run scoreboard players get #this <%OBJECTIVES.I()%>
 				}
 
+				function tween_paused {
+					# Same as the tween function, except it does not play the animation afterwards
+					#ARGS: {duration: int, to_frame: int}
+					debug assert executed_as_root_entity <%TAGS.PROJECT_ROOT(blueprint_id)%>
+
+					tag @s add <%TAGS.PAUSE_AFTER_TWEEN()%>
+					$function ./tween {duration: $(duration), to_frame: $(to_frame)}
+				}
+
 				dir zzz {
 					function on_tick {
 						# Tweening logic

src/systems/datapackCompiler/1.21.0/main.mcb

@@ -298,6 +298,15 @@ IF (has_animations) {
 					execute on passengers store result entity @s interpolation_duration int 1 run scoreboard players get #this <%OBJECTIVES.I()%>
 				}
 
+				function tween_paused {
+					# Same as the tween function, except it does not play the animation afterwards
+					#ARGS: {duration: int, to_frame: int}
+					debug assert executed_as_root_entity <%TAGS.PROJECT_ROOT(blueprint_id)%>
+
+					tag @s add <%TAGS.PAUSE_AFTER_TWEEN()%>
+					$function ./tween {duration: $(duration), to_frame: $(to_frame)}
+				}
+
 				dir zzz {
 					function on_tick {
 						# Tweening logic

src/systems/datapackCompiler/1.21.2/main.mcb

@@ -299,6 +299,15 @@ IF (has_animations) {
 					execute on passengers store result entity @s interpolation_duration int 1 run scoreboard players get #this <%OBJECTIVES.I()%>
 				}
 
+				function tween_paused {
+					# Same as the tween function, except it does not play the animation afterwards
+					#ARGS: {duration: int, to_frame: int}
+					debug assert executed_as_root_entity <%TAGS.PROJECT_ROOT(blueprint_id)%>
+
+					tag @s add <%TAGS.PAUSE_AFTER_TWEEN()%>
+					$function ./tween {duration: $(duration), to_frame: $(to_frame)}
+				}
+
 				dir zzz {
 					function on_tick {
 						# Tweening logic

src/systems/datapackCompiler/1.21.4/main.mcb

@@ -359,6 +359,15 @@ IF (has_animations) {
 					}
 				}
 
+				function tween_paused {
+					# Same as the tween function, except it does not play the animation afterwards
+					#ARGS: {duration: int, to_frame: int}
+					debug assert executed_as_root_entity <%TAGS.PROJECT_ROOT(blueprint_id)%>
+
+					tag @s add <%TAGS.PAUSE_AFTER_TWEEN()%>
+					$function ./tween {duration: $(duration), to_frame: $(to_frame)}
+				}
+
 				dir zzz {
 					function on_tick {
 						# Tweening logic

src/systems/datapackCompiler/1.21.5/main.mcb

@@ -358,6 +358,15 @@ IF (has_animations) {
 					}
 				}
 
+				function tween_paused {
+					# Same as the tween function, except it does not play the animation afterwards
+					#ARGS: {duration: int, to_frame: int}
+					debug assert executed_as_root_entity <%TAGS.PROJECT_ROOT(blueprint_id)%>
+
+					tag @s add <%TAGS.PAUSE_AFTER_TWEEN()%>
+					$function ./tween {duration: $(duration), to_frame: $(to_frame)}
+				}
+
 				dir zzz {
 					function on_tick {
 						# Tweening logic

src/systems/datapackCompiler/tags.ts

@@ -189,6 +189,7 @@ namespace TAGS {
 	export const TRANSFORMS_ONLY = () => 'aj.transforms_only'
 	export const OUTDATED_RIG_TEXT_DISPLAY = () => 'aj.outdated_rig_text_display'
 	export const INTERACTING_PLAYER = () => 'aj.interacting_player'
+	export const PAUSE_AFTER_TWEEN = () => 'aj.pause_after_tween'
 }
 
 export default TAGS