using System; using System.Collections.Generic; using System.Globalization; using UnityEngine; namespace TKS { public enum TutSide { Ally = 0, // 조작하는 아군(고정 시작 자리) Npc = 1, // 구출 대상(조작 불가 · 반격 없음 · 적 AI 의 표적) Enemy = 2, Gimmick = 3 // 기믹(배치 = stage_gimmicks.csv 로 나가고, 여기서는 안내가 가리킬 슬롯 자리만 쓴다) } public enum GuideTrigger { StageStart = 0, // 전투 시작(보스 판이면 보스 연출 전) · 첫 아군 턴 AfterStep = 1, // 바로 앞 단계가 닫힌 직후 UnitSelect = 2, // 아군을 고른 순간(대상이 slot 이면 그 유닛) ActionEnd = 3, // 아군 행동이 끝난 직후(n_turn 이 0 이 아니면 그 턴에서만) EnemyTurn = 4, // 적 턴 시작(n_turn 턴) TurnStart = 5, // n_turn 번째 아군 턴 시작 BossIntroEnd = 6, // 보스 등장 연출이 끝난 직후 BeforeBattle = 7, // 그 판을 앞두고 편성 화면이 열린 순간 Fail = 8 // 실패 판정 직후(결과 화면 위) } public enum GuideMode { Popup = 0, // 가운데 카드(탭으로 닫음) Drag = 1, // 손가락 끌기(그 행동이 끝나면 닫힘) Tap = 2, // 손가락 누름 Highlight = 3, // 주변 어둡게 + 대상 테두리 Bar = 4 // 아래 띠 } public enum GuideTargetKind { None = 0, Slots = 1, // slot:N;slot:M Drag = 2, // slot:A>slot:B · slot:A>xy:x,y Ui = 3 // ui:turn · ui:skill · ui:lineup } /// 안내가 가리키는 것(tutorial_guide.csv s_target 해석 결과). public class GuideTarget { public GuideTargetKind kind; public int[] slots = new int[0]; public int from; public int to; // 0 = 점(point) public Vector2 point; public string ui = ""; public static readonly string[] UiKeys = { "turn", "skill", "lineup" }; /// 형식 오류면 null(why 에 이유). public static GuideTarget Parse(string raw, out string why) { why = null; var t = new GuideTarget(); raw = raw == null ? "" : raw.Trim(); if (raw.Length == 0) return t; if (raw.StartsWith("ui:")) { t.kind = GuideTargetKind.Ui; t.ui = raw.Substring(3).Trim(); if (Array.IndexOf(UiKeys, t.ui) < 0) { why = "ui: 뒤는 " + string.Join("·", UiKeys) + " 중 하나(「" + raw + "」)"; return null; } return t; } int gt = raw.IndexOf('>'); if (gt >= 0) { t.kind = GuideTargetKind.Drag; if (!Slot(raw.Substring(0, gt), out t.from)) { why = "끌기 시작은 slot:N(「" + raw + "」)"; return null; } string to = raw.Substring(gt + 1).Trim(); if (to.StartsWith("xy:")) { var f = to.Substring(3).Split(','); float x, y; if (f.Length != 2 || !Num(f[0], out x) || !Num(f[1], out y)) { why = "끌기 끝 점은 xy:x,y(「" + raw + "」)"; return null; } t.point = new Vector2(x, y); } else if (!Slot(to, out t.to)) { why = "끌기 끝은 slot:N 또는 xy:x,y(「" + raw + "」)"; return null; } return t; } t.kind = GuideTargetKind.Slots; var list = new List(); foreach (var part in raw.Split(';')) { int n; if (!Slot(part, out n)) { why = "대상은 slot:N(여럿 = ;) · slot:A>slot:B · slot:A>xy:x,y · ui:키(「" + raw + "」)"; return null; } list.Add(n); } t.slots = list.ToArray(); return t; } static bool Slot(string s, out int n) { n = 0; s = s.Trim(); return s.StartsWith("slot:") && int.TryParse(s.Substring(5).Trim(), NumberStyles.Integer, CultureInfo.InvariantCulture, out n) && n > 0; } static bool Num(string s, out float v) { return float.TryParse(s.Trim(), NumberStyles.Float, CultureInfo.InvariantCulture, out v); } /// 이 대상이 참조하는 슬롯 번호 전부. public IEnumerable AllSlots() { if (kind == GuideTargetKind.Slots) foreach (var s in slots) yield return s; if (kind == GuideTargetKind.Drag) { yield return from; if (to > 0) yield return to; } } } /// 1장 학습 판 1행(tutorial_stage.csv) + 임포트 때 만든 그 판의 적 편성(배치 표 좌표·배율 · 세력 그림 · 무장 정보). [Serializable] public class TutorialStageRow { public int chapter; public int stage; [Tooltip("고정 편성 영웅 id(비면 자유 편성 = 출전 프리셋)")] public string[] lineup = new string[0]; public string[] npcs = new string[0]; [Tooltip("0 = 제한 없음 · n = n 턴을 마치면 실패")] public int turnLimit; [Tooltip("1 = 아군·구출 대상 체력이 최소 체력 아래로 내려가지 않는다(실패 없음)")] public bool noDefeat; public string learnKo = ""; public string winKo = ""; public string loseKo = ""; [Tooltip("클리어 뒤 결말 카드 문장(비면 없음)")] public string clearKo = ""; public List enemies = new List(); public bool FixedLineup { get { return lineup != null && lineup.Length > 0; } } } [Serializable] public class TutorialEnemy { public int slot; public BalanceConfig.EnemySpawn spawn = new BalanceConfig.EnemySpawn(); } /// 배치 1행(tutorial_layout.csv · 전장 좌표 = 가운데 0,0 · 위 = 적). [Serializable] public class TutorialLayoutRow { public int chapter; public int stage; public int slot; public TutSide side; [Tooltip("ally·npc = heroes.csv 영웅 id · enemy 무장 = generals.csv id · 병사 = 빈칸")] public string unitId = ""; public UnitType type; public string gimmickId = ""; public Vector2 pos; public float hpMult = 1f; public float atkMult = 1f; public bool boss; public bool general; public int line; } /// 안내 1단계(tutorial_guide.csv). [Serializable] public class TutorialGuideRow { public int chapter; public int stage; public int step; public GuideTrigger trigger; public int turn; public string targetRaw = ""; public GuideMode mode; public bool locked; public string textKo = ""; public int line; [NonSerialized] GuideTarget target; public GuideTarget Target { get { if (target == null) { string why; target = GuideTarget.Parse(targetRaw, out why) ?? new GuideTarget(); } return target; } } } [Serializable] public class TutorialConfigEntry { public string key = ""; public float value; } public static class TutorialTables { public const string Folder = "Data/Stages"; // Assets/ 아래 public static readonly string[] Files = { "tutorial_stage.csv", "tutorial_layout.csv", "tutorial_guide.csv", "tutorial_config.csv" }; public const string ResourcesPath = "Tutorial/TutorialDb"; /// 코드가 읽는 설정 키(임포트 때 표에 있는지 확인). public static readonly string[] ConfigKeys = { "matchup_mark_chapter", "matchup_mark_stage", "guide_auto_close_sec", "drag_lock_angle_deg", "drag_lock_min_pull", "drag_lock_shot_pull", "finger_cycle_sec", "finger_pull_ratio", "dim_alpha", "npc_guard_hp", }; public class Result { public readonly List stages = new List(); public readonly List layout = new List(); public readonly List guide = new List(); public readonly List config = new List(); public readonly List errors = new List(); } static TutorialDb db; public static TutorialDb Db { get { if (db == null) db = Resources.Load(ResourcesPath); return db; } } public static void Invalidate() { db = null; } /// /// texts = Files 순서. 참조 검사용 질의(null = 생략): heroExists(영웅 id) · generalExists(무장 id) · gimmickExists(기믹 id). /// 형식·참조 오류는 errors 에 모은다(하나라도 있으면 임포터가 자산을 바꾸지 않는다). /// public static Result Parse(string[] texts, Func heroExists = null, Func generalExists = null, Func gimmickExists = null) { var r = new Result(); foreach (var row in StageTable.ReadCsv(Text(texts, 0), Files[0], r.errors)) { string at = Files[0] + " 줄 " + Get(row, "#"); var s = new TutorialStageRow { chapter = Int(row, "n_chapter", r.errors, at), stage = Int(row, "n_stage", r.errors, at), turnLimit = Int(row, "n_turn_limit", r.errors, at), noDefeat = Bool(row, "b_no_defeat", r.errors, at), learnKo = Get(row, "s_learn_ko"), winKo = Get(row, "s_win_ko"), loseKo = Get(row, "s_lose_ko"), clearKo = Get(row, "s_clear_ko"), }; string lineup = Get(row, "s_lineup"); if (lineup.Length == 0) r.errors.Add(at + ": s_lineup 비어 있음(자유 편성 = free)"); s.lineup = lineup == "free" ? new string[0] : Ids(lineup); s.npcs = Ids(Get(row, "s_npc")); if (s.turnLimit < 0) r.errors.Add(at + ": n_turn_limit 음수"); foreach (var id in s.lineup) if (heroExists != null && !heroExists(id)) r.errors.Add(at + ": s_lineup 영웅 「" + id + "」 이 heroes.csv 에 없음"); foreach (var id in s.npcs) if (heroExists != null && !heroExists(id)) r.errors.Add(at + ": s_npc 영웅 「" + id + "」 이 heroes.csv 에 없음"); if (r.stages.Exists(x => x.chapter == s.chapter && x.stage == s.stage)) r.errors.Add(at + ": " + s.chapter + "-" + s.stage + " 중복"); r.stages.Add(s); } foreach (var row in StageTable.ReadCsv(Text(texts, 1), Files[1], r.errors)) { string at = Files[1] + " 줄 " + Get(row, "#"); var l = new TutorialLayoutRow { line = Int(row, "#", r.errors, at), chapter = Int(row, "n_chapter", r.errors, at), stage = Int(row, "n_stage", r.errors, at), slot = Int(row, "n_slot", r.errors, at), unitId = Get(row, "s_unit_id"), gimmickId = Get(row, "s_gimmick_id"), pos = new Vector2(Float(row, "f_x", r.errors, at), Float(row, "f_y", r.errors, at)), }; switch (Get(row, "e_side")) { case "ally": l.side = TutSide.Ally; break; case "npc": l.side = TutSide.Npc; break; case "enemy": l.side = TutSide.Enemy; break; case "gimmick": l.side = TutSide.Gimmick; break; default: r.errors.Add(at + ": e_side 는 ally|npc|enemy|gimmick(「" + Get(row, "e_side") + "」)"); break; } if (l.side == TutSide.Gimmick) { if (l.gimmickId.Length == 0) r.errors.Add(at + ": gimmick 행에 s_gimmick_id 없음"); else if (gimmickExists != null && !gimmickExists(l.gimmickId)) r.errors.Add(at + ": 기믹 「" + l.gimmickId + "」 이 gimmicks.csv 에 없음"); } else { if (!UnitTypeInfo.TryParseKey(Get(row, "e_type"), out l.type)) r.errors.Add(at + ": e_type 병종 아님(「" + Get(row, "e_type") + "」)"); l.hpMult = Float(row, "f_hp_mult", r.errors, at); l.atkMult = Float(row, "f_atk_mult", r.errors, at); l.boss = Bool(row, "b_boss", r.errors, at); l.general = Bool(row, "b_general", r.errors, at); if (l.hpMult <= 0f || l.atkMult <= 0f) r.errors.Add(at + ": 체력·공격 배율은 0 보다 커야 함"); if (l.side == TutSide.Enemy) { if (l.general && l.unitId.Length == 0) r.errors.Add(at + ": 무장(b_general 1)에 s_unit_id 없음"); if (!l.general && l.unitId.Length > 0) r.errors.Add(at + ": 병사 행에 s_unit_id(무장이면 b_general 1)"); if (l.boss && !l.general) r.errors.Add(at + ": 보스(b_boss 1)는 무장(b_general 1)이어야 함"); if (l.general && generalExists != null && !generalExists(l.unitId)) r.errors.Add(at + ": 무장 「" + l.unitId + "」 이 generals.csv 에 없음"); } else { if (l.unitId.Length == 0) r.errors.Add(at + ": 아군·구출 대상 행에 s_unit_id(영웅 id) 없음"); else if (heroExists != null && !heroExists(l.unitId)) r.errors.Add(at + ": 영웅 「" + l.unitId + "」 이 heroes.csv 에 없음"); } } if (l.slot <= 0) r.errors.Add(at + ": n_slot 은 1 이상"); if (r.layout.Exists(x => x.chapter == l.chapter && x.stage == l.stage && x.slot == l.slot)) r.errors.Add(at + ": " + l.chapter + "-" + l.stage + " 슬롯 " + l.slot + " 중복"); r.layout.Add(l); } foreach (var row in StageTable.ReadCsv(Text(texts, 2), Files[2], r.errors)) { string at = Files[2] + " 줄 " + Get(row, "#"); var g = new TutorialGuideRow { line = Int(row, "#", r.errors, at), chapter = Int(row, "n_chapter", r.errors, at), stage = Int(row, "n_stage", r.errors, at), step = Int(row, "n_step", r.errors, at), turn = Int(row, "n_turn", r.errors, at), targetRaw = Get(row, "s_target"), locked = Bool(row, "b_lock", r.errors, at), textKo = Get(row, "s_text_ko"), }; switch (Get(row, "e_trigger")) { case "stage_start": g.trigger = GuideTrigger.StageStart; break; case "after_step": g.trigger = GuideTrigger.AfterStep; break; case "unit_select": g.trigger = GuideTrigger.UnitSelect; break; case "action_end": g.trigger = GuideTrigger.ActionEnd; break; case "enemy_turn": g.trigger = GuideTrigger.EnemyTurn; break; case "turn_start": g.trigger = GuideTrigger.TurnStart; break; case "boss_intro_end": g.trigger = GuideTrigger.BossIntroEnd; break; case "before_battle": g.trigger = GuideTrigger.BeforeBattle; break; case "fail": g.trigger = GuideTrigger.Fail; break; default: r.errors.Add(at + ": e_trigger 값 「" + Get(row, "e_trigger") + "」"); break; } switch (Get(row, "e_mode")) { case "popup": g.mode = GuideMode.Popup; break; case "drag": g.mode = GuideMode.Drag; break; case "tap": g.mode = GuideMode.Tap; break; case "highlight": g.mode = GuideMode.Highlight; break; case "bar": g.mode = GuideMode.Bar; break; default: r.errors.Add(at + ": e_mode 값 「" + Get(row, "e_mode") + "」"); break; } string why; var t = GuideTarget.Parse(g.targetRaw, out why); if (t == null) r.errors.Add(at + ": s_target — " + why); else { foreach (var slot in t.AllSlots()) if (!r.layout.Exists(x => x.chapter == g.chapter && x.stage == g.stage && x.slot == slot)) r.errors.Add(at + ": 슬롯 " + slot + " 이 tutorial_layout.csv " + g.chapter + "-" + g.stage + " 에 없음"); if (g.mode == GuideMode.Drag && t.kind != GuideTargetKind.Drag) r.errors.Add(at + ": drag 안내의 s_target 은 slot:A>slot:B 또는 slot:A>xy:x,y"); if (g.mode == GuideMode.Tap && t.kind == GuideTargetKind.None) r.errors.Add(at + ": tap 안내에 s_target 없음"); } if (g.textKo.Length == 0) r.errors.Add(at + ": s_text_ko 비어 있음"); if (g.turn < 0) r.errors.Add(at + ": n_turn 음수"); if (r.guide.Exists(x => x.chapter == g.chapter && x.stage == g.stage && x.step == g.step)) r.errors.Add(at + ": " + g.chapter + "-" + g.stage + " 단계 " + g.step + " 중복"); r.guide.Add(g); } foreach (var row in StageTable.ReadCsv(Text(texts, 3), Files[3], r.errors)) { string at = Files[3] + " 줄 " + Get(row, "#"); var c = new TutorialConfigEntry { key = Get(row, "s_key"), value = Float(row, "f_value", r.errors, at) }; if (c.key.Length == 0) r.errors.Add(at + ": s_key 비어 있음"); else if (r.config.Exists(x => x.key == c.key)) r.errors.Add(at + ": 키 「" + c.key + "」 중복"); r.config.Add(c); } foreach (var k in ConfigKeys) if (!r.config.Exists(x => x.key == k)) r.errors.Add(Files[3] + ": 키 「" + k + "」 없음"); // 표끼리: 고정 편성 = 배치 표의 ally 행 · s_npc = npc 행 · 안내·배치의 판 = tutorial_stage 에 있어야 한다 foreach (var s in r.stages) { string at = Files[0] + " " + s.chapter + "-" + s.stage; var rows = r.layout.FindAll(x => x.chapter == s.chapter && x.stage == s.stage); if (s.FixedLineup) { if (rows.Count == 0) r.errors.Add(at + ": 고정 편성인데 tutorial_layout.csv 에 배치 행 없음"); if (!SameIds(s.lineup, rows.FindAll(x => x.side == TutSide.Ally))) r.errors.Add(at + ": s_lineup ≠ 배치 표 ally 행"); } if (!SameIds(s.npcs, rows.FindAll(x => x.side == TutSide.Npc))) r.errors.Add(at + ": s_npc ≠ 배치 표 npc 행"); } foreach (var l in r.layout) if (!r.stages.Exists(x => x.chapter == l.chapter && x.stage == l.stage)) { r.errors.Add(Files[1] + " 줄 " + l.line + ": " + l.chapter + "-" + l.stage + " 이 tutorial_stage.csv 에 없음"); break; } foreach (var g in r.guide) if (!r.stages.Exists(x => x.chapter == g.chapter && x.stage == g.stage)) { r.errors.Add(Files[2] + " 줄 " + g.line + ": " + g.chapter + "-" + g.stage + " 이 tutorial_stage.csv 에 없음"); break; } return r; } static bool SameIds(string[] ids, List rows) { var a = new List(ids); var b = new List(); foreach (var x in rows) b.Add(x.unitId); a.Sort(string.CompareOrdinal); b.Sort(string.CompareOrdinal); if (a.Count != b.Count) return false; for (int i = 0; i < a.Count; i++) if (a[i] != b[i]) return false; return true; } static string[] Ids(string s) { var res = new List(); foreach (var p in s.Split(';')) if (p.Trim().Length > 0) res.Add(p.Trim()); return res.ToArray(); } static string Text(string[] texts, int i) { return texts != null && i < texts.Length ? texts[i] : null; } static string Get(Dictionary r, string key) { string v; return r.TryGetValue(key, out v) ? v : ""; } static int Int(Dictionary r, string key, List errors, string at) { int v; if (int.TryParse(Get(r, key), NumberStyles.Integer, CultureInfo.InvariantCulture, out v)) return v; errors.Add(at + ": " + key + " 정수 아님(「" + Get(r, key) + "」)"); return 0; } static float Float(Dictionary r, string key, List errors, string at) { float v; if (float.TryParse(Get(r, key), NumberStyles.Float, CultureInfo.InvariantCulture, out v)) return v; errors.Add(at + ": " + key + " 숫자 아님(「" + Get(r, key) + "」)"); return 0f; } static bool Bool(Dictionary r, string key, List errors, string at) { string v = Get(r, key); if (v == "1") return true; if (v == "0") return false; errors.Add(at + ": " + key + " 는 0|1(「" + v + "」)"); return false; } } }