Project_WL/Assets/WL/UI/Settings/WLBossUiSettings.cs

112 lines
6.6 KiB
C#

// ─────────────────────────────────────────────────────────────────────────────
// WLBossUiSettings.cs — 보스 등장 연출(배너 + 경고 비네트) 값의 단일 출처 (WL-813tj · 813t · #813)
//
// 기준서 v1 §D-1 813t 행: "Spawned(isBoss) → 상단 BOSS 배너 1.2 s + 화면 가장자리 붉은 UI 비네트 0.8 s
// (포스트 프로세싱 금지 → UI 이미지) · 보스 이름은 MonsterList.n_MonsterName"
// §B 요소 6 "등장 · 처치 연출": 등장 배너 + 카메라 오빗 1.2 s + 상단 HP 바.
//
// ■ 왜 이 에셋인가 (C45)
// 시간·크기·색·문구를 코드 상수로 두지 않는다. 이 파일에는 "필드와 기본값"만 있고,
// 게임이 실제로 읽는 값은 Resources/WL/WLBossUiSettings.asset 이다.
// 에셋이 없으면 Instance == null → BossBanner 는 아무 것도 만들지 않는다(C8 롤백 1순위).
//
// ■ px → 캔버스 유닛
// 환산 계수를 여기에 두지 않는다. 813c 의 WLHudLayoutSettings.UnitsPerPx(canvas) 하나만 쓴다
// (802b·813c·813g 실측 1.7778 = 세로 1080 기준). 산식이 두 벌이 되면 값이 갈린다.
//
// 🔴 어셈블리 주의: Assets/WL/UI/ 에 .asmdef 를 만들지 말 것(Assembly-CSharp 단일).
// ─────────────────────────────────────────────────────────────────────────────
using UnityEngine;
namespace WL.UI
{
[CreateAssetMenu(fileName = "WLBossUiSettings", menuName = "WL/Boss UI Settings", order = 31)]
public sealed class WLBossUiSettings : ScriptableObject
{
/// <summary>Resources 경로 — 런타임 로드 키.</summary>
public const string ResourcesPath = "WL/WLBossUiSettings";
private static WLBossUiSettings s_instance;
private static bool s_tried;
/// <summary>에셋이 없으면 null(호출부는 null 이면 연출을 건너뛴다 = C8 롤백).</summary>
public static WLBossUiSettings Instance
{
get
{
if (s_instance == null && !s_tried)
{
s_tried = true;
s_instance = Resources.Load<WLBossUiSettings>(ResourcesPath);
}
return s_instance;
}
}
public static void ClearCache() { s_instance = null; s_tried = false; }
// ── 공통 스위치 ───────────────────────────────────────────────────────
[Header("공통")]
[Tooltip("끄면 BossBanner 가 구독조차 하지 않는다(원본 100% · C8 롤백)")]
public bool bannerEnabled = true;
[Tooltip("같은 보스가 다시 Spawned 를 내도 이 시간 안이면 배너를 다시 띄우지 않는다(중복 방지)")]
public float retriggerGuardSeconds = 3f;
// ── 배너 ──────────────────────────────────────────────────────────────
[Header("배너 (기준서 §D-1 813t · 1.2 s)")]
[Tooltip("배너 총 표시 시간 — 기준서 1.2")]
public float bannerSeconds = 1.2f;
[Tooltip("등장 페이드 인")]
public float bannerFadeInSeconds = 0.15f;
[Tooltip("퇴장 페이드 아웃")]
public float bannerFadeOutSeconds = 0.25f;
[Tooltip("배너 등장 펀치 배율 (813g 텍스트 연출과 같은 계열)")]
public float bannerPunchScale = 1.35f;
[Tooltip("펀치가 원래 크기로 수렴하는 시간")]
public float bannerPunchSeconds = 0.18f;
[Tooltip("Safe Area 상단에서 배너 위 모서리까지 (px) — 813c 보스 HP 바(190~256 px)와 겹치지 않는 값")]
public float bannerTopMarginPx = 300f;
[Tooltip("배너 크기 (px · 세로 1080 기준)")]
public Vector2 bannerSizePx = new Vector2(860f, 150f);
[Tooltip("배너 뒷판 색 (알파 0 이면 뒷판을 만들지 않는다)")]
public Color bannerBgColor = new Color(0f, 0f, 0f, 0.55f);
[Tooltip("큰 글씨 — 문구도 값이다(로컬라이즈 전까지 여기서 바꾼다)")]
public string bannerTitleText = "BOSS";
[Tooltip("큰 글씨 크기 (px)")]
public float bannerTitleFontPx = 96f;
[Tooltip("큰 글씨 색 — 기준서 §B 등급 5 빨강 팔레트")]
public Color bannerTitleColor = new Color(1f, 0.271f, 0.278f, 1f); // #FD4547
[Tooltip("보스 이름 줄 크기 (px) · 이름은 MonsterList.n_MonsterName(localtext)에서 온다")]
public float bannerNameFontPx = 56f;
[Tooltip("보스 이름 줄 색")]
public Color bannerNameColor = new Color(1f, 0.941f, 0.722f, 1f); // #FFF0B8
[Tooltip("이름을 못 구했을 때 이름 줄을 숨긴다(빈 줄 방지)")]
public bool hideNameWhenUnknown = true;
// ── 경고 비네트 (UI 이미지 · 포스트 프로세싱 금지) ────────────────────
[Header("경고 비네트 (기준서 §D-1 813t · 0.8 s · UI 이미지)")]
[Tooltip("끄면 비네트를 만들지 않는다")]
public bool warnVignetteEnabled = true;
[Tooltip("비네트 총 표시 시간 — 기준서 0.8")]
public float warnVignetteSeconds = 0.8f;
[Tooltip("이 시간 안에 최고 밝기까지 올린다")]
public float warnVignetteFadeInSeconds = 0.12f;
[Tooltip("표시 시간 안에서 몇 번 맥동하는가 (1 = 한 번 밝아졌다 꺼짐)")]
public int warnVignettePulses = 2;
[Tooltip("가장자리 띠 두께 (px) — 9-슬라이스 테두리라 화면 중앙은 그리지 않는다(fillCenter=false)")]
public float warnVignetteThicknessPx = 180f;
[Tooltip("비네트 색(알파 = 최고 밝기)")]
public Color warnVignetteColor = new Color(1f, 0.165f, 0.165f, 0.55f); // #FF2A2A · a 0.55
// ── 진단 ──────────────────────────────────────────────────────────────
[Header("진단")]
[Tooltip("배너·비네트 전이를 콘솔에 남긴다(Play 진단용 · 기본 꺼짐)")]
public bool verboseLog = false;
}
}