기본 수정사항

2026-08-06 09:30:08 +09:00
parent 15914d23a2
commit 6d6d452922
29 changed files with 666 additions and 25 deletions
--- a/Assets/02_Scripts/Communication/Dialog/DialogNode.cs
+++ b/Assets/02_Scripts/Communication/Dialog/DialogNode.cs
@@ -9,6 +9,16 @@ public enum DialogNodeKind
    [InspectorName("종료")] End,                       // 대화를 끝낸다 (BGM 처리만 정함)
 }

+// 이 대사에서 이미 떠 있던 화면 그림을 걷어낼지.
+// 그림 지정이 "비우면 변경 없음"(BGM과 같은 규칙)이라 지우는 길을 따로 열어 둔 것이다.
+public enum SpriteClear
+{
+    [InspectorName("없음")] None,
+    [InspectorName("앞 그림")] Front,
+    [InspectorName("옆 그림")] Side,
+    [InspectorName("둘 다")] Both,
+}
+
 [CreateAssetMenu(menuName = "Communication/Dialog Node")]
 public class DialogNode : ScriptableObject
 {
@@ -41,6 +51,20 @@ public class DialogNode : ScriptableObject
             "비우면 DialogHud의 기본 스타일을 쓴다")]
    public TypewriterStyle Typewriter;

+    [Header("Sprite")]
+    [Tooltip("이 대사 동안 화면 앞쪽(가운데 아래)에 세울 그림. 인물이 보통이지만 물건·서류도 된다. " +
+             "비우면 변경 없음 — BGM과 같은 규칙이라 인물이 서 있는 동안 매 대사에 다시 꽂을 필요가 없다. " +
+             "대화가 끝나면 대화 전에 떠 있던 그림으로 되돌아간다")]
+    public Sprite FrontSprite;
+
+    [Tooltip("이 대사 동안 화면 옆(왼쪽)에 놓을 그림. 제시한 물건을 놓고 설명할 때 쓴다. " +
+             "비우면 변경 없음. 대화가 끝나면 자동으로 걷힌다")]
+    public Sprite SideSprite;
+
+    [Tooltip("이미 떠 있던 그림을 이 대사에서 걷어낸다. 그림 지정이 '비우면 변경 없음'이라 " +
+             "지울 때만 쓴다. 같은 노드에서 새 그림도 지정했다면 새 그림이 이긴다")]
+    public SpriteClear ClearSprite;
+
    [Header("Flow")]
    public DialogNode Next;              // 선택지 없을 때 자동으로 갈 노드
    public List<DialogChoice> Choices;   // 있으면 플레이어 선택 대기
--- a/Assets/02_Scripts/Communication/Dialog/DialogPlayer.cs
+++ b/Assets/02_Scripts/Communication/Dialog/DialogPlayer.cs
@@ -202,6 +202,12 @@ private async Awaitable PlayBeat(StoryBeat beat)
        // 도달한 종료 노드가 정한다. 중간에 끊기면(씬 전환 등) false로 남아 장소 BGM으로 복귀한다.
        bool keepBgmOnEnd = false;

+        // 대화 전에 떠 있던 화면 그림 — 끝나면 이 상태로 되돌린다.
+        // 제스처·표정 Animator를 되돌리는 것과 같은 취지다: 대화는 장소 화면을 잠시 빌려 쓸 뿐이라
+        // 장소에 서 있던 인물이 대화 한 번 했다고 사라지거나 표정이 굳어 있으면 안 된다.
+        var frontBefore = FrontSprite.Instance != null ? FrontSprite.Instance.Current : null;
+        var sideBefore  = SideSprite.Instance  != null ? SideSprite.Instance.Current  : null;
+
        try
        {
            var node = beat.Group.StartNode;
@@ -285,6 +291,10 @@ private async Awaitable PlayBeat(StoryBeat beat)
            if (SoundManager.Instance != null && !keepBgmOnEnd)
                SoundManager.Instance.ClearOverrideBGM();

+            // 화면 그림 복원 — Show(null)은 Hide()와 같으므로 "대화 전에 아무것도 없었다"도 그대로 처리된다
+            if (FrontSprite.Instance != null) FrontSprite.Instance.Show(frontBefore);
+            if (SideSprite.Instance  != null) SideSprite.Instance.Show(sideBefore);
+
            RestoreDefaultAnimations();
        }
    }
@@ -341,6 +351,9 @@ private async Awaitable<bool> PlayNode(DialogNode node)
        if (node.Sfx != null && SoundManager.Instance != null)
            SoundManager.Instance.PlaySFX(node.Sfx);

+        // 화면 그림(앞/옆) — BGM과 같은 규칙으로 비우면 변경 없음
+        ApplySprites(node);
+
        // 보이스 재생
        if (node.Voice != null && node.Speaker != null)
        {
@@ -376,6 +389,23 @@ private async Awaitable<bool> PlayNode(DialogNode node)
        return false;
    }

+    // 노드가 지정한 화면 그림을 반영한다.
+    // 비어 있는 지정은 "변경 없음"이라(BGM과 같은 규칙) 인물이 서 있는 동안 매 대사에 다시 꽂을 필요가 없다.
+    // 지우기를 먼저, 지정을 나중에 처리한다 — 한 노드에서 둘 다 걸면 새 그림이 이긴다.
+    private static void ApplySprites(DialogNode node)
+    {
+        var front = FrontSprite.Instance;
+        var side  = SideSprite.Instance;
+        bool hasFront = front != null;
+        bool hasSide  = side != null;
+
+        if (hasFront && node.ClearSprite is SpriteClear.Front or SpriteClear.Both) front.Hide();
+        if (hasSide  && node.ClearSprite is SpriteClear.Side  or SpriteClear.Both) side.Hide();
+
+        if (hasFront && node.FrontSprite != null) front.Show(node.FrontSprite);
+        if (hasSide  && node.SideSprite  != null) side.Show(node.SideSprite);
+    }
+
    // 호감도 분기 노드의 조건식 평가.
    // 각 조건의 JoinWithNext로 이어 붙이며, AND가 OR보다 우선순위가 높다:
    //   A and B or C  →  (A and B) or C
--- a/Assets/02_Scripts/Communication/Dialog/GraphTool/Editor/DialogGraphImporter.cs
+++ b/Assets/02_Scripts/Communication/Dialog/GraphTool/Editor/DialogGraphImporter.cs
@@ -10,7 +10,7 @@ namespace DinoLove.Dialog.GraphTool.Editor
    // .dlg 그래프 에셋을 기존 런타임 타입(DialogGroup / DialogNode / DialogChoice)으로 변환한다.
    // 생성된 DialogNode들은 서브에셋으로, DialogGroup이 메인 에셋으로 등록된다.
    // 따라서 DialogPlayer는 수정 없이 임포트된 .dlg 에셋(= DialogGroup)을 그대로 사용한다.
-    [ScriptedImporter(20, DialogGraph.AssetExtension)]   // 버전 올리면 기존 .dlg 에셋이 재임포트됨
+    [ScriptedImporter(21, DialogGraph.AssetExtension)]   // 버전 올리면 기존 .dlg 에셋이 재임포트됨
    internal class DialogGraphImporter : ScriptedImporter
    {
        public override void OnImportAsset(AssetImportContext ctx)
@@ -127,6 +127,9 @@ public override void OnImportAsset(AssetImportContext ctx)
                dn.TalkText     = GetInputPortValue<DialogText>(gn.GetInputPortByName(DialogLineNode.PORT_TALK)).Value;
                dn.Gesture      = GetInputPortValue<GestureData>(gn.GetInputPortByName(DialogLineNode.PORT_GESTURE));
                dn.Expression   = GetInputPortValue<ExpressionData>(gn.GetInputPortByName(DialogLineNode.PORT_EXPRESSION));
+                dn.FrontSprite  = GetInputPortValue<Sprite>(gn.GetInputPortByName(DialogLineNode.PORT_FRONT_SPRITE));
+                dn.SideSprite   = GetInputPortValue<Sprite>(gn.GetInputPortByName(DialogLineNode.PORT_SIDE_SPRITE));
+                dn.ClearSprite  = GetInputPortValue<SpriteClear>(gn.GetInputPortByName(DialogLineNode.PORT_CLEAR_SPRITE));
                dn.Voice        = GetInputPortValue<VoiceClip>(gn.GetInputPortByName(DialogLineNode.PORT_VOICE));
                dn.Bgm          = GetInputPortValue<AudioClip>(gn.GetInputPortByName(DialogLineNode.PORT_BGM));
                dn.Sfx          = GetInputPortValue<AudioClip>(gn.GetInputPortByName(DialogLineNode.PORT_SFX));
--- a/Assets/02_Scripts/Communication/Dialog/GraphTool/Editor/DialogLineNode.cs
+++ b/Assets/02_Scripts/Communication/Dialog/GraphTool/Editor/DialogLineNode.cs
@@ -19,6 +19,9 @@ internal class DialogLineNode : DialogGraphNode
        public const string PORT_TALK       = "TalkText";
        public const string PORT_GESTURE    = "Gesture";
        public const string PORT_EXPRESSION = "Expression";
+        public const string PORT_FRONT_SPRITE = "FrontSprite";
+        public const string PORT_SIDE_SPRITE  = "SideSprite";
+        public const string PORT_CLEAR_SPRITE = "ClearSprite";
        public const string PORT_VOICE      = "Voice";
        public const string PORT_BGM        = "Bgm";
        public const string PORT_SFX        = "Sfx";
@@ -68,6 +71,18 @@ protected override void OnDefinePorts(IPortDefinitionContext context)
            context.AddInputPort<DialogText>(PORT_TALK).WithDisplayName("Talk Text").Build();
            context.AddInputPort<GestureData>(PORT_GESTURE).WithDisplayName("Gesture").Build();
            context.AddInputPort<ExpressionData>(PORT_EXPRESSION).WithDisplayName("Expression").Build();
+
+            // 화면에 세우는 그림 — Gesture/Expression(Animator)과 달리 2D 스프라이트를 직접 갈아끼운다
+            context.AddInputPort<Sprite>(PORT_FRONT_SPRITE).WithDisplayName("Front Sprite")
+                .WithTooltip("이 대사 동안 화면 앞쪽(가운데 아래)에 세울 그림. 인물이 보통이지만 물건·서류도 된다. " +
+                             "비우면 변경 없음 — BGM과 같은 규칙이라 인물이 서 있는 동안 매 대사에 다시 꽂을 필요가 없다").Build();
+            context.AddInputPort<Sprite>(PORT_SIDE_SPRITE).WithDisplayName("Side Sprite")
+                .WithTooltip("이 대사 동안 화면 옆(왼쪽)에 놓을 그림. 제시한 물건을 놓고 설명할 때 쓴다. " +
+                             "비우면 변경 없음").Build();
+            context.AddInputPort<SpriteClear>(PORT_CLEAR_SPRITE).WithDisplayName("Clear Sprite")
+                .WithTooltip("이미 떠 있던 그림을 이 대사에서 걷어낸다. 그림 지정이 '비우면 변경 없음'이라 " +
+                             "지울 때만 쓴다. 같은 노드에서 새 그림도 지정했다면 새 그림이 이긴다").Build();
+
            context.AddInputPort<VoiceClip>(PORT_VOICE).WithDisplayName("Voice").Build();
            context.AddInputPort<AudioClip>(PORT_BGM).WithDisplayName("BGM")
                .WithTooltip("있으면 이 대사부터 이 BGM으로 갈아탄다. " +