Add character portraits gym

docs/gyms/gym10_character_portraits/gym10_spine.dtl

@@ -0,0 +1,86 @@
+# ============================================================
+# Gym 10.5 — Spine-Animated Portraits (Raptor)
+# ============================================================
+# Raptor uses spine animation portraits instead of static
+# images: walk, jump, roar. Each plays a looping animation.
+# ============================================================
+
+leave --All--
+
+# ---- Intro ----
+join Advisor (pl5) center
+Advisor (pl5): Raptor uses SPINE-ANIMATED portraits.
+Advisor (doubt): Unlike static PNG portraits, these play looping animations.
+
+[wait time="1.0"]
+
+# ---- Show the walk portrait ----
+leave Advisor
+join Raptor (walk) center [animation="Fade In"]
+
+Raptor (walk): This is my WALK portrait. I'm animated!
+
+[wait time="3.0"]
+
+# ---- Switch to jump ----
+update Raptor (jump) center
+
+Raptor (jump): Now I'm JUMPING! Notice the animation change.
+
+[wait time="3.0"]
+
+# ---- Switch to roar ----
+update Raptor (roar) center
+
+Raptor (roar): ROOOAAR! My roar animation is fierce!
+
+[wait time="3.0"]
+
+# ---- Demonstrate fade transition ----
+update Raptor (walk) center
+
+Raptor (walk): You can also crossfade between spine portraits.
+
+[wait time="1.0"]
+
+# ---- Compare with static portraits ----
+leave Raptor
+
+join Miko (neutral) center [animation="Fade In"]
+Miko (neutral): I use static PNG portraits — they don't move.
+Miko (smile): Each of my expressions is a separate still image.
+
+[wait time="1.0"]
+
+join Advisor (pl5) left [animation="Fade In"]
+Advisor (pl5): Spine portraits are great for characters that need\
+continuous motion — creatures, robots, or expressive characters.
+
+[wait time="1.5"]
+
+# ---- Bring Raptor back with both ----
+leave Miko
+leave Advisor
+
+join Raptor (walk) center [animation="Fade In"]
+
+Raptor (walk): Spine portraits are configured in the character resource.
+Raptor (walk): Each portrait points to a custom portrait scene\
+with a SpineSprite node instead of a TextureRect.
+
+[wait time="2.0"]
+
+# ---- Key difference ----
+join Advisor (pl5) right [animation="Fade In"]
+
+Advisor (pl5): Key difference: spine animations loop forever.
+Advisor (pl5): Static portraits stay on one frame until you switch them.
+Advisor (pl5): Both use the same join/update/leave commands!
+
+[wait time="2.0"]
+
+# ---- Clean up ----
+leave --All--
+[wait time="0.5"]
+
+jump gym10_main/menu