ThreeKingdomsSlingshot/Assets/Scripts/Runtime/Tutorial/TutorialTable.cs

508 lines
23 KiB
C#

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
}
/// <summary>안내가 가리키는 것(tutorial_guide.csv s_target 해석 결과).</summary>
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" };
/// <summary>형식 오류면 null(why 에 이유).</summary>
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<int>();
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);
}
/// <summary>이 대상이 참조하는 슬롯 번호 전부.</summary>
public IEnumerable<int> 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;
}
}
}
/// <summary>1장 학습 판 1행(tutorial_stage.csv) + 임포트 때 만든 그 판의 적 편성(배치 표 좌표·배율 · 세력 그림 · 무장 정보).</summary>
[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<TutorialEnemy> enemies = new List<TutorialEnemy>();
public bool FixedLineup
{
get { return lineup != null && lineup.Length > 0; }
}
}
[Serializable]
public class TutorialEnemy
{
public int slot;
public BalanceConfig.EnemySpawn spawn = new BalanceConfig.EnemySpawn();
}
/// <summary>배치 1행(tutorial_layout.csv · 전장 좌표 = 가운데 0,0 · 위 = 적).</summary>
[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;
}
/// <summary>안내 1단계(tutorial_guide.csv).</summary>
[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";
/// <summary>코드가 읽는 설정 키(임포트 때 표에 있는지 확인).</summary>
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<TutorialStageRow> stages = new List<TutorialStageRow>();
public readonly List<TutorialLayoutRow> layout = new List<TutorialLayoutRow>();
public readonly List<TutorialGuideRow> guide = new List<TutorialGuideRow>();
public readonly List<TutorialConfigEntry> config = new List<TutorialConfigEntry>();
public readonly List<string> errors = new List<string>();
}
static TutorialDb db;
public static TutorialDb Db
{
get
{
if (db == null) db = Resources.Load<TutorialDb>(ResourcesPath);
return db;
}
}
public static void Invalidate()
{
db = null;
}
/// <summary>
/// texts = Files 순서. 참조 검사용 질의(null = 생략): heroExists(영웅 id) · generalExists(무장 id) · gimmickExists(기믹 id).
/// 형식·참조 오류는 errors 에 모은다(하나라도 있으면 임포터가 자산을 바꾸지 않는다).
/// </summary>
public static Result Parse(string[] texts, Func<string, bool> heroExists = null, Func<string, bool> generalExists = null, Func<string, bool> 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<TutorialLayoutRow> rows)
{
var a = new List<string>(ids);
var b = new List<string>();
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<string>();
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<string, string> r, string key)
{
string v;
return r.TryGetValue(key, out v) ? v : "";
}
static int Int(Dictionary<string, string> r, string key, List<string> 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<string, string> r, string key, List<string> 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<string, string> r, string key, List<string> 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;
}
}
}