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; } 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.Guide(); // 연의 전기 막 = 덮어쓴 문구(Resources/Scenario/scenario_guide.csv) 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; if (ScenarioEvent.Running) return; // 연출 중에는 안내를 띄우지 않는다(연출이 끝나면 다음 Update · Poll 에서 띄움 · 2026-11-19 적 턴 연출 뒤 반격 카드) 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) { // 아군 턴까지 기다림 — 적 턴 시작 카드(enemy_turn popup)만 적 턴에 바로 띄움(적은 BattleManager 에서 카드가 닫힐 때까지 기다림 · 2026-11-19 연의 1막 반격 카드가 2턴에야 뜨던 문제) bool enemyCard = enemyGate && s.trigger == GuideTrigger.EnemyTurn && s.mode == GuideMode.Popup && ph == BattlePhase.EnemyTurn; // 적 턴 연출(enemy_turn)이 끝난 뒤 BattleManager 가 Poll 로 부를 때만 if (NeedsPlayerTurn(s) && ph != BattlePhase.PlayerTurn && !enemyCard) return; if (at >= 0) happened.RemoveRange(0, at + 1); Show(s, false); return; } if (!Stale(s)) return; index++; } } /// 떠 있는 안내가 없으면 지금 띄울 안내를 찾는다(BattleManager 적 턴 — 연출 직후 카드가 같은 프레임에 뜨게). public void Poll() { if (active != null) return; enemyGate = true; TryAdvance(); enemyGate = false; } bool enemyGate; /// /// 끌기 시범(카드 + 끌기 대상 slot:A>slot:B · 2026-11-19 PD 「화살표를 끌어 당기는 연출을 함께」) — SlingshotInput 이 실제 조준 화살표 · 게이지로 그린다. /// k = 끈 정도(0~1 · 손가락과 같은 주기) · gaugeSec = 화살표가 뜬 뒤 흐른 시간(게이지 표시선). /// public bool DemoAim(out Unit u, out Vector2 to, out float k, out float gaugeSec) { u = null; to = Vector2.zero; k = gaugeSec = 0f; if (active == null || active.mode != GuideMode.Popup || active.Target.kind != GuideTargetKind.Drag) return false; u = FromUnit(active); if (u == null || !u.IsAlive) return false; to = DragPoint(active); float cycle = Mathf.Max(0.3f, ScenarioData.EvCfg("guide_demo_cycle_sec")); // 표 = scenario_event_config.csv(연의 전기 F5 로 다시 읽힘) float t = ((Time.unscaledTime - shownAt) % cycle) / cycle; k = DemoPull(t); gaugeSec = t < 0.15f ? 0f : (t - 0.15f) * cycle; return true; } /// 시범 주기 안의 끈 정도 — 0~0.15 누름 · ~0.6 끌기 · ~0.9 멈춤(게이지가 오감) · ~1 놓음. static float DemoPull(float t) { return t < 0.15f ? 0f : t < 0.6f ? Mathf.SmoothStep(0f, 1f, (t - 0.15f) / 0.45f) : t < 0.9f ? 1f : 0f; } void Show(TutorialGuideRow s, bool isOverlay) { active = s; activeOverlay = isOverlay; hint = null; aiming = fired = false; shownAt = Time.unscaledTime; FocusCamera(s); refocus = true; // 다음 프레임에 한 번 더 — 같은 순간 아군 턴 시작 초점(GameBootstrap)이 덮어쓰지 않게(2026-11-19 PD 「포커싱이 끝나야 카메라가 이동」) RefreshInfo(); } bool refocus; /// 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; } /// /// 잠긴 끌기 안내 중 snap 단계(연의 scenario_guide b_snap)만 — 어느 쪽으로 끌어도 **방향만** 목표로 맞춘다 · 세기 = 플레이어가 당긴 그대로 · /// 그 밖의 잠긴 끌기 = 맞추지 않음(자연스러운 좌우 조준 · 발사는 허용 각도 안만 = AllowShot) /// (2026-11-18 PD 「항상 플레이어가 조작할 유닛의 슬링샷 파워는 제약 없이 조절이 가능해야 해」 — 그 전 = 표 drag_lock_shot_pull 세기로 고정 → /// 1막 시작처럼 적과 가까울 때 화살표 세기를 늘릴 수 없었음). /// 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 (!active.snap) { // 조준 범위(f_aim_deg) = 목표 방향 ± 도 안에서만 — 밖으로 끌면 가장자리에 머묾(엉뚱한 방향 돌진으로 안내한 적이 바뀌지 않게 · 2026-11-19 PD) · 0 = 그대로 if (active.aimDeg <= 0f) return target; // 맞춤 없음(2026-11-18 PD 「적이 근접할 때 화살표가 좌우로 자연스럽지 않고 특정 자리에 붙음」) float ang = Vector2.SignedAngle(want, aim); if (Mathf.Abs(ang) <= active.aimDeg) return target; Vector2 edge = Quaternion.Euler(0f, 0f, Mathf.Sign(ang) * active.aimDeg) * want.normalized; return u.Position + edge * aim.magnitude; // 전장 안으로 자르지 않음 = 가장자리에서도 세기를 끝까지(벽에 닿으면 이동 처리가 튕김 · 2026-11-19 PD 「화면 가장자리에서는 슬롯 파워를 세게 할 수 없음」) } // snap 단계 = 어느 쪽으로 끌어도 목표 방향(2026-11-18 PD 「정해진 방향으로 무조건 쏠 수 있도록 유도」) · 각도 검사 없음 float max = SkillMods.SlingMax(u); if (aim.magnitude < max * MinPull - 0.01f) return target; // 덜 당김 = 그대로 보여 주고 발사는 거부 return u.Position + want.normalized * aim.magnitude; // 전장 안으로 자르지 않음 = 가장자리에서도 세기를 끝까지(벽에 닿으면 이동 처리가 튕김 · 2026-11-19 PD 「화면 가장자리에서는 슬롯 파워를 세게 할 수 없음」) } /// 이 발사를 허용하는가 — 잠긴 끌기 안내 = 그 유닛 · 목표 방향 · 최소 당김 이상 / 그 밖의 잠금 안내 = 발사 불가. 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 = u.Position + aim.normalized * SkillMods.SlingMax(u); // 최소 당김 = 최대 거리 기준(전장 끝으로 줄이지 않음) return aim.magnitude >= Vector2.Distance(full, u.Position) * MinPull - 0.02f; } /// 지금 잠긴 끌기 단계의 최소 당김 — 단계 값(연의 f_min_pull)이 있으면 그것 · 없으면 표 drag_lock_min_pull. float MinPull { get { return active != null && active.minPull >= 0f ? active.minPull : Num("drag_lock_min_pull", 0f); } } 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(); /// 대상이 화면 밖이면 대상들의 가운데로 화면을 옮긴다. /// force = 이미 가운데여도 초점을 다시 건다(다른 곳이 같은 프레임에 초점을 옮겼을 수 있음). void FocusCamera(TutorialGuideRow s, bool force = false) { 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; // 위 턴 띠 · 유닛 판(2026-11-19 위로 옮김) · 맨 위 카드(끌기 시범) · 위 띠(끌기 안내 = 유닛 판 아래) · 아래 패시브 글자 뒤로 가지 않게 bool deepTop = s.mode == GuideMode.Drag || (s.mode == GuideMode.Popup && s.Target.kind == GuideTargetKind.Drag); float topF = deepTop ? 0.35f : 0.27f, botF = 0.14f, sideF = 0.08f; // 대상 전체 = 쓸 수 있는 화면(위 · 아래 판 사이) 가운데 · 다 안 들어가면 그만큼 넓힘(넓히기만) — 대상이 화면 안이어도 한쪽에 치우쳐 아래 · 위가 쓸데없이 보이지 않게 // (2026-11-19 PD 「관우가 바위를 쳐서 황건적을 공격하는 상황을 알 수 있게 · 슬링샷 구도가 하단을 쓸데없이 너무 많이 노출」 · 그 전 = 화면 안이면 그대로) float aspect = view.width / Mathf.Max(0.01f, view.height); float needH = Mathf.Max((max.y - min.y) / Mathf.Max(0.2f, 1f - topF - botF), (max.x - min.x) / Mathf.Max(0.2f, (1f - 2f * sideF) * aspect)); float h = Mathf.Max(view.height, needH); Vector2 goal = (min + max) * 0.5f - new Vector2(0f, (botF - topF) * h * 0.5f); bool widen = h > view.height + 0.01f; if (!widen && !force && Vector2.Distance(goal, view.center) < 0.3f) return; camCtrl.StopFollow(); if (widen) camCtrl.ZoomTo(h, goal); // 기준점 = 새 가운데(초점 이동과 함께 그 자리로 모임) camCtrl.FocusOn(goal); 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 || ScenarioEvent.Absent(p)) 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(""); // 끌기 안내 = 그 유닛을 누르고 있는 동안(aiming) 띠를 걷음 · 쏘지 않고 놓으면(OnAimCancelled) 다시(2026-11-19 PD 「장비를 터치한 상태가 되면 제거 · 터치 해제 상태로 전환할 경우에만」) bool holding = aiming && active.mode == GuideMode.Drag; ui.SetBar(fired ? "" : hint != null ? hint.textKo : holding ? "" : 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 (refocus) { refocus = false; if (active != null && !activeOverlay) FocusCamera(active, true); } 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 ui.PlaceCard(PickCard(rects)); // 대상(특히 첫 대상 = 조작할 유닛)을 덮지 않는 자리(2026-11-19 PD 「튜토리얼이 핵심적으로 조작해야 할 유닛을 가리지 않도록」) } 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.Popup) DrawDemoFinger(); // 카드 + 끌기 시범 = 손가락(화살표 · 게이지 = SlingshotInput) 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(); } /// 카드 자리 고르기 — 맨 위(낮은 카드) → 아래 → 위 → 가운데 순으로, 1차 = 대상 전부를 덮지 않는 곳 · 2차 = 첫 대상(조작할 유닛 · 끌기 시작 유닛)만 덮지 않는 곳 · 없으면 맨 위. int PickCard(List rects) { for (int pass = 0; pass < 2; pass++) foreach (int w in CardOrder) { var cr = ui.CardRect(w); int n = pass == 0 ? rects.Count : 1; bool hit = false; for (int i = 0; i < n && !hit; i++) { var r = rects[i]; if (Rect.MinMaxRect(r.xMin - HolePad, r.yMin - HolePad, r.xMax + HolePad, r.yMax + HolePad).Overlaps(cr)) hit = true; } if (!hit) return w; } return 2; } static readonly int[] CardOrder = { 2, -1, 1, 0 }; 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); } /// 끌기 시범의 손가락 — 유닛을 누르고 목표 쪽으로 끔(화살표 끝까지 · 놓을 때 사라짐). void DrawDemoFinger() { Unit u; Vector2 to; float k, gs; if (!DemoAim(out u, out to, out k, out gs)) return; Vector2 a = ui.ToCanvas(u.Position); // 손가락 끝 = 그 화살표를 만드는 실제 손가락 자리(끌기 조준 = 화살표 ÷ drag_gain + 조준 시작 반경 · 게이지 조작 = 방향만 → 표 finger_pull_ratio) Vector2 reach = DemoReach(u, to); float rl = reach.magnitude; if (rl < 1e-4f) return; float fl = AimRules.DragMode ? rl / Mathf.Max(0.01f, IbUi.Num("drag_gain", 2f)) + u.Radius * battle.Config.aimStartRadiusRatio : Mathf.Min(SkillMods.SlingMax(u) * Num("finger_pull_ratio", 1f), rl); Vector2 b = ClampToward(a, ui.ToCanvas(u.Position + reach / rl * fl), ui.SafeRect); float cycle = Mathf.Max(0.3f, ScenarioData.EvCfg("guide_demo_cycle_sec")); float t = ((Time.unscaledTime - shownAt) % cycle) / cycle; if (t >= 0.9f) return; // 놓음 float alpha = t < 0.08f ? t / 0.08f : 1f; ui.Finger(Vector2.Lerp(a, b, k), 1f, alpha); } /// 시범에서 끝까지 끌었을 때 유닛 → 화살표 끝(목표 쪽 · 최대 거리와 목표 거리 중 짧은 쪽). public static Vector2 DemoReach(Unit u, Vector2 to) { Vector2 d = to - u.Position; float len = d.magnitude; if (len < 1e-4f) return Vector2.zero; return d / len * Mathf.Min(len, SkillMods.SlingMax(u)); } /// 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(); } } }