2026-11-17 07:27:22 +00:00
using System.Collections.Generic ;
using TKS.OutGame ;
using UnityEngine ;
namespace TKS
{
/// <summary>
/// 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) 중에는 아무 사건도 받지 않는다.
/// </summary>
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 < TutorialGuideRow > steps = new List < TutorialGuideRow > ( ) ;
readonly List < TutorialGuideRow > failSteps = new List < TutorialGuideRow > ( ) ;
readonly Queue < TutorialGuideRow > overlay = new Queue < TutorialGuideRow > ( ) ; // 결말 · 실패 · 편성 화면 안내
readonly List < Evt > happened = new List < Evt > ( ) ;
readonly Dictionary < int , GimmickInstance > gimmicks = new Dictionary < int , GimmickInstance > ( ) ;
readonly HashSet < string > beforeShown = new HashSet < string > ( ) ;
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 ; }
}
/// <summary>조준 안내가 떠 있으면 그 단계.</summary>
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 < TutorialDirector > ( ) ;
d . Init ( bm ) ;
return d ;
}
void Init ( BattleManager bm )
{
Current = this ;
battle = bm ;
cam = Camera . main ;
camCtrl = cam ! = null ? cam . GetComponent < CameraController > ( ) : 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 ;
}
// ---------- 판 시작 ----------
/// <summary>전투 시작(BattleManager.Begin · 유닛·기믹 배치 뒤 · 첫 턴 전). p = 그 판의 학습 판 계획(null = 일반 판).</summary>
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 ) ;
2026-11-19 09:05:17 +00:00
var rows = p . Guide ( ) ; // 연의 전기 막 = 덮어쓴 문구(Resources/Scenario/scenario_guide.csv)
2026-11-17 07:27:22 +00:00
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 } ) ;
}
/// <summary>보스 등장 연출(C2)이 시작될 때 부른다 — 끝나면 NotifyBossIntroEnd. 부르지 않으면 첫 아군 턴에 boss_intro_end 로 본다.</summary>
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 ) ;
}
/// <summary>유닛을 골랐다(SlingshotInput.Select).</summary>
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 ( ) ;
}
/// <summary>당기다가 쏘지 않고 손을 뗐다.</summary>
public void OnAimCancelled ( )
{
if ( ! aiming ) return ;
aiming = false ;
hint = null ;
RefreshInfo ( ) ;
}
/// <summary>스킬 버튼을 눌렀다.</summary>
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 ;
}
/// <summary>그 단계의 조건을 채운 사건 위치(없으면 − 1 · after_step = − 2).</summary>
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 ;
}
/// <summary>턴이 지나 더는 일어날 수 없는 단계(건너뜀).</summary>
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 ;
2026-11-19 09:05:17 +00:00
if ( ScenarioEvent . Running ) return ; // 연출 중에는 안내를 띄우지 않는다(연출이 끝나면 다음 Update · Poll 에서 띄움 · 2026-11-19 적 턴 연출 뒤 반격 카드)
2026-11-17 07:27:22 +00:00
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 )
{
2026-11-19 09:05:17 +00:00
// 아군 턴까지 기다림 — 적 턴 시작 카드(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 ;
2026-11-17 07:27:22 +00:00
if ( at > = 0 ) happened . RemoveRange ( 0 , at + 1 ) ;
Show ( s , false ) ;
return ;
}
if ( ! Stale ( s ) ) return ;
index + + ;
}
}
2026-11-19 09:05:17 +00:00
/// <summary>떠 있는 안내가 없으면 지금 띄울 안내를 찾는다(BattleManager 적 턴 — 연출 직후 카드가 같은 프레임에 뜨게).</summary>
public void Poll ( )
{
if ( active ! = null ) return ;
enemyGate = true ;
TryAdvance ( ) ;
enemyGate = false ;
}
bool enemyGate ;
/// <summary>
/// 끌기 시범(카드 + 끌기 대상 slot:A>slot:B · 2026-11-19 PD 「화살표를 끌어 당기는 연출을 함께」) — SlingshotInput 이 실제 조준 화살표 · 게이지로 그린다.
/// k = 끈 정도(0~1 · 손가락과 같은 주기) · gaugeSec = 화살표가 뜬 뒤 흐른 시간(게이지 표시선).
/// </summary>
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 ;
}
/// <summary>시범 주기 안의 끈 정도 — 0~0.15 누름 · ~0.6 끌기 · ~0.9 멈춤(게이지가 오감) · ~1 놓음.</summary>
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 ;
}
2026-11-17 07:27:22 +00:00
void Show ( TutorialGuideRow s , bool isOverlay )
{
active = s ;
activeOverlay = isOverlay ;
hint = null ;
aiming = fired = false ;
shownAt = Time . unscaledTime ;
FocusCamera ( s ) ;
2026-11-19 09:05:17 +00:00
refocus = true ; // 다음 프레임에 한 번 더 — 같은 순간 아군 턴 시작 초점(GameBootstrap)이 덮어쓰지 않게(2026-11-19 PD 「포커싱이 끝나야 카메라가 이동」)
2026-11-17 07:27:22 +00:00
RefreshInfo ( ) ;
}
2026-11-19 09:05:17 +00:00
bool refocus ;
2026-11-17 07:27:22 +00:00
/// <summary>byTap = 화면을 눌러 닫음(그 누름이 전장 조작으로 새지 않게) · byAction = 끌기 안내의 행동이 끝나 닫힘.</summary>
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 ( ) ;
}
/// <summary>테스트·검증 캡처: 화면을 누른 것처럼 지금 안내(카드 · 강조 · 띠)를 닫는다.</summary>
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 이 물어봄) ----------
/// <summary>화면 누름을 전장 조작·결과 넘기기로 보내지 않는다(카드 · 잠긴 강조·띠 · 방금 탭으로 닫은 누름).</summary>
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 ) ;
}
}
/// <summary>잠금 안내가 떠 있다(가리킨 것만 누를 수 있다 · 화면 끌기·확대 막힘).</summary>
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" ;
}
/// <summary>잠금 안내 중 이 누름을 받아도 되는가 — under = 누른 자리의 아군 유닛(없으면 null).</summary>
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 ;
}
/// <summary>
2026-11-19 09:05:17 +00:00
/// 잠긴 끌기 안내 중 snap 단계(연의 scenario_guide b_snap)만 — 어느 쪽으로 끌어도 **방향만** 목표로 맞춘다 · 세기 = 플레이어가 당긴 그대로 ·
/// 그 밖의 잠긴 끌기 = 맞추지 않음(자연스러운 좌우 조준 · 발사는 허용 각도 안만 = AllowShot)
/// (2026-11-18 PD 「항상 플레이어가 조작할 유닛의 슬링샷 파워는 제약 없이 조절이 가능해야 해」 — 그 전 = 표 drag_lock_shot_pull 세기로 고정 →
/// 1막 시작처럼 적과 가까울 때 화살표 세기를 늘릴 수 없었음).
2026-11-17 07:27:22 +00:00
/// </summary>
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 ;
2026-11-19 09:05:17 +00:00
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 「정해진 방향으로 무조건 쏠 수 있도록 유도」) · 각도 검사 없음
2026-11-17 07:27:22 +00:00
float max = SkillMods . SlingMax ( u ) ;
2026-11-19 09:05:17 +00:00
if ( aim . magnitude < max * MinPull - 0.01f ) return target ; // 덜 당김 = 그대로 보여 주고 발사는 거부
return u . Position + want . normalized * aim . magnitude ; // 전장 안으로 자르지 않음 = 가장자리에서도 세기를 끝까지(벽에 닿으면 이동 처리가 튕김 · 2026-11-19 PD 「화면 가장자리에서는 슬롯 파워를 세게 할 수 없음」)
2026-11-17 07:27:22 +00:00
}
/// <summary>이 발사를 허용하는가 — 잠긴 끌기 안내 = 그 유닛 · 목표 방향 · 최소 당김 이상 / 그 밖의 잠금 안내 = 발사 불가.</summary>
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 ;
2026-11-19 09:05:17 +00:00
Vector2 full = u . Position + aim . normalized * SkillMods . SlingMax ( u ) ; // 최소 당김 = 최대 거리 기준(전장 끝으로 줄이지 않음)
return aim . magnitude > = Vector2 . Distance ( full , u . Position ) * MinPull - 0.02f ;
}
/// <summary>지금 잠긴 끌기 단계의 최소 당김 — 단계 값(연의 f_min_pull)이 있으면 그것 · 없으면 표 drag_lock_min_pull.</summary>
float MinPull
{
get { return active ! = null & & active . minPull > = 0f ? active . minPull : Num ( "drag_lock_min_pull" , 0f ) ; }
2026-11-17 07:27:22 +00:00
}
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 ;
}
/// <summary>끌기 안내의 쏠 곳(대상 슬롯의 지금 자리 또는 전장 좌표 점).</summary>
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 ; // 배치 자리(기믹 연결이 없을 때)
}
/// <summary>그 단계가 가리키는 전장 대상의 사각(전장 좌표 가운데·반 크기 · round = 유닛·원 기믹).</summary>
void WorldTargets ( TutorialGuideRow s , List < Vector2 > centers , List < Vector2 > halves , List < bool > rounds )
{
if ( plan = = null ) return ;
var t = s . Target ;
var slots = new List < int > ( ) ;
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 ) ;
}
}
/// <summary>UI 대상(남은 턴 · 스킬 버튼 · 편성 화면 출전 칸)의 캔버스 사각.</summary>
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 < RectTransform > ( 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 < Vector2 > tmpC = new List < Vector2 > ( ) ;
readonly List < Vector2 > tmpH = new List < Vector2 > ( ) ;
readonly List < bool > tmpR = new List < bool > ( ) ;
/// <summary>대상이 화면 밖이면 대상들의 가운데로 화면을 옮긴다.</summary>
2026-11-19 09:05:17 +00:00
/// <summary>force = 이미 가운데여도 초점을 다시 건다(다른 곳이 같은 프레임에 초점을 옮겼을 수 있음).</summary>
void FocusCamera ( TutorialGuideRow s , bool force = false )
2026-11-17 07:27:22 +00:00
{
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 09:05:17 +00:00
// 위 턴 띠 · 유닛 판(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 ;
2026-11-17 07:27:22 +00:00
camCtrl . StopFollow ( ) ;
2026-11-19 09:05:17 +00:00
if ( widen ) camCtrl . ZoomTo ( h , goal ) ; // 기준점 = 새 가운데(초점 이동과 함께 그 자리로 모임)
camCtrl . FocusOn ( goal ) ;
2026-11-17 07:27:22 +00:00
movedCamera = true ;
}
/// <summary>아군(구출 대상 제외) 쪽으로 화면을 되돌린다(GameBootstrap 의 아군 턴 초점과 같은 식).</summary>
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 ) )
{
2026-11-19 09:05:17 +00:00
if ( p . Npc | | ScenarioEvent . Absent ( p ) ) continue ;
2026-11-17 07:27:22 +00:00
sum + = p . Position ;
n + + ;
}
if ( n > 0 ) camCtrl . FocusOn ( sum / n + new Vector2 ( 0f , battle . Config . cameraViewHeight * 0.2f ) ) ;
}
// ---------- 표시 ----------
/// <summary>띠·카드·누름 막이(단계가 바뀔 때만).</summary>
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 ( "" ) ;
2026-11-19 09:05:17 +00:00
// 끌기 안내 = 그 유닛을 누르고 있는 동안(aiming) 띠를 걷음 · 쏘지 않고 놓으면(OnAimCancelled) 다시(2026-11-19 PD 「장비를 터치한 상태가 되면 제거 · 터치 해제 상태로 전환할 경우에만」)
bool holding = aiming & & active . mode = = GuideMode . Drag ;
ui . SetBar ( fired ? "" : hint ! = null ? hint . textKo : holding ? "" : active . textKo ) ;
2026-11-17 07:27:22 +00:00
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 ( ) ;
2026-11-19 09:05:17 +00:00
if ( refocus )
{
refocus = false ;
if ( active ! = null & & ! activeOverlay ) FocusCamera ( active , true ) ;
}
2026-11-17 07:27:22 +00:00
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 < Rect > ( ) ;
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 ) ;
2026-11-19 09:05:17 +00:00
else ui . PlaceCard ( PickCard ( rects ) ) ; // 대상(특히 첫 대상 = 조작할 유닛)을 덮지 않는 자리(2026-11-19 PD 「튜토리얼이 핵심적으로 조작해야 할 유닛을 가리지 않도록」)
2026-11-17 07:27:22 +00:00
}
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 ) ;
2026-11-19 09:05:17 +00:00
else if ( row . mode = = GuideMode . Popup ) DrawDemoFinger ( ) ; // 카드 + 끌기 시범 = 손가락(화살표 · 게이지 = SlingshotInput)
2026-11-17 07:27:22 +00:00
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 ( ) ;
}
2026-11-19 09:05:17 +00:00
/// <summary>카드 자리 고르기 — 맨 위(낮은 카드) → 아래 → 위 → 가운데 순으로, 1차 = 대상 전부를 덮지 않는 곳 · 2차 = 첫 대상(조작할 유닛 · 끌기 시작 유닛)만 덮지 않는 곳 · 없으면 맨 위.</summary>
int PickCard ( List < Rect > 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 } ;
2026-11-17 07:27:22 +00:00
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 ) ;
}
2026-11-19 09:05:17 +00:00
/// <summary>끌기 시범의 손가락 — 유닛을 누르고 목표 쪽으로 끔(화살표 끝까지 · 놓을 때 사라짐).</summary>
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 ) ;
}
/// <summary>시범에서 끝까지 끌었을 때 유닛 → 화살표 끝(목표 쪽 · 최대 거리와 목표 거리 중 짧은 쪽).</summary>
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 ) ) ;
}
2026-11-17 07:27:22 +00:00
/// <summary>b 가 범위 밖이면 a 쪽으로 당겨 범위 안에 넣는다(a 가 밖이면 그대로).</summary>
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) ----------
/// <summary>전투 밖에서 편성 화면이 열려 있으면, 다음에 깰 판의 before_battle 안내를 한 번 띄운다(그 판을 깨기 전 · 앱을 켠 동안 1회).</summary>
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 ( ) ;
}
}
}