ThreeKingdomsSlingshot/Assets/Scripts/Runtime/ContentModes/ModeBattleRules.cs

321 lines
11 KiB
C#
Raw Normal View History

컨텐츠 모드 4종 구현 — 보급전 · 맹장 토벌전 · 연의 전기 · 투기장(교대 조작) · 더미 UI (PD 2026-11-17~18) - 전투 규칙 플러그인 ModeBattleRules(BattleMode.rules) + 훅(피해 · 처치 · 기믹 파괴 · 밀려 막힘 · 턴 시작 · 승패 · 제한 턴 · 출전 자리 · 고정 편성 · 바람 조준 · 교대 조작 · 좁힌 전장) - 표 = Resources/ContentModes/*.csv(기획 tables 사본 · 실행 중 읽음) · 적 수치 기준 = 게임 스테이지 적(common.enemy_ref) - ① 보급전 4곳(병법 훈련 조건 · 과제 · 별 / 군량고 / 연병장 허수아비 / 황건 삼형제) · 판정 · 보상 · 소탕 · 그날 완료 · 주간 도장 · 옛 던전 id 기록 이전 - ③ 맹장 7명(기본 공격 · 패턴 예고 · 기세 · 협공 · 벽 충돌 · 빈틈 · 딸린 것 · 철수) · 일정 · 점수 · 누적 단계 · 훈장 상점 - ② 연의 전기 15편(고정 편성 · 타격 횟수 기준 적 세기 · 조건 21 · 불 번짐 · 수공 · 바람 · 원군 · 연전 · 돌진) · 보상 · 주역 조각 - ④ 투기장 교대 조작(AlternateStep) · 12x18 전장 · 시즌 지형 · 점수 · 등급 · 상대 3 - 서버 /tks/modes/* 연결 · gimmicks.csv 5줄(granary · lowland · dry_grass · warship · camp) · Fable QA 11건 반영 - 테스트: 전체 189 중 187 통과 · 실패 2(보스 판 첫 프레임 · 보물 상자 크기 = 기존 실패로 추정) · 기믹 행 수 기대값 21 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 16:03:13 +00:00
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
namespace TKS
{
/// <summary>
/// 컨텐츠 모드 전투 규칙의 바탕(2026-11-17 컨텐츠 모드 기획 10판 · 보급전 · 연의 전기 · 맹장 토벌전 · 투기장 공용).
/// BattleMode.rules 에 넣으면 BattleManager · SkillSystem · SkillMods 가 아래 자리에서 부른다(없으면 일반 연무장 전투와 같다).
/// 집계(피해 · 처치 · 행동)는 가상 실행(Sim.Active · 적 AI 예측) 중에는 부르지 않는다 — 수치 배율(DealtMult · SlingMult)은 예측에도 들어간다.
/// </summary>
public abstract class ModeBattleRules
{
public BattleManager Battle { get; private set; }
/// <summary>지금 전투의 규칙(연무장 모드 전투가 아니거나 규칙이 없으면 null).</summary>
public static ModeBattleRules Current
{
get
{
var bm = BattleManager.Instance;
return bm != null && bm.Mode != null ? bm.Mode.rules : null;
}
}
internal void Bind(BattleManager bm)
{
Battle = bm;
}
// ---------- 시작 ----------
/// <summary>아군 시작 자리(slot = 편성 칸 0~4) — 없으면 fallback(BalanceConfig 출전 자리).</summary>
public virtual Vector2 AllyPosition(int slot, Vector2 fallback)
{
return fallback;
}
/// <summary>출전 편성을 바꾼다(연의 전기 고정 편성 · null = 편성 그대로).</summary>
public virtual List<LineupEntry> Lineup(List<LineupEntry> preset)
{
return null;
}
/// <summary>아군 조준 목표를 바꾼다(바람 턴 화살 휨).</summary>
public virtual Vector2 AdjustTarget(Unit u, Vector2 target)
{
return target;
}
/// <summary>전장을 이 크기로 좁힌다(투기장 12×18 · null = 원래 크기).</summary>
public virtual Vector2? BoardArea
{
get { return null; }
}
/// <summary>교대 조작(투기장) — 아군 1기 → 적 1기 번갈아 · 라운드 = 양쪽 모두 한 번씩.</summary>
public virtual bool Alternating
{
get { return false; }
}
/// <summary>출전 칸 수 상한(0 = 편성 그대로).</summary>
public virtual int MaxAllies
{
get { return 0; }
}
/// <summary>유닛 · 기믹을 다 놓은 뒤(아군 턴 전) — 배치 표의 기믹 · 허수아비 · 군량고를 놓는다.</summary>
public virtual void OnBegin()
{
}
/// <summary>적이 먼저 움직이는 판(선제) — 첫 적 턴은 턴 수를 세지 않는다.</summary>
public virtual bool EnemyFirst
{
get { return false; }
}
// ---------- 행동 · 피해 ----------
/// <summary>그 적이 이번 적 턴에 움직이는가(허수아비 = 움직이지 않음).</summary>
public virtual bool EnemyActs(Unit e)
{
return true;
}
/// <summary>행동 1회가 끝났을 때(아군 · 적 · 가상 실행 제외).</summary>
public virtual void OnAction(Unit actor, ActionOutcome o)
{
}
/// <summary>피해가 들어간 뒤(dealt = 실제로 깎인 체력 · before = 맞기 전 체력).</summary>
public virtual void OnDamaged(Unit d, int dealt, Unit by, HitKind kind, int before)
{
}
/// <summary>쓰러졌을 때(by = 마지막으로 친 유닛 · 기믹 · 상태 이상이면 null 일 수 있음).</summary>
public virtual void OnDeath(Unit d, Unit by)
{
}
/// <summary>기믹이 부서졌을 때(내구 0).</summary>
public virtual void OnGimmickBroken(GimmickInstance g, Unit by)
{
}
/// <summary>밀린 유닛이 벽 · 장애물에 막혔을 때(유닛에 막힌 것은 제외).</summary>
public virtual void OnSlam(Unit target, Unit pusher)
{
}
/// <summary>그 적이 이번 행동에 노릴 아군(null = 기본 적 AI) — 삼형제 행동 · 복수.</summary>
public virtual Unit EnemyTarget(Unit e)
{
return null;
}
/// <summary>정해진 행동으로 움직이는 적인가(맹장 기본 공격 · 수레 이동 — 슬링샷 AI 대신 RunEnemy).</summary>
public virtual bool ScriptsEnemy(Unit e)
{
return false;
}
/// <summary>정해진 행동 1회(ScriptsEnemy 가 true 인 적).</summary>
public virtual IEnumerator RunEnemy(Unit e)
{
yield break;
}
/// <summary>이번 적 턴에 한 번 더 움직이는가(맹장 기세 행동 +1) — 행동이 끝날 때마다 묻는다.</summary>
public virtual bool ActAgain(Unit e)
{
return false;
}
/// <summary>반격하지 않는 대상(기절한 맹장이 받는 공격 1회).</summary>
public virtual bool NoCounter(Unit defender)
{
return false;
}
/// <summary>상성을 받지 않는 대상(모든 병종에게 1.0 · 허수아비).</summary>
public virtual bool NoMatchup(Unit d)
{
return false;
}
/// <summary>상태 이상(지속 피해)이 걸리지 않는 대상(허수아비).</summary>
public virtual bool StatusImmune(Unit d)
{
return false;
}
/// <summary>적 전멸 = 승리 판정을 쓰는가(군량고 · 연병장 = 집계형이라 쓰지 않음).</summary>
public virtual bool EliminationVictory
{
get { return true; }
}
/// <summary>액티브 스킬이 발동했을 때.</summary>
public virtual void OnActiveUsed(Unit u)
{
}
/// <summary>액티브 스킬을 막는 까닭(null = 쓸 수 있음).</summary>
public virtual string SkillBlocked(Unit u)
{
return null;
}
/// <summary>주는 피해 배율(훈련 조건 가호 · 금기 · 분노 …).</summary>
public virtual float DealtMult(Unit a, Unit d)
{
return 1f;
}
/// <summary>슬링 거리 배율(역풍 …).</summary>
public virtual float SlingMult(Unit u)
{
return 1f;
}
// ---------- 턴 ----------
/// <summary>그 진영 턴이 시작될 때(기믹 · 스킬 턴 처리 뒤).</summary>
public virtual IEnumerator OnTurnStart(Faction f)
{
yield break;
}
/// <summary>
/// 승패 판정 앞에서 먼저 부른다 — true 를 돌려주면 그 단계(StageClear | Defeat)로 끝낸다. message = 결과 문구.
/// 기본 = 일반 판정(적 전멸 = 승리 · 아군 전멸 = 패배).
/// </summary>
public virtual bool CheckEnd(out BattlePhase phase, out string message)
{
phase = BattlePhase.PlayerTurn;
message = null;
return false;
}
/// <summary>제한 턴이 다 됐을 때의 결과(기본 = 패배 · 집계형 던전 = 판정이 있으면 승리).</summary>
public virtual BattlePhase OnTurnLimit(out string message)
{
message = Battle != null ? Battle.TurnLimit + "턴 종료" : "";
return BattlePhase.Defeat;
}
/// <summary>승리 인원에서 빼는 유닛(허수아비 · 군량고 표시 유닛 등).</summary>
public virtual bool CountsForVictory(Unit u)
{
return true;
}
// ---------- 결과 · 화면 ----------
/// <summary>HUD 에 「철수」 버튼을 보이는가(맹장 토벌전 raid.retreat).</summary>
public virtual bool CanRetreat
{
get { return false; }
}
/// <summary>철수 — 다음 승패 판정(CheckEnd)에서 끝낸다.</summary>
public virtual void Retreat()
{
}
/// <summary>HUD 의 진행 줄(남은 턴 · 부순 수 · 과제 …) — 빈칸 = 표시 안 함.</summary>
public virtual string ProgressLine
{
get { return ""; }
}
/// <summary>판정 값(부순 수 · 목표 대비 % · 걸린 턴 · 서버로 보냄) — 없으면 null.</summary>
public virtual float? JudgeValue
{
get { return null; }
}
/// <summary>과제 달성(별 판정 · 서버로 보냄) — 없으면 null.</summary>
public virtual bool[] Tasks
{
get { return null; }
}
/// <summary>결과 요약(서버 로그 summary · 결과 화면 줄).</summary>
public virtual void Summarize(List<string> lines)
{
}
// ---------- 도우미 ----------
protected static bool Live
{
get { return !Sim.Active; }
}
/// <summary>BattleManager 가 부르는 자리(가상 실행 중이면 집계를 건너뛴다).</summary>
internal static void RaiseDamaged(Unit d, int dealt, Unit by, HitKind kind, int before)
{
var r = Current;
if (r != null && Live && dealt > 0) r.OnDamaged(d, dealt, by, kind, before);
}
internal static void RaiseDeath(Unit d, Unit by)
{
var r = Current;
if (r != null && Live) r.OnDeath(d, by);
}
internal static void RaiseGimmickBroken(GimmickInstance g, Unit by)
{
var r = Current;
if (r != null && Live) r.OnGimmickBroken(g, by);
}
internal static void RaiseSlam(Unit target, Unit pusher)
{
var r = Current;
if (r != null && Live) r.OnSlam(target, pusher);
}
internal static void RaiseActiveUsed(Unit u)
{
var r = Current;
if (r != null && Live) r.OnActiveUsed(u);
}
internal static bool NoCounterOf(Unit defender)
{
var r = Current;
return r != null && defender != null && !Sim.Active && r.NoCounter(defender);
}
internal static bool NoMatchupOf(Unit d)
{
var r = Current;
return r != null && d != null && r.NoMatchup(d);
}
internal static bool StatusImmuneOf(Unit d)
{
var r = Current;
return r != null && d != null && r.StatusImmune(d);
}
internal static float Dealt(Unit a, Unit d)
{
var r = Current;
return r != null ? Mathf.Max(0f, r.DealtMult(a, d)) : 1f;
}
internal static float Sling(Unit u)
{
var r = Current;
return r != null ? Mathf.Max(0.05f, r.SlingMult(u)) : 1f;
}
}
}