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

321 lines
11 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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;
}
}
}