using System.Collections.Generic; using TKS.OutGame; using UnityEngine; namespace TKS { /// /// 1장 학습 판 안내 진행(개발 요청서 C5 · 2026-11-12) — tutorial_guide.csv 를 n_step 순서대로: /// 앞 단계가 닫힌 뒤 e_trigger 가 맞으면 띄우고, b_lock 1 이면 가리킨 것만 누를 수 있다. 안내는 그 판을 처음 할 때만(클리어 기록) · fail 카드는 매번. /// 닫힘 = 카드: 탭 · 끌기: 그 행동이 끝남 · 강조·띠: tutorial_config guide_auto_close_sec 뒤 또는 탭 · 누름: 대상을 누름. /// 끌기 단계 바로 다음이 unit_select 단계면 「조준 안내」 — 그 유닛을 잡고 있는 동안 그 문구·대상을 보여 주고, 쏘면 둘 다 끝난다(손을 떼어 취소하면 끌기 안내로 돌아감). /// 그 밖: 남은 턴 칩(턴 제한 판) · 안내가 가리키는 함정 보이기(1-7) · 클리어 결말 카드(첫 클리어) · 편성 화면 안내(before_battle). /// 전장 조작 막기 = SlingshotInput 이 BlocksInput · AllowPress · SnapAim · AllowShot 을 물어본다. 가상 실행(Sim.Active) 중에는 아무 사건도 받지 않는다. /// public class TutorialDirector : MonoBehaviour { public static TutorialDirector Current { get; private set; } const float MinCardSec = 0.35f; // 카드가 뜨자마자 닫히지 않게 const float MinTapSec = 0.2f; const float HolePad = 18f; struct Evt { public GuideTrigger trig; public int turn; public Unit unit; } BattleManager battle; Camera cam; CameraController camCtrl; TutorialGuideUI ui; TutorialPlan plan; bool guideOn; bool firstPlay; readonly List steps = new List(); readonly List failSteps = new List(); readonly Queue overlay = new Queue(); // 결말 · 실패 · 편성 화면 안내 readonly List happened = new List(); readonly Dictionary gimmicks = new Dictionary(); readonly HashSet beforeShown = new HashSet(); string beforeChecked = ""; int index; TutorialGuideRow active; bool activeOverlay; TutorialGuideRow hint; // 끌기 안내 중 유닛을 잡았을 때의 조준 안내(다음 단계) float shownAt; bool aiming; bool fired; bool movedCamera; bool swallow; Unit lastActor; BattlePhase lastPhase = BattlePhase.Setup; bool bossHold; bool bossDone; RectTransform skillButton; public TutorialPlan Plan { get { return plan; } } public bool GuideOn { get { return guideOn; } } public TutorialGuideRow ActiveStep { get { return active; } } /// 조준 안내가 떠 있으면 그 단계. public TutorialGuideRow HintStep { get { return hint; } } public int StepIndex { get { return index; } } public int StepCount { get { return steps.Count; } } public TutorialGuideUI Ui { get { return ui; } } public static TutorialDirector Ensure(BattleManager bm) { if (Current != null && Current.battle == bm) return Current; var go = new GameObject("TutorialDirector"); go.transform.SetParent(bm.transform, false); var d = go.AddComponent(); d.Init(bm); return d; } void Init(BattleManager bm) { Current = this; battle = bm; cam = Camera.main; camCtrl = cam != null ? cam.GetComponent() : null; if (cam != null) ui = TutorialGuideUI.Create(transform, cam); bm.PhaseChanged += OnPhase; bm.UnitActing += OnUnitActing; bm.Changed += RefreshTurnChip; } void OnDestroy() { if (Current == this) Current = null; if (battle == null) return; battle.PhaseChanged -= OnPhase; battle.UnitActing -= OnUnitActing; battle.Changed -= RefreshTurnChip; } /// /// 잠금 끌기 안내가 맞춰 쏘는 세기(최대 거리 대비): 판별 값 `drag_lock_shot_pull_<장>_<판>` 이 표에 있으면 그 값 · 없으면 공통 `drag_lock_shot_pull` /// (PD 2026-11-16 병종 물리 조정 — 1-2 는 장비를 4.1 밀어야 하고 1-8 은 적을 불길 띠 안에 세워야 해서 한 값으로 맞출 수 없다). /// float ShotPull() { float all = Num("drag_lock_shot_pull", 1f); return plan != null && plan.Row != null ? Num("drag_lock_shot_pull_" + plan.Row.chapter + "_" + plan.Row.stage, all) : all; } float Num(string key, float fallback) { var db = plan != null ? plan.Db : TutorialTables.Db; return db != null ? db.Num(key, fallback) : fallback; } // ---------- 판 시작 ---------- /// 전투 시작(BattleManager.Begin · 유닛·기믹 배치 뒤 · 첫 턴 전). p = 그 판의 학습 판 계획(null = 일반 판). public void BeginStage(TutorialPlan p) { plan = p; steps.Clear(); failSteps.Clear(); overlay.Clear(); happened.Clear(); gimmicks.Clear(); index = 0; active = null; hint = null; activeOverlay = aiming = fired = movedCamera = swallow = false; bossHold = bossDone = false; lastActor = null; lastPhase = BattlePhase.Setup; guideOn = false; RefreshInfo(); RefreshTurnChip(); if (p == null || ui == null) return; firstPlay = !TutorialRules.Cleared(p.Row.chapter, p.Row.stage); var rows = p.Db.Guide(p.Row.chapter, p.Row.stage); foreach (var g in rows) { if (g.trigger == GuideTrigger.Fail) failSteps.Add(g); else if (g.trigger != GuideTrigger.BeforeBattle && firstPlay) steps.Add(g); } guideOn = steps.Count > 0; // 배치 표 기믹 슬롯 ↔ 전장 기믹(같은 id · 같은 자리) var layer = battle.Gimmicks; if (layer != null) { foreach (var r in p.Layout) { if (r.side != TutSide.Gimmick) continue; foreach (var g in layer.Items) { if (g.Id != r.gimmickId || Vector2.Distance(g.Shape.Center, r.pos) > 0.05f || gimmicks.ContainsValue(g)) continue; gimmicks[r.slot] = g; break; } } } // 안내가 가리키는 함정은 이 판에서 자리를 보여 준다(1-7 「이번만 함정 자리를 보여 줍니다」 · 클리어 뒤 다시 해도 같음) foreach (var g in rows) { foreach (var slot in g.Target.AllSlots()) { GimmickInstance gi; if (gimmicks.TryGetValue(slot, out gi) && gi.Zone == GimmickZone.Trap && gi.View != null && gi.View.Body != null) gi.View.Body.gameObject.SetActive(true); } } happened.Add(new Evt { trig = GuideTrigger.StageStart }); } /// 보스 등장 연출(C2)이 시작될 때 부른다 — 끝나면 NotifyBossIntroEnd. 부르지 않으면 첫 아군 턴에 boss_intro_end 로 본다. public void HoldBossIntro() { bossHold = true; } public void NotifyBossIntroEnd() { if (bossDone) return; bossHold = false; bossDone = true; Add(GuideTrigger.BossIntroEnd, battle.TurnNumber, null); TryAdvance(); } // ---------- 전투 사건 ---------- void Add(GuideTrigger trig, int turn, Unit u) { if (!guideOn) return; happened.Add(new Evt { trig = trig, turn = turn, unit = u }); } void OnPhase(BattlePhase p) { if (Sim.Active) return; var prev = lastPhase; lastPhase = p; RefreshTurnChip(); if (p == BattlePhase.Setup) { BeginStage(null); // 전투 없음(월드맵·로비) return; } if (plan == null) return; int turn = battle.TurnNumber; if (prev == BattlePhase.Resolving) { Add(GuideTrigger.ActionEnd, turn, lastActor); if (active != null && !activeOverlay && active.mode == GuideMode.Drag && fired) CloseActive(false, true); } switch (p) { case BattlePhase.PlayerTurn: if (prev != BattlePhase.Resolving) { Add(GuideTrigger.TurnStart, turn, null); if (!bossHold && !bossDone) { bossDone = true; Add(GuideTrigger.BossIntroEnd, turn, null); } } break; case BattlePhase.EnemyTurn: Add(GuideTrigger.EnemyTurn, turn, null); // 잠기지 않은 끌기·누름 안내는 아군 턴이 끝나면 닫는다 if (active != null && !activeOverlay && !active.locked && (active.mode == GuideMode.Drag || active.mode == GuideMode.Tap)) CloseActive(false, false); break; case BattlePhase.StageClear: EndGuide(); if (firstPlay && !string.IsNullOrEmpty(plan.Row.clearKo)) overlay.Enqueue(new TutorialGuideRow { chapter = plan.Row.chapter, stage = plan.Row.stage, mode = GuideMode.Popup, locked = true, textKo = plan.Row.clearKo }); break; case BattlePhase.Defeat: EndGuide(); foreach (var f in failSteps) overlay.Enqueue(f); break; } TryAdvance(); } void OnUnitActing(Unit u) { if (Sim.Active || u == null) return; lastActor = u; if (u.Faction != Faction.Player || active == null || activeOverlay) return; if (active.mode == GuideMode.Drag && u == FromUnit(active)) { fired = true; aiming = false; RefreshInfo(); } else if (!active.locked && active.mode == GuideMode.Tap) CloseActive(false, false); } /// 유닛을 골랐다(SlingshotInput.Select). public void OnSelect(Unit u) { if (u == null || plan == null || !guideOn) return; bool canAct = u.Faction == Faction.Player && battle.CanAct(u); if (canAct) Add(GuideTrigger.UnitSelect, battle.TurnNumber, u); if (active != null && !activeOverlay) { if (active.mode == GuideMode.Tap && active.Target.kind == GuideTargetKind.Slots && IsTargetUnit(active, u)) CloseActive(false, false); else if (active.mode == GuideMode.Drag && canAct && !fired && u == FromUnit(active)) { aiming = true; hint = NextAimHint(); RefreshInfo(); } } TryAdvance(); } /// 당기다가 쏘지 않고 손을 뗐다. public void OnAimCancelled() { if (!aiming) return; aiming = false; hint = null; RefreshInfo(); } /// 스킬 버튼을 눌렀다. public void NotifySkillTap() { if (active == null || activeOverlay) return; if (active.Target.kind == GuideTargetKind.Ui && active.Target.ui == "skill" && (active.mode == GuideMode.Tap || active.mode == GuideMode.Highlight)) CloseActive(false, false); } void EndGuide() { active = null; hint = null; activeOverlay = aiming = fired = false; index = steps.Count; RefreshInfo(); } // ---------- 단계 진행 ---------- TutorialGuideRow NextAimHint() { return index + 1 < steps.Count && steps[index + 1].trigger == GuideTrigger.UnitSelect ? steps[index + 1] : null; } static bool NeedsPlayerTurn(TutorialGuideRow s) { return s.locked || s.mode == GuideMode.Popup || s.mode == GuideMode.Drag || s.mode == GuideMode.Tap; } /// 그 단계의 조건을 채운 사건 위치(없으면 −1 · after_step = −2). int Match(TutorialGuideRow s) { if (s.trigger == GuideTrigger.AfterStep) return -2; Unit want = null; if (s.trigger == GuideTrigger.UnitSelect && s.Target.kind == GuideTargetKind.Slots) { foreach (var slot in s.Target.slots) { var r = plan.SlotRow(slot); if (r != null && r.side == TutSide.Ally) want = plan.UnitAt(slot); } } for (int i = 0; i < happened.Count; i++) { var e = happened[i]; if (e.trig != s.trigger) continue; if (s.turn > 0 && e.turn != s.turn && s.trigger != GuideTrigger.StageStart && s.trigger != GuideTrigger.BossIntroEnd) continue; if (want != null && e.unit != want) continue; return i; } return -1; } /// 턴이 지나 더는 일어날 수 없는 단계(건너뜀). bool Stale(TutorialGuideRow s) { if (s.turn <= 0 || battle.TurnNumber <= s.turn) return false; return s.trigger == GuideTrigger.ActionEnd || s.trigger == GuideTrigger.EnemyTurn || s.trigger == GuideTrigger.TurnStart || s.trigger == GuideTrigger.UnitSelect; } void TryAdvance() { if (active != null || ui == null) return; if (overlay.Count > 0) { Show(overlay.Dequeue(), true); return; } if (!guideOn || plan == null) return; var ph = battle.Phase; if (ph == BattlePhase.Setup || ph == BattlePhase.StageClear || ph == BattlePhase.Defeat) return; while (index < steps.Count) { var s = steps[index]; int at = Match(s); if (at != -1) { if (NeedsPlayerTurn(s) && ph != BattlePhase.PlayerTurn) return; // 아군 턴까지 기다림 if (at >= 0) happened.RemoveRange(0, at + 1); Show(s, false); return; } if (!Stale(s)) return; index++; } } void Show(TutorialGuideRow s, bool isOverlay) { active = s; activeOverlay = isOverlay; hint = null; aiming = fired = false; shownAt = Time.unscaledTime; FocusCamera(s); RefreshInfo(); } /// byTap = 화면을 눌러 닫음(그 누름이 전장 조작으로 새지 않게) · byAction = 끌기 안내의 행동이 끝나 닫힘. void CloseActive(bool byTap, bool byAction) { var row = active; if (row == null) return; bool wasOverlay = activeOverlay; bool hadHint = !wasOverlay && row.mode == GuideMode.Drag && byAction && NextAimHint() != null; active = null; hint = null; activeOverlay = aiming = fired = false; if (!wasOverlay) index += hadHint ? 2 : 1; // 조준 안내는 끌기와 함께 끝난다 if (byTap && (row.locked || row.mode == GuideMode.Popup)) swallow = true; RefreshInfo(); TryAdvance(); if (active == null && movedCamera) RestoreCamera(); } /// 테스트·검증 캡처: 화면을 누른 것처럼 지금 안내(카드 · 강조 · 띠)를 닫는다. public void TapForTest() { if (active == null) return; if (active.mode == GuideMode.Popup || ((active.mode == GuideMode.Highlight || active.mode == GuideMode.Bar) && !WaitsForSkill(active))) CloseActive(false, false); } // ---------- 입력(SlingshotInput 이 물어봄) ---------- /// 화면 누름을 전장 조작·결과 넘기기로 보내지 않는다(카드 · 잠긴 강조·띠 · 방금 탭으로 닫은 누름). public bool BlocksInput { get { if (swallow) return true; if (active == null) return false; if (active.mode == GuideMode.Popup) return true; return active.locked && (active.mode == GuideMode.Highlight || active.mode == GuideMode.Bar) && !WaitsForSkill(active); } } /// 잠금 안내가 떠 있다(가리킨 것만 누를 수 있다 · 화면 끌기·확대 막힘). public bool Locked { get { return active != null && active.locked; } } static bool WaitsForSkill(TutorialGuideRow s) { return s.locked && s.mode == GuideMode.Highlight && s.Target.kind == GuideTargetKind.Ui && s.Target.ui == "skill"; } /// 잠금 안내 중 이 누름을 받아도 되는가 — under = 누른 자리의 아군 유닛(없으면 null). public bool AllowPress(Vector2 screen, Unit under) { if (active == null || !active.locked) return true; bool overSkill = OverSkillButton(screen); switch (active.mode) { case GuideMode.Drag: return !fired && !overSkill && under != null && under == FromUnit(active); case GuideMode.Tap: if (active.Target.kind == GuideTargetKind.Ui) return active.Target.ui == "skill" && overSkill; return !overSkill && under != null && IsTargetUnit(active, under); case GuideMode.Highlight: return WaitsForSkill(active) && overSkill; } return false; } /// /// 잠긴 끌기 안내 — 조준이 목표 방향에서 허용 각도 안이고 최소 당김(drag_lock_min_pull)을 넘으면 목표 방향 · 정해진 세기(drag_lock_shot_pull)로 맞춘다. /// 안내한 결과가 그대로 나오게 하고, 화면 아래쪽 유닛은 끝까지 당길 자리가 모자라도 진행되게 한다(조준 화살표도 맞춘 값으로 보인다). /// public Vector2 SnapAim(Unit u, Vector2 target) { if (active == null || !active.locked || active.mode != GuideMode.Drag || u == null || u != FromUnit(active)) return target; Vector2 want = DragPoint(active) - u.Position; Vector2 aim = target - u.Position; if (want.sqrMagnitude < 1e-4f || aim.sqrMagnitude < 1e-4f) return target; if (Vector2.Angle(want, aim) > Num("drag_lock_angle_deg", 0f)) return target; float max = SkillMods.SlingMax(u); if (aim.magnitude < max * Num("drag_lock_min_pull", 0f) - 0.01f) return target; // 덜 당김 = 그대로 보여 주고 발사는 거부 return battle.Board.ClampInside(u.Position + want.normalized * max * Mathf.Clamp01(ShotPull()), u.Radius); } /// 이 발사를 허용하는가 — 잠긴 끌기 안내 = 그 유닛 · 목표 방향 · 최소 당김 이상 / 그 밖의 잠금 안내 = 발사 불가. public bool AllowShot(Unit u, Vector2 target) { if (active == null || !active.locked) return true; if (active.mode != GuideMode.Drag || u == null || u != FromUnit(active)) return false; Vector2 want = DragPoint(active) - u.Position; Vector2 aim = target - u.Position; if (want.sqrMagnitude < 1e-4f || aim.sqrMagnitude < 1e-4f) return false; if (Vector2.Angle(want, aim) > Num("drag_lock_angle_deg", 0f) + 0.5f) return false; Vector2 full = battle.Board.ClampInside(u.Position + aim.normalized * SkillMods.SlingMax(u), u.Radius); return aim.magnitude >= Vector2.Distance(full, u.Position) * Num("drag_lock_min_pull", 0f) - 0.02f; } bool OverSkillButton(Vector2 screen) { var rt = SkillButton; return rt != null && rt.gameObject.activeInHierarchy && RectTransformUtility.RectangleContainsScreenPoint(rt, screen, cam); } RectTransform SkillButton { get { if (skillButton == null && battle.Hud != null) { var t = battle.Hud.transform.Find("Info/SkillButton"); skillButton = t as RectTransform; } return skillButton; } } // ---------- 대상 ---------- Unit FromUnit(TutorialGuideRow s) { return plan != null && s.Target.kind == GuideTargetKind.Drag ? plan.UnitAt(s.Target.from) : null; } /// 끌기 안내의 쏠 곳(대상 슬롯의 지금 자리 또는 전장 좌표 점). Vector2 DragPoint(TutorialGuideRow s) { var t = s.Target; if (t.to <= 0) return t.point; Vector2 p; return SlotCenter(t.to, out p) ? p : t.point; } bool IsTargetUnit(TutorialGuideRow s, Unit u) { if (plan == null || s.Target.kind != GuideTargetKind.Slots) return false; foreach (var slot in s.Target.slots) if (plan.UnitAt(slot) == u) return true; return false; } bool SlotCenter(int slot, out Vector2 p) { p = Vector2.zero; if (plan == null) return false; var u = plan.UnitAt(slot); if (u != null) { p = u.Position; return u.IsAlive; } GimmickInstance g; if (gimmicks.TryGetValue(slot, out g) && !g.Removed) { p = g.Shape.Center; return true; } var r = plan.SlotRow(slot); if (r == null) return false; p = r.pos; return r.side == TutSide.Gimmick; // 배치 자리(기믹 연결이 없을 때) } /// 그 단계가 가리키는 전장 대상의 사각(전장 좌표 가운데·반 크기 · round = 유닛·원 기믹). void WorldTargets(TutorialGuideRow s, List centers, List halves, List rounds) { if (plan == null) return; var t = s.Target; var slots = new List(); if (t.kind == GuideTargetKind.Slots) slots.AddRange(t.slots); else if (t.kind == GuideTargetKind.Drag) { slots.Add(t.from); if (t.to > 0) slots.Add(t.to); } foreach (var slot in slots) { var u = plan.UnitAt(slot); if (u != null) { if (!u.IsAlive) continue; if (u.View != null && u.View.HasArt) { // 그림(발 = −0.55 R · 키 = ArtHeight) 전체를 감싼다 float h = u.ArtHeight + 0.3f; centers.Add(u.Position + new Vector2(0f, -u.Radius * 0.55f + u.ArtHeight * 0.5f)); halves.Add(new Vector2(Mathf.Max(u.Radius * 1.5f, h * 0.42f), h * 0.5f)); } else { centers.Add(u.Position); halves.Add(Vector2.one * u.Radius * 1.5f); } rounds.Add(true); continue; } GimmickInstance g; if (!gimmicks.TryGetValue(slot, out g) || g.Removed) continue; bool circle = g.Shape.Type == GimmickShapeType.Circle; centers.Add(g.Shape.Center); halves.Add(circle ? Vector2.one * g.Shape.R * 1.25f : g.Shape.Size * 0.5f + Vector2.one * 0.15f); rounds.Add(circle); } } /// UI 대상(남은 턴 · 스킬 버튼 · 편성 화면 출전 칸)의 캔버스 사각. bool UiTarget(TutorialGuideRow s, out Rect rect) { rect = new Rect(); if (s.Target.kind != GuideTargetKind.Ui || ui == null) return false; switch (s.Target.ui) { case "turn": if (!ui.TurnChipVisible) return false; rect = ui.UiRect(ui.TurnChip); return true; case "skill": var sb = SkillButton; if (sb == null || !sb.gameObject.activeInHierarchy) return false; rect = ui.UiRect(sb); return true; case "lineup": var root = OutGameRoot.Instance; if (root == null || root.Formation == null || root.Formation.Rt == null) return false; bool any = false; foreach (var rt in root.Formation.Rt.GetComponentsInChildren(false)) { string n = rt.name; if (n.Length != 5 || !n.StartsWith("Slot") || !char.IsDigit(n[4])) continue; var r = ui.UiRect(rt); rect = any ? Rect.MinMaxRect(Mathf.Min(rect.xMin, r.xMin), Mathf.Min(rect.yMin, r.yMin), Mathf.Max(rect.xMax, r.xMax), Mathf.Max(rect.yMax, r.yMax)) : r; any = true; } return any; } return false; } // ---------- 카메라 ---------- readonly List tmpC = new List(); readonly List tmpH = new List(); readonly List tmpR = new List(); /// 대상이 화면 밖이면 대상들의 가운데로 화면을 옮긴다. void FocusCamera(TutorialGuideRow s) { if (camCtrl == null || plan == null) return; tmpC.Clear(); tmpH.Clear(); tmpR.Clear(); WorldTargets(s, tmpC, tmpH, tmpR); if (s.Target.kind == GuideTargetKind.Drag && s.Target.to <= 0) { tmpC.Add(s.Target.point); tmpH.Add(Vector2.one * 0.5f); } if (tmpC.Count == 0) return; Vector2 min = tmpC[0] - tmpH[0], max = tmpC[0] + tmpH[0]; for (int i = 1; i < tmpC.Count; i++) { min = Vector2.Min(min, tmpC[i] - tmpH[i]); max = Vector2.Max(max, tmpC[i] + tmpH[i]); } var view = camCtrl.ViewRect; float mx = view.width * 0.08f, myTop = view.height * 0.16f, myBottom = view.height * 0.22f; // 위 턴 띠 · 아래 유닛 판 뒤로 가지 않게 if (min.x >= view.xMin + mx && max.x <= view.xMax - mx && min.y >= view.yMin + myBottom && max.y <= view.yMax - myTop) return; camCtrl.StopFollow(); camCtrl.FocusOn((min + max) * 0.5f - new Vector2(0f, (myBottom - myTop) * 0.5f)); // 쓸 수 있는 화면(위·아래 판 사이)의 가운데에 오게 movedCamera = true; } /// 아군(구출 대상 제외) 쪽으로 화면을 되돌린다(GameBootstrap 의 아군 턴 초점과 같은 식). void RestoreCamera() { movedCamera = false; if (camCtrl == null || battle.Phase != BattlePhase.PlayerTurn) return; Vector2 sum = Vector2.zero; int n = 0; foreach (var p in battle.AliveUnits(Faction.Player)) { if (p.Npc) continue; sum += p.Position; n++; } if (n > 0) camCtrl.FocusOn(sum / n + new Vector2(0f, battle.Config.cameraViewHeight * 0.2f)); } // ---------- 표시 ---------- /// 띠·카드·누름 막이(단계가 바뀔 때만). void RefreshInfo() { if (ui == null) return; if (active == null) { ui.SetBar(""); ui.SetCard(""); ui.SetBlocker(false); return; } if (active.mode == GuideMode.Popup) { ui.SetBar(""); ui.SetCard(active.textKo); ui.SetBlocker(true); return; } ui.SetCard(""); ui.SetBar(fired ? "" : (hint != null ? hint.textKo : active.textKo)); ui.SetBlocker(active.locked && (active.mode == GuideMode.Highlight || active.mode == GuideMode.Bar) && !WaitsForSkill(active)); } void RefreshTurnChip() { if (ui == null) return; var ph = battle.Phase; bool on = plan != null && plan.TurnLimit > 0 && (ph == BattlePhase.PlayerTurn || ph == BattlePhase.Resolving || ph == BattlePhase.EnemyTurn); ui.SetTurnsLeft(on ? "남은 턴 " + Mathf.Max(0, plan.TurnLimit - battle.TurnNumber + 1) : ""); } void Update() { if (ui == null) return; if (swallow && !Input.GetMouseButton(0) && !Input.GetMouseButtonUp(0)) swallow = false; PollBeforeBattle(); if (active != null) { float age = Time.unscaledTime - shownAt; bool down = Input.GetMouseButtonDown(0); switch (active.mode) { case GuideMode.Popup: if (down && age > MinCardSec) CloseActive(true, false); break; case GuideMode.Highlight: case GuideMode.Bar: if (WaitsForSkill(active)) break; if (down && age > MinTapSec) CloseActive(true, false); else if (age > Num("guide_auto_close_sec", 1.5f)) CloseActive(false, false); break; case GuideMode.Drag: case GuideMode.Tap: // 가리킨 유닛이 쓰러졌거나 이번 턴에 더 움직일 수 없으면 건너뛴다(잠금에 갇히지 않게) if (!activeOverlay && !fired && battle.Phase == BattlePhase.PlayerTurn && !TargetUsable(active)) CloseActive(false, false); break; } } else TryAdvance(); Draw(); } bool TargetUsable(TutorialGuideRow s) { if (s.mode == GuideMode.Drag) { var u = FromUnit(s); return u != null && u.IsAlive && battle.CanAct(u); } if (s.Target.kind != GuideTargetKind.Slots) return true; foreach (var slot in s.Target.slots) { var u = plan.UnitAt(slot); if (u != null && u.IsAlive) return true; } return false; } void Draw() { ui.BeginFrame(); var row = active; if (row != null && !(row.mode == GuideMode.Drag && fired)) { var shown = hint ?? row; float pulse = 1f + 0.06f * Mathf.Sin(Time.unscaledTime * 6f); tmpC.Clear(); tmpH.Clear(); tmpR.Clear(); WorldTargets(shown, tmpC, tmpH, tmpR); var rects = new List(); for (int i = 0; i < tmpC.Count; i++) rects.Add(ui.WorldRect(tmpC[i], tmpH[i])); Rect uiRect; bool hasUi = UiTarget(shown, out uiRect); if (hasUi) { rects.Add(uiRect); tmpR.Add(false); } bool dim = row.mode == GuideMode.Popup || (row.mode == GuideMode.Highlight && !aiming); if (dim) { if (rects.Count == 0) ui.Dim(Num("dim_alpha", 0.5f), null); else { var hole = rects[0]; for (int i = 1; i < rects.Count; i++) hole = Rect.MinMaxRect(Mathf.Min(hole.xMin, rects[i].xMin), Mathf.Min(hole.yMin, rects[i].yMin), Mathf.Max(hole.xMax, rects[i].xMax), Mathf.Max(hole.yMax, rects[i].yMax)); ui.Dim(Num("dim_alpha", 0.5f), Rect.MinMaxRect(hole.xMin - HolePad, hole.yMin - HolePad, hole.xMax + HolePad, hole.yMax + HolePad)); } } for (int i = 0; i < rects.Count; i++) ui.Frame(rects[i], tmpR[i], pulse); // 띠·카드가 가리키는 대상(과 당기는 손가락)을 덮지 않게 자리를 고른다 if (row.mode == GuideMode.Popup) { if (rects.Count == 0) ui.PlaceCard(0); else { float cy = 0f; foreach (var r in rects) cy += r.center.y; ui.PlaceCard(cy / rects.Count > -150f ? -1 : 1); } } else { bool low = row.mode == GuideMode.Drag; // 끄는 손가락은 화면 아래쪽의 유닛에서 출발한다 foreach (var r in rects) if (r.yMin < ui.BarZoneTop) low = true; ui.PlaceBar(low); } if (row.mode == GuideMode.Drag) DrawDrag(row); else if (row.mode == GuideMode.Tap && rects.Count > 0) { float press = 0.5f + 0.5f * Mathf.Sin(Time.unscaledTime * 6f); ui.Finger(rects[0].center, press, 1f); } } ui.EndFrame(); } void DrawDrag(TutorialGuideRow row) { var u = FromUnit(row); if (u == null || !u.IsAlive) return; Vector2 to = DragPoint(row); Vector2 dir = to - u.Position; if (dir.sqrMagnitude < 1e-4f) return; dir.Normalize(); if (row.Target.to <= 0) { var r = ui.WorldRect(to, Vector2.one * u.Radius); ui.AimEnd(r.center, Mathf.Max(r.width, r.height)); // 점 목표 = 조준선 끝 고리(슬롯 목표는 테두리가 이미 있다) } if (aiming) return; // 유닛을 잡고 있는 동안 = 손가락 숨김(조준 화살표가 보인다) // 게이지 조작(PD 2026-11-16): 손가락은 유닛에서 목표 쪽으로 끈다(끈 거리는 방향만 정하므로 목표를 넘지 않게) float pull = Mathf.Min(SkillMods.SlingMax(u) * Num("finger_pull_ratio", 1f), Vector2.Distance(to, u.Position)); Vector2 a = ui.ToCanvas(u.Position); Vector2 b = ClampToward(a, ui.ToCanvas(u.Position + dir * pull), ui.SafeRect); float cycle = Mathf.Max(0.3f, Num("finger_cycle_sec", 1.6f)); float t = ((Time.unscaledTime - shownAt) % cycle) / cycle; // 0~0.15 누름 · ~0.7 끌기 · ~0.85 멈춤 · ~1 놓음 float k = t < 0.15f ? 0f : t < 0.7f ? Mathf.SmoothStep(0f, 1f, (t - 0.15f) / 0.55f) : 1f; float alpha = t < 0.08f ? t / 0.08f : t > 0.88f ? 1f - (t - 0.88f) / 0.12f : 1f; Vector2 p = Vector2.Lerp(a, b, k); if (k > 0.02f) ui.Line(a, p, alpha); ui.Finger(p, t < 0.85f ? 1f : 0f, alpha); } /// b 가 범위 밖이면 a 쪽으로 당겨 범위 안에 넣는다(a 가 밖이면 그대로). static Vector2 ClampToward(Vector2 a, Vector2 b, Rect r) { if (r.Contains(b) || !r.Contains(a)) return b; float lo = 0f, hi = 1f; for (int i = 0; i < 12; i++) { float mid = (lo + hi) * 0.5f; if (r.Contains(Vector2.Lerp(a, b, mid))) lo = mid; else hi = mid; } return Vector2.Lerp(a, b, lo); } // ---------- 편성 화면 안내(before_battle) ---------- /// 전투 밖에서 편성 화면이 열려 있으면, 다음에 깰 판의 before_battle 안내를 한 번 띄운다(그 판을 깨기 전 · 앱을 켠 동안 1회). void PollBeforeBattle() { if (active != null || overlay.Count > 0 || battle.Phase != BattlePhase.Setup || !TutorialRules.Enabled) return; var root = OutGameRoot.Instance; if (root == null || root.Formation == null || root.Formation.Rt == null || !root.Formation.Rt.gameObject.activeInHierarchy) return; var db = TutorialTables.Db; if (db == null || battle.Config == null) return; BalanceConfig.StageDef next = null; foreach (var st in battle.Config.stages) { if (TutorialRules.Cleared(st.chapter, st.stage)) continue; next = st; break; } if (next == null) return; string key = next.chapter + "-" + next.stage; if (key == beforeChecked) return; beforeChecked = key; if (!beforeShown.Add(key)) return; foreach (var g in db.Guide(next.chapter, next.stage)) if (g.trigger == GuideTrigger.BeforeBattle) overlay.Enqueue(g); TryAdvance(); } } }