ThreeKingdomsSlingshot/CLAUDE.md

163 lines
159 KiB
Markdown
Raw Normal View History

# 삼국지 슬링샷 (가제) — 에이전트 작업 지침
> 너드나비스 조직 프로젝트 ⑤ (조직 레포 `.claude/skills/너드나비스-코어룰/rules/P38.md` §P38-3 ⑤). 새 세션은 조직 레포 `공유/인계서/삼국지슬링샷_인계서.md` → 이 파일 → `README.md` 순서로만 읽고 시작한다. 조직 규칙 본문 전수 읽기 금지(C10-1).
## 프로젝트 정보
- Unity **6000.3.23f1** · 2D · 빌트인 RP · 레거시 Input(`activeInputHandler: 0`) · Portrait · 패키지 = 기본 모듈 + `com.unity.ugui 2.0.0` + `com.unity.test-framework 1.6.0` + `com.unity.pipeline 0.10.0-exp.1`(2026-11-04 P38-7 적용).
- git = 이 폴더가 레포 루트 · `main` · 원격 `origin` = `https://burning.i234.me/NerdNavis_AiDev/ThreeKingdomsSlingshot.git`(비공개 · 2026-11-09 · 다른 PC 와 함께 작업 = 시작 전 `git pull` · 커밋 후 `git push`). 미추적 = `Library/` `Temp/` `Logs/` `UserSettings/` `obj/`(Unity 표준 `.gitignore` · Pipeline 포트 파일 `Library/Pipeline/.unity-pipeline-port` 도 그 안).
- 기록 = 조직 레포 `공유/대화로그/삼국지슬링샷/` · 인계서 `공유/인계서/삼국지슬링샷_인계서.md` · PD 지시 로그 #1077.
## 에디터 제어 = Unity 공식 CLI + `com.unity.pipeline` (P38-7)
기본 호출은 MCP 가 아니라 **셸에서 `unity …` 직접 호출**이다(Unity 공식 권장 · 토큰 적음). `unity` 명령은 PowerShell 로 호출하되, C# 코드에 큰따옴표가 들어가는 `eval` 류는 Bash 도구로(K-DEV-026). 에디터가 둘 이상 열려 있으면 `--project-path E:\Nerdnavis\ThreeKingdomsSlingshot` 또는 환경 변수 `UNITY_PROJECT_PATH` 로 대상을 지정한다(K-DEV-024).
### 에디터가 열려 있을 때 (PD 플레이 중 반복 수정)
```
unity status --project-path . # ready 확인(포트·PID)
unity recompile --project-path . # 수정 후 재컴파일 · 컴파일 오류 0 이어야 통과
# ※ 2026-11-13 실측(CLI 1.0.0-beta.8): `unity recompile` 은 「unknown command」 → `unity command --project-path . script recompile` 뒤 `script recompile_status` 를 completed|up_to_date 까지 폴링
# ※ `unity status` 가 빈 표여도 에디터가 떠 있을 수 있다(같은 날 실측) → `unity command --project-path . editor status` 또는 Unity.exe 프로세스로 확인한 뒤 Assets 를 쓴다 · C# 이 긴 eval 은 `script eval --file <.cs>`
unity command --project-path . # 등록된 명령 목록(콘솔 읽기 · 메뉴 실행 등)
unity command --project-path . <명령> [인자] # 명령 실행 · --result-only 로 JSON 만
unity command --project-path . test run --mode playmode --async-tests --timeout 600 --result-only # 열린 에디터 안에서 테스트 시작(비동기 필수 · Play 진입의 도메인 리로드가 동기 요청을 끊음)
unity command --project-path . test status --result-only # 끝날 때까지 10초마다 폴링 · test list / cancel 도 있음
# ※ `unity test <proj> --mode PlayMode` 는 자체 배치 인스턴스를 띄우므로 에디터가 열려 있으면 거부된다(2026-11-04 실측 「이미 열려 있습니다」)
unity close . [--force] # 에디터 종료(저장 없이 종료 · PD 가 연 에디터는 닫지 않는다)
```
- **작업 전에 `unity command --project-path . editor status --result-only` 로 `playMode` 를 본다.** **PD 가 Play 중(`playing`·`paused`)이어도 기다리지 말고 `unity command --project-path . editor.playmode stop` 으로 Play 를 중단 → `stopped` 확인 → 바로 작업**한다(PD 지시 2026-11-04 · 2026-11-09 재확인 「내 PC 가 플레이 중이더라도 중단하고 작업해」 · 에디터 자체는 닫지 않음). 수정을 **모두** 끝낸 뒤 리컴파일 1회(편집 중 자동 새로고침으로 잠깐 컴파일 오류가 보일 수 있음). 열린 에디터가 있으면 배치 실행은 `Temp/UnityLockfile` 로 막히고, PD 가 연 에디터는 닫지 않는다 → 검증이 급하면 `Assets`·`Packages`·`ProjectSettings` 만 복사한 사본 폴더(예 `E:\Nerdnavis\_tks_verify`)에서 배치 실행(2026-11-04 실측 · 새 Library 임포트 포함 수 분).
- 수치 자산에 새 필드를 넣었으면(예 `art` · `archerRangeRatio`) 기존 `BalanceConfig.asset` 에는 비어 있다 → 자산이 git 에서 미수정이면 메뉴 `TKS/Reset Balance Defaults`(= `BuildFresh`)로 재시드 · PD 가 Inspector 로 손본 흔적(git diff)이 있으면 재시드 금지 · 필드만 보충.
- 판정 = 컴파일 오류 0 + 콘솔 error 0(Unity 자체 `SearchDatabase` 인덱싱 예외는 무해).
- **빠른 반영 — PD 가 빠른 수정 요청을 하는 작업(예 연의 전기 · 2026-11-19 PD 「연의 전기와 같이 내가 빠르게 수정 요청이 필요한 경우 play를 켠채 진행해야 해」)**: 위 「Play 를 먼저 끈다」를 하지 않는다. 표(`Resources/Scenario/*.csv` · `ContentModes/*.csv` = 대사 · 카드 · 순서 · 위치 · 대기 · 최소 당김)는 Play 켠 채 바로 쓴다 → PD 가 전투 중 **F5**(에디터 전용 · `OutGameRoot.RestartPrologueAct` = 연의 서장 막을 표를 다시 읽고 처음부터) 또는 막 버튼으로 확인. 에디터는 표를 디스크에서 바로 읽음(`StageTable.ResourceText`) · 막 시작마다 다시 읽음(`ArenaScreen.PrologueGo`). 코드(`.cs`)도 Play 켠 채 쓴다 = **Hot Reload**(`Packages/com.singularitygroup.hotreload` 1.13.27 · 서버 = Window/Hot Reload/Open → Start · 에디터 시작 때 자동 시작) — 실측 2026-11-19: 함수 본문 · 새 함수 · 새 정적 변수 = 3초 안에 반영 · 도메인 리로드 없음. 전투 시작 때 한 번 도는 코드는 F5 로 · 패치는 메모리뿐이라 PD 가 Play 를 끈 뒤 `script recompile` 1회. **Hot Reload 가 자동 새로고침(Auto Refresh)을 끄고 Play 중 스크립트 변경 = 끝난 뒤 컴파일로 바꿈(이 PC 의 같은 Unity 버전 전 프로젝트에 걸림)** → 새 그림 · 에셋 파일을 넣으면 Ctrl+R 또는 `script recompile` 로 가져온다. 확인은 고친 장면만(PD Play 중이면 테스트도 돌리지 않음) · 시험 `ScenarioEventTests.QuickLoop_Act1Start_F5ReloadsEditedTable`(Explicit).
### 에디터가 닫혀 있을 때 (배치 · 재현 가능한 실측)
```
Unity.exe -batchmode -nographics -projectPath <proj> -executeMethod TKS.EditorTools.ProjectSetup.Build -quit -logFile <log> # 컴파일 + 설정 자산·씬 생성(BuildFresh = 기본값 재시드)
Unity.exe -batchmode -nographics -projectPath <proj> -runTests -testPlatform PlayMode -testResults <xml> -logFile <log> # 플레이모드 테스트(현재 17종)
Unity.exe -projectPath <proj> -executeMethod TKS.EditorTools.ProjectSetup.AutoPlayCapture -autoplayDir <dir> -autoplayTurns 3 # GUI 자동 플레이 캡처 · 스스로 종료
```
- `Unity.exe` = `C:\Program Files\Unity\Hub\Editor\6000.3.23f1\Editor\Unity.exe`. 에디터가 같은 프로젝트를 열고 있으면 배치 실행은 못 한다(`Temp/UnityLockfile`) — 먼저 `unity status` 로 확인.
- 배치 로그 판정 = `error CS` 0 · 테스트 XML `failed="0"`.
- **2026-11-16 실측: `-runTests` 에 `-nographics` 를 붙이면 `TutorialTests` 를 포함한 실행이 엔진 렌더러(`RenderOffscreenCameras` → `RenderDynamicBatchSprite`)에서 죽는다(exit 139 · 결과 XML 없음 · `Assets/InitTestScene<guid>.unity` 가 남음)** → 테스트는 `-nographics` 없이 `-batchmode` 만으로 돌린다(같은 필터 15/15 통과). 임포트·컴파일(`-executeMethod … -quit`)은 `-nographics` 그대로 된다.
- **에디터가 열리면서 크래시하면 oCam(화면 녹화)을 의심**: `%LOCALAPPDATA%\Unity\Editor\Editor.log` 꼬리의 스택에 `HookSurfaceDLL` → `D3D12SwapChain::Present` 가 있으면 oCam 의 D3D12 훅이 원인(2026-11-04 15:04 × 2 실측). 이 프로젝트는 그래서 Windows Graphics API 를 **D3D11 우선**으로 고정했다(`ProjectSettings.asset` `m_BuildTargetGraphicsAPIs` · 에디터도 이 설정을 따름). 그래도 크래시하면 `-force-d3d11` 인수 또는 oCam 종료. 배치 `-nographics` 는 영향 없음.
## 코드 규칙
- 전투 수치 SOT = `Assets/Resources/BalanceConfig.asset`(Inspector 조정 · 최초 시드만 `Assets/Scripts/Editor/BalanceDefaults.cs`). 코드·테스트에 수치를 직접 적지 않는다(C45).
- **아웃게임 SOT = `Assets/Data/OutGame/*.csv`(12장 · 기획 `공유/기획팀_산출물/삼국지슬링샷/tables/` 사본 · utf-8-sig · 2026-11-05 #1093 A)** — 영웅·병사(`heroes.csv` · 구 `BalanceConfig.heroes[]` 대체) · 레벨·승급·진화·장비·뽑기·보상·재화·신규 유저 초기값(`economy.csv` start_*). 고친 뒤 메뉴 `TKS/Import OutGame Data (아웃게임 데이터 임포트)`(`Editor/DataImporter` · 오류 시 자산 불변) → `Resources/OutGame/` 9 자산. 표를 바꾸면 기획 `tables/` 도 같이.
- **스킬(2026-11-10 #1112 전면 개편 · PD 엑셀 「장수 목록」 새 기획 144개)** — 수치 SOT = **`Assets/Data/OutGame/skill_effects.csv`(효과 1줄 = `skill_id · key · target · cond · dur · p1~p3` + 한글 주석 열 `effect_ko · p1_ko~p3_ko` = 밸런싱용 · 게임은 안 읽음)** · `skills.csv` = 이름·발동(next_action|instant|always)·쿨·설명 · `effect_key` = 효과 키 목록(p 칸 비움) · `heroes.csv gender`(m|f = 남성·여성 조건). 원본 = 기획 `tables/`(생성기 `_tables_t1.py` SKILL_EFFECTS · KEY_DOC 주석 사전 · 이름·설명 = `영웅_리스트_스킬.md` · 실행 뒤 `economy.csv`·`gacha.csv` 는 git 되돌림 = 생성기보다 손으로 늘린 판이 최신). 처리기 = `Runtime/Skills/`: `SkillKeys`(121종 · 레벨 계수 칸) · `SkillMods`(대상 칸 자신/allies/camp/radius/range/aura · 조건 칸 crit/vs_*/turn_le/armed · 공격·피해·치명타·반격·슬링 질의) · `SkillSystem`(쿨·예약 · 시한 효과 = 라운드(주인 진영 턴 시작마다 −1) · 피해 적용 `Hit(d, dmg, by, HitKind)` = 무적→무효화→호위→부활→흡혈·명중 상태 이상→처치 보상 · 재행동 `ReactCredits` · 즉시형 · `TurnBegin(side)` = 상대 턴 끝 회복·정화 + 중독·화상·회복·지대 · 행동 중 탭 `WaitTap`(조조·하후돈 · 테스트 `AutoTap`) · 지대 `SkillZone`) · `SkillStatus`(혼란·출혈·중독·화상 · 기절 = 기믹 `GimmickLayer.Stun` 재사용) · 특수 이동 = `ActionResolver`(관통·핀볼·복귀·교환·끌어오기·난동·반복) · 특수 사격 = `ActionResolver.Skills.cs`. 가상 실행 = `SkillSystem.TakeState/RestoreState`(Sim). PD 결정 18건(2026-11-10 · 대화로그 `2026-11-10_스킬구현.md`): 「1 m」 = 전장 1 칸 · 「행동 반경」 = 기본 슬링 거리 · 기획에 없는 지속 턴 = 1 · 출혈 = 슬링 최대 거리 이동 시 최대 HP 50 % · 망령 = 다음 자기 턴 시작에 1번 공격 후 소멸 · 육손 불 장벽 = 아군도 · 손건 화친 = 피해 없이 회복만 · 보병 목표점 추가 이동 제거. 테스트 = `Tests/PlayMode/SkillTests`(효과 묶음 26 · PD 결정·Fable 검토 반영 포함). 캡처 = `-executeMethod TKS.EditorTools.DataImporter.CaptureSkills -skillDir <dir>`.
아웃게임 2차(PD #1093 세션 C) — 내정(훈련·순찰·개발) · 보물(수집품·세트·상자) · 연무장(탑·일일 던전·투기장·적장 토벌) · 거래 상자 탭 + 영웅 56명 확장(PD #1096 · 신규 effect_key 4) - 데이터: C 표 10장(training · training_ranks · patrol · dev_tree · treasures · treasure_sets · chests(+iron/buy 열) · tower · dungeons(+reward_amount) · arena(+상점 키)) + economy.csv C 키 24 → 임포트 18 자산(OutGameTables.C.cs 검증: 행·연속 Lv/랭크/층·참조·확률 합 1·선행 노드·효과 키 처리기·카운터 키 · 오류 시 자산 불변) - 영웅 56명: heroes 71 · skills 112 · hero_gear 1344 · gacha_pool 71 재복사 · 신규 키 4(team_dmg_pct_turn · cooldown_add · charm · heal_self_pct) + 기존 키 조건 열(받는 피해 p2 HP 임계/보스/근접 · p3 출전 인원 아군 전원 · 최대 HP·반격 아군 전원 · 피해 % 발동 턴) · 대장군 키는 표 미사용(처리기 유지) - 내정: 훈련(병종 5 · 3항목 Lv · cost_mult · 랭크 승급 · train_bonus → §3-2 항목별) · 순찰(챕터 행 × 시간 · 오프라인 · 상한 12h + 농업 · 소수점 이월 · 광고 2배 스텁 · 즉시 수확 보옥) · 개발(갈래 3 · 선행 · 골드·도면 비용 · 효과 키 → 군량·보상·상점·순찰·상자 적용 지점 · 초기화 보옥 + 도면 환급) - 보물: 보유 중(4열 · 등급 색 · 상세·강화) · 세트(단계 효과) · 상자(포인트 → 명장 · 확률 · 중복 조각) · 효과 hp/atk/def → HeroRules · crit/range/splash → BattleManager.SideEffectsProvider → SkillMods · 조건 카운터 8종 = Runtime/BattleEvents(전투 코드 Raise 1줄씩 · 아군만) · 스테이지 청동 상자 10 % - 연무장: BattleManager.StartMode(BattleMode = 적 편성·제한 턴·onExit) · 탑 100층(입장권·층 배율·보상·10층 상자) · 던전 3(요일·2/일·보상) · 투기장(샘플 10 · EnemyAI 방어 · 메달·주간 순위·조각 상점) · 적장 토벌(주간 순환·hp ×20·5턴·누적 피해·명장 상자·천기) · 결과 패널 → 탭 = 연무장 - 거래: 상자 탭(구매 = 골드/보옥/포인트 · 거래 할인) · 패스·월정액·챕터 팩·첫 결제 팩 = 준비 중 스텁 · 스킬서 임시 판매 제거(사당 던전) - 테스트 87/87(기존 73 유지 · 갱신 3 = 로비 탭 · 표 키 목록 · 상점 스킬서 칸 / 신규 14 = OutGameCTests 12 + 확장 키 2) · console error 0 · 캡처 = DataImporter.CaptureC Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 15:22:54 +00:00
- **아웃게임 2차(2026-11-05~06 #1093 C)** — 표 10장 추가(`training` · `training_ranks` · `patrol` · `dev_tree` · `treasures` · `treasure_sets` · `chests`(+ iron/buy 열) · `tower` · `dungeons`(+ reward_amount) · `arena`(+ 상점 키)) + `economy.csv` C 키 24 → 임포트 자산 18(A 9 + C 9 · `OutGameTables.C.cs` 검증). 코드 = `OutGame/Domestic/`(`TrainingRules` 훈련 · `PatrolRules` 순찰 · `DevRules` 개발 효과 키 → 적용 지점 · `DomesticScreen`) · `OutGame/Treasure/`(`TreasureRules` 보유·세트·강화·조건 카운터·상자 · `TreasureScreen`) · `OutGame/Arena/`(`ArenaRules` 탑·던전·투기장·적장 · `ArenaScreen`). 스탯 = §3-2 × (1 + 훈련(병종·항목)) × (1 + 보물(항목)) = `HeroRules.Compute(…, save)` · 보물 crit/range/splash = `BattleManager.SideEffectsProvider` → `SkillMods.Get` 진영 효과(`side_crit_pct` · `range_mult` · `splash_radius_mult`) · 조건 효과 카운터 = `Runtime/BattleEvents.Raise`(전투 코드 1줄씩 · 아군만) · 연무장 전투 = `BattleManager.StartMode(BattleMode)`(적 편성 · 제한 턴 · 결과 탭 = `onExit`) → `OutGameSession.OnModeEnd`. 테스트 = `Tests/PlayMode/OutGameCTests`. 캡처 = `-executeMethod TKS.EditorTools.DataImporter.CaptureC -cDir <dir>`(사본 · 10장).
- **연무장 허브(PD 2026-11-18 「게임 내 연무장 메뉴에 해당 리소스를 반영」 · 컨텐츠 모드 4종 위에 다시 얹음)** — 연무장 첫 페이지 = 성 안 풍경(`OutGame/Arena/ArenaHub` · 화면 맞춤 `ArenaHubView` = 기준 칸(16:9 1080×1920)이 다 담기는 최대 배율 · 좌우 끌기 스크롤 · 표·그림이 없으면 예전 모드 카드 + 연의 전기 입구). 표 = `Resources/UI/Yeonmu/`: `yeonmu_hub.csv`(키·값 · 장소 → 페이지 `open` = tower · supply(보급전 첫 화면 · 훈련장) · league(투기장) · raid(맹장 토벌전) · scenario(연의 전기) · later(천하 쟁패 잠김) · update(마구간 · `update_key` 글자 「업데이트 예정입니다.」 팝업만 · PD 2026-11-19) · 그림자 · 명패 · 고삐 · 안내 띠) · `yeonmu_actors.csv`(아트 시안 `mk_mock.py` UNITS) · `yeonmu_spots.csv`·`yeonmu_text.csv`·`bg_yeonmu.png`·`layers/*.png+json` = 아트 납품 그대로(새 그림 = 이 폴더 파일만 바꿔 끼움). 상태 줄 실제 값 = `ArenaHub.Args`(탑 최고 층 · 맹장 오늘 기록 도전 메인+서브 / 하루 최대 · 투기장 남은 / 하루 최대 · 맹장 주간 순위 = 서버 순위가 있을 때만 · 연의 전기 = 열린 편 중 연의 못 이긴 첫 편 · 없으면 장소 표 예시 값 · 마구간(「업데이트 예정」)·훈련장 = 글자 키에 값 자리 없음). **잠긴 모드 = 연무장에서 막음(PD 2026-11-19 「투기장, 맹장 토벌전의 경우, 진입 전 단계(연무장)에서 진입을 막도록」)** — `ArenaScreen.SetPage`(허브 누름 · 예전 카드 · 정산 차단과 같은 자리) → `PageLocked`(3 투기장 `LeagueRules.UnlockStage` · 4 맹장 `RaidRules.UnlockStage`)면 페이지 그대로 + `LockOverlay.Notice` 팝업(「개방 조건」 + 덮개와 같은 조건 문장 + 확인 · 글자 `lock_text`) · 이름표 = 이름 앞 자물쇠(천하 쟁패와 같은 모양) + 상태 줄 허브 표 `lock_status`(「출정 {0} 클리어 시 열림」) · 새 소식 점 끔 · 해금되면 `RefreshStatus` 가 걷음(`ArenaHub.IsLocked` · `LockStage` · `StatusText` · `LockShown`). 캡처 `arena_locked` · `arena_stable_notice`. 글자 = `OutGame/UI/UiText`(가장 작은 로컬라이징 · 키 → 언어 칸 · 한글 하드코딩 금지). 층 = `Content`(Frame) → `Art`(Static) · `Scene`(Frame · 유닛·앞 층·고삐 `UiRope`) · `Tags`(Event · 레이캐스터 · 명패 `tre_plaque`·칩·점·자물쇠 = 아틀라스). 새 유닛 = `Units/horse_eat·horse_up·npc_repair·npc_rest·npc_doze`. 배경 임포트 = `UnitArtImporter` UI 풍경 분기(최대 4096 · Compressed). 테스트 = `Tests/PlayMode/ArenaHubTests`.
- **연무장 허브 연출(PD 2026-11-18 「기존 내정 메뉴를 참고해 연무장 화면에 애니메이션 연출 · 맵 내 환경 연출」)** — 표 = `Resources/UI/Yeonmu/yeonmu_scene.csv`(로비·내정과 같은 `LobbyScene` 형식 + `s_spot`·`f_tx`·`f_ty` · 허브 표 키 `scene` · 머리 주석 = 칸 뜻) · 코드 = `OutGame/Arena/ArenaHubFx`(유닛 연출 duel 비무대 대련(번갈아 · 뒷발 맞춤 = 내정 train_feet 값) · shoot 궁병(겨눔 → 쏨 → 화살 포물선 → 과녁에 꼬리만 꽂힘) · zzz 조는 병사 · spark 망치 불똥 · drop 말 건초 = 원화 프레임 번호를 잡음 · cloud 구름 + 땅 그림자 · patch 깃발 자리 바탕) + 환경 = 내정·로비와 같은 `LobbyAmbient`(flag · sway · light = 유닛 아래 `AmbBack` · bird · petal = 유닛 위 `AmbFront`). 유닛 그림 = 원화 클립만 이어 붙임(새로 그린 애니 없음). 연출 그림 = `Resources/UI/Yeonmu/fx/`(생성·오려 내기·복사 = `Tools/yeonmu_fx.py` · numpy 필요 = `C:/ArtRnD/sprite_gen/repo/.venv/Scripts/python.exe` · 아틀라스 `ui_atlas.csv` folder 줄 `UI_Yeonmu`). 층 = Art → AmbBack → Scene → Fx → AmbFront → Clouds → Tags(연출 층 모두 Frame · 누름 없음). 캡처 = `-uiOnly arena_anim,arena_anim_left`(원본 크기 연속 · 왼쪽 끝 스크롤 = 조는 병사 · 훈련장 과녁) · 테스트 = `ArenaHubTests.Hub_Fx_TableBound_Layers_Animate`.
- **투기장 아트 화면(PD 2026-11-18 「투기장 UI 완료 (실제 게임에서 볼 수 있도록 반영해줘)」 · 아트 시안 `content_screens_2/arena/final/mock_arena.png`)** — 연무장 투기장 쪽(page 3) = `OutGame/Arena/ArenaLeague`(허브와 같은 방식 · 화면 맞춤 = `ArenaHubView` · 표·그림이 없으면 예전 더미 `BuildLeague`). 표 = `Resources/UI/League/`: `league_screen.csv`(키·값 · 계급 판 · 이름표 · 목패 · 띠지 · 얼굴 · 유닛 배율 0.2 · 예시 값) · `arena_spots.csv`(납품 그대로) · `league_text.csv`(UiText 키 · `{icon}` = 아이콘 자리) · 배경 `bg_arena_ring_tall_1080x2340`(긴 판 하나 · 16:9 = 위 1920) · 부품 `parts/`(목패 · 띠지 3 · NPC 2 · 9 분할 `parts/import.json` → `UnitArtImporter` UI/League 분기 · 아틀라스 `UI_League`). 값 = 게임 데이터(계급 · 점수 · 다음 등급 · 남은 도전 · 새로고침 무료 · 메달 · 출전 편성 5명·전투력 · 상대 3) · 데이터 없는 칸 = 표 `example_*`(기기 세이브 순위 · 수비 기록 · 정산 시각 모름). 누름 = 목패 → 도전(`LeagueGo` · 도전을 다 썼으면 입장 구매 창) · 무대 → 편성 화면 · 기록관·상인 → 준비 중(화면 없음) · 순위 칩 → 순위 표(서버 모드). 층 = Content(Static) → Art(배경 · NPC · 판 바탕 · Static) · Scene(유닛 대기 숨 · Frame) · Info(값 · 이름표 · 목패 · Event + 레이캐스터). 제목 띠 = 투기장 쪽에서만 「투기장 · 유저 대전 …」. 캡처 = `-uiOnly arena_league,arena_league_tall`(1080×1920 · 1080×2340) · 테스트 = `ArenaLeagueTests`. 해금 전 = 연무장에서 막음(PD 2026-11-19 · 페이지 그대로 + 개방 조건 안내 팝업 · 캡처 `arena_league_locked` = 허브 + 팝업) · 잠김 덮개(PD 2026-11-18) = 투기장에 있는 동안 잠긴 때만(방어) 같은 아트 화면 위에 `LockOverlay`(본문 칸만 어둡게 · 누름 막음 · 자물쇠 · 「개방 조건」 · 출정 장-번호 「스테이지 제목」 클리어 = `content_modes_config` arena.unlock_stage + 스테이지 표 · 표 `Resources/UI/Lock/`).
투기장 · 연의 전기 아트 화면 게임 반영 (PD 2026-11-18 「투기장 UI 완료」 · 「연의 전기 통과」 · 「모두 반영하고 푸시까지」) - 투기장(연무장 page 3) = ArenaLeague + 표 폴더 Resources/UI/League(긴 배경 1080×2340 · 자리 표 납품 그대로 · 설정 표 · 글자 키 · 부품 9 분할 import.json) · 아틀라스 UI_League · 층 Content/Art(Static) · Scene(Frame) · Info(Event + 레이캐스터) - 연의 전기(연무장 page 5) = ArenaScenario(ScenarioFit 화면 맞춤 · ScenarioOpenFx 펼침 6단계) + 표 폴더 Resources/UI/Scenario(탭 배경 5 · 납품 표 3 그대로 · 설정 표 · 글자 키 · 두루마리 8 + 상세 두루마리 9 분할 + 고름 빛) · 아틀라스 UI_Scenario · 상세 = 위 덮개 루트 · 뒤로 = 상세만 닫기 - 공용: ArenaScreen(아트 화면 켜기 · 제목 띠 공용 ViewHeader) · UnitArtImporter(UI/League · UI/Scenario 분기 · 하위 폴더 import.json · max 칸) · UICaptureDriver(LeagueShots · ScenarioShots) · ui_atlas.csv 2줄 · CLAUDE.md 2줄 - 테스트 ArenaLeagueTests · ArenaScenarioTests - 컴파일에 필요해 함께 넣은 다른 세션 파일 = OutGame/UI/UiText.cs · OutGame/Arena/ArenaHubView.cs(연무장 허브 세션 작성) — 허브 본체 · 보물 · 로비 변경은 넣지 않음(공용 파일은 이 작업 줄만) - 검증: 이 커밋 묶음만 둔 사본에서 컴파일 오류 0 · 두 테스트 2/2 통과 · 본체 에디터 콘솔 error 0 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 05:48:47 +00:00
- **연의 전기 아트 화면(PD 2026-11-18 「연의 전기 통과 (게임에서 볼 수 있도록 반영해)」 · 아트 시안 `content_screens_2/scn/final/mock_scn_*.png`)** — 연무장 연의 전기 쪽(page 5) = `OutGame/Arena/ArenaScenario`(표·그림이 없으면 예전 더미 `BuildScenario`). 표 = `Resources/UI/Scenario/`: `scn_screen.csv`(키·값 · 쪽지 글자 · 상태 표시 · 탭 · 펼침 연출 단계 시간 · 상세 배치 · 보상 아이콘) · `scn_tabs.json`·`scn_spots.csv`·`roll_meta.csv`(납품 그대로) · `scn_text.csv`(UiText · `scn_cond_*` = 조건 종류 칩 · 시안 4개 외는 임시 이름) · 탭 배경 `bg_scn_<s1a|s1b|s1c|side|p2>_1080x1920` · 부품 `parts/`(두루마리 8 · 상세 두루마리 9 분할 200/192 · 고름 빛 `part_glow` = 팩 FocusGlow 사본 · `import.json` · `max` 칸 = 큰 부품 임포트 크기 · 아틀라스 `UI_Scenario`). 탭 하나 = 한 화면(5권 이하 · 가운데 정렬) · 상태 = 세이브(완료 = 연의 승리 · 서장 = 본편 n_spec_chapter-n_acts 클리어 · 새 편 = 열린 미완료 첫 편 = 허브 상태 줄과 같음 · 잠김 = 해금 스테이지). 두루마리 누름 = 펼침 연출 6단계(`ScenarioOpenFx` · 누르면 건너뜀) → 상세(위 덮개 루트 TopRoot · 연의/열전 · 승리 · 도전 · 편성 · 첫 승리 보상 · 전장 보기 = 준비 중 · 출전 = `ScenarioGo`) · 뒤로 = 상세 닫기. 화면 맞춤 = `ScenarioFit`(폭 맞춤 · 위 정렬 · 긴 화면 = 배경 아래 바닥 띠를 늘림 · 탭 줄 = 아래 내비 위). 층 = Content(Static) → Art(Static) · Rolls(Event + 레이캐스터) · Chrome(Event) · Floor(Static) · Tabs(Event + 레이캐스터) · 상세 Overlay → Anim(Frame) · Detail(Event). 캡처 = `-uiOnly scn_list,scn_list_b,scn_list_p2,scn_open_anim,scn_detail,scn_list_tall,scn_detail_tall`(캡처용 진행 = 9장 장판파가 새 편 · 찍은 뒤 되돌림) · 테스트 = `ArenaScenarioTests`.
- **천하제일 탑 아트 화면(PD 2026-11-18 「B안으로 진행해」 · 아트 시안 `content_screens_2/tower/final/mock/mock_t_b2·b37.png` · 레시피 R32)** — 연무장 탑 쪽(page 1) = `OutGame/Arena/ArenaTower`(+ `ArenaScreen.Tower` · 표·그림이 없으면 예전 더미 `BuildTower`). 표 = `Resources/UI/Tower/`: `tower_screen.csv`(키·값 · 탑 가운데 · 도전 층 자리 비율 `focus` · 받침 한계 · 하늘 시차 · 현판 글자 색·크기 · 보스 현판(10층마다) · 문 빛 · 화살표 · 정보 판 배치) · `tower_marks.csv`(납품 그대로 · 조각별 층 현판·문 px) · `tower_text.csv`(UiText) · 하늘 `sky_low`(1080×1920 · 받침 행 1760) · `sky_band`(1080×930 · 위로 반복 · 번갈아 뒤집음) · 부품 `parts/`(탑 조각 3 = `tower_top` 1038×1001(100·99·98층) · `tower_floor` 1038×286(3~97층 = 95번) · `tower_base` 1038×858(2·1층) = 아틀라스 밖 단독 · 문 빛 · 번짐 · 화살표 = 아틀라스 `UI_Tower` · `import.json` max 2048). 그림 = 아트 작업 폴더 `export_game.py`(쌓은 판을 한 번에 줄여 정수 행에서 자름 = 반복 층 이음 0). 화면 = 하늘 · 탑(보이는 조각만 그림 · 끌어서 위아래 · 놓으면 미끄러짐 · 꼭대기 · 받침 한계) · 현판 글자(깬 층 금 · 도전 층 · 못 깬 층 회갈 + 어둡게 · 보스 붉은 바탕) · 도전 층 = 문 빛 숨 + 번짐(덧셈 = `GachaCutscene.AddMat`) + 금 화살표 흔들림 · 아래 정보 판(층 · 편성 출처 · 적 얼굴(무장 먼저 · 병종 묶음 · 그림 없으면 병종 아이콘) · 배율 · 첫 클리어 보상 · 최고 층(서버 모드 = 누르면 순위 표) · 입장권 + 광고 · 도전 = `StartMode`). 층 = 화면 → Back(하늘 · 탑 · 현판 = Frame) · Fx(문 빛 · 화살표 = Frame) · Input(끌기 = Event + 레이캐스터) · Chrome(재화 바 뒤 띠 = Static) · Panel(정보 판 = Event + 레이캐스터). 제목 띠 = 탑 쪽에서만 「천하제일 탑 · 100층 · 10층마다 보스」. 캡처 = `-uiOnly arena_tower,arena_tower_10,arena_tower_37,arena_tower_tall`(깬 층을 잠깐 바꿔 찍고 되돌림) · 테스트 = `ArenaTowerTests`.
- **훈련장(보급전) 메뉴 아트 목록(PD 2026-11-18 「위 내용으로 게임에 반영 · 매일 열림 = 요일 없음 · 정해진 요일 = 여는 요일만 · 「/」 판 더 왼쪽으로 짧게 · 버튼과 유닛 안 겹치게」 · 시안 `content_screens_2/supply/final/mock/mock_s_*.png` · 레시피 R33)** — 연무장 보급전 쪽(page 2) 던전 목록 = `OutGame/Arena/ArenaSupply`(+ `ArenaScreen.Supply` 의 `LoadSupplyView` · `ShowSupplyView` · `OpenSupplyTiers` · 표·배너가 없으면 예전 더미 목록 `BuildSupplyList` · 입장 뒤 단계 고르기 = 예전 `BuildSupplyTiers` 그대로). 던전 · 이름 · 요일 · 제한 턴 · 보상 = 게임 표 `ContentModes/supply_dungeons`(「연병장 훈련」 → 「전술 훈련」 · PD 2026-11-18) · 화면 표 = `Resources/UI/Supply/`: `supply_screen.csv`(키·값 · 던전 id → 배너 · 글자 판 색 · 판 알파 · 위 띠 · 카드 · 칩 · 요일 점 · 보상 아이콘 · 입장 · 닫힘 판 배치) · `supply_text.csv`(UiText) · 배너 `banners/banner_<id>.png`(1040×360 · 둥근 모서리 · 테 굽기 · 단독 텍스처) · 「/」 판 `parts/panel_fill · panel_line`(흰 · 틴트 · 아틀라스 `UI_Supply`) · 그림 = 아트 폴더 `export_game.py`. 카드 = 배너(닫힌 날 = 곱하기 색) · 판(이름 · 제한 턴 · 최고 단계 = 세이브 최고 기록 단계 · 요일 점 = 매일 열림이면 없음 · 정해진 요일이면 여는 요일만 · 오늘 = 금 고리 · 보상 칸(1개면 이름 글자)) · 오른쪽 열 = 남은 칩 + 입장(`btn_l_red` + 붉은 틴트) / 닫힌 날 = 「오늘 닫힘 · 여는 요일」 판 + 닫힘 / 잠긴 던전 = 잠김 버튼(못 누름) + 그 카드만 잠김 판. 위 띠(고정) = 오늘 요일 · 오늘 완료 · 주간 도장 · 하루 횟수 · 광고. 층 = 화면 → Strip(Event) · 목록 `UiKit.ScrollGrid`(보는 칸 RectMask2D + 내용 Frame · 레이캐스터). 캡처 = `-uiOnly supply_list,supply_list_bottom,supply_locked,supply_one_locked`(해금 스테이지를 잠깐 바꿔 찍고 되돌림 · 오늘 요일 = 실제 날짜) · 테스트 = `ArenaSupplyTests`. **던전마다 개방 조건(PD 2026-11-19 「보급전(훈련장)의 경우, 각 메뉴별로 각각 개방 조건 · 열리는 시점을 다르게 구성할 예정」)** = 표 `supply_dungeons.s_unlock_stage`(게임 표 + 기획 표 + 생성기 `_content_modes_gen.py` SUPPLY_DUNGEON_UNLOCK · 지금 4곳 모두 1-10 = 모드 기본과 같음 · 비면 모드 기본 supply.unlock_stage) → `SupplyRules.UnlockStage(dg)` · `DungeonUnlocked(d, dg)`(입장 `Can`/`Enter` 도 던전 기준 · 모드 하나짜리 `Unlocked(d)` 폐지 · 서버 모드 = 서버 판정 그대로 · 테스트·캡처 전용 `UnlockOverride`). 페이지(연무장 → 훈련장)는 늘 들어가고 화면 전체 덮개 없음 · 잠긴 카드만 `LockOverlay.ApplyCard`(카드 그림 모양 그대로 어둡게 + 자물쇠 + 「개방 조건」 + 그 던전 조건 문장 · 표 `lock_overlay` card_* × 화면 배율) · 캡처 `supply_locked`(모두) · `supply_one_locked`(병법 훈련만 · 스테이지 표 맨 끝 스테이지로 잠깐).
- **맹장 토벌전 아트 화면(PD 2026-11-18 · 시안 `content_screens_2/raid_banner/final/mock_raid.png`)** — `OutGame/Arena/ArenaRaid.cs` · 표 `Resources/UI/Raid/` · 테스트 `ArenaRaidTests` · 캡처 `-uiOnly arena_raid,arena_raid_shop,arena_raid_locked`. 해금 전 = 연무장에서 막음(PD 2026-11-19 · 페이지 그대로 + 개방 조건 안내 팝업 · 캡처 `arena_raid_locked` = 허브 + 팝업) · 잠김 덮개 = 맹장 토벌전에 있는 동안 잠긴 때만(방어) 같은 카드 · 점수 띠(도전 = 잠김 버튼) + `LockOverlay`(raid.unlock_stage + 스테이지 제목) · 서브 「연습」 = 남색(흰 바탕 버튼 + 틴트 · 표 btn practice) · 넘김 = 채운 삼각형(테마 `arrow_down` 을 표 각도로 돌림 · 표 arrows).
- **연무장 진입 막기 · 던전별 개방 · 마구간(PD 2026-11-19)** — 투기장 · 맹장 토벌전 = 해금 전이면 허브 장소(비무대 · 성문)를 눌러도 페이지로 안 가고 「개방 조건 · 출정 x-x 「스테이지」 클리어」 창만(이름표 = 자물쇠 + 「출정 x-x 클리어 시 열림」 · 표 `yeonmu_hub.csv` `lock_status` · `ArenaScreen.SetPage` 에서도 막음) · 보급전 = 페이지는 늘 열림 · 던전마다 개방 조건 `supply_dungeons.csv` `s_unlock_stage`(지금 4곳 모두 1-10 · 비면 모드 기본 `supply,unlock_stage` · 기획 표 · 생성기도 같은 칸) → 잠긴 카드만 그 카드 위에 어둡게 + 자물쇠 + 개방 조건 · 입장 판정도 던전별 · 마구간 = `open,stable|update` → 「업데이트 예정입니다.」 창만 · 캡처 `-uiOnly arena,arena_stable_notice,supply_one_locked` · 테스트 = ArenaHubTests · ArenaSupplyTests · ArenaLeagueTests · ArenaRaidTests.
- **안내 팝업 글꼴 · 메뉴 숨김(PD 2026-11-19 「"업데이트 예정입니다." 와 같은 모든 안내 팝업 UI 폰트를 우리 게임 폰트로 통일」 · 「메인 로비에서 동맹 메뉴 버튼은 숨겨(추후 기능 추가 시 제공)」)** — 팝업 = `OutGameRoot.ModalCustom` 이 팝업 뿌리에 `UiFontUnify`(OutGame/UI)를 붙임 → 열려 있는 동안 그리기 직전마다 팝업 안 모든 글자(제목 · 본문 · 버튼 · 호출 쪽이 채운 내용) = 테마 제목 글꼴(Maplestory) · 토스트 글자도 같은 글꼴 · 숨김 = 표 `Resources/UI/menu_hidden.csv`(`tab` = 하단 탭 번호 → 남은 탭이 폭을 고르게 · `lobby_side` = 로비 세로 버튼 id → 아래 버튼이 올라옴 · 지금 = 동맹 탭 3 · alliance) · 기능을 열 때 표에서 값만 빼면 됨 · 테스트 = OutGameTests.Lobby_Tabs_Back_ComingSoon(`OnTab(3)` 호출은 그대로 동작).
- **영웅 정보 장면 배경 · 무대형 편성 · 카드 성급 색(PD 2026-11-19 「원색 배경 → 진영 컨셉 + 태생 ★ 단계별 화려함」 · 「투기장 무대를 배경으로 영웅을 교체하는 화면」 · 「카드 = 미보유 그대로 · 1성 녹 · 2성 파랑 · 3성 보라 · 4성 주황 · 5성 붉은」)** — ① 영웅 정보(`HeroDetailScreen`) = 표 `Resources/UI/HeroBg/hero_bg.csv`(`bg` 줄 = 진영|태생 ★(heroes rarity)|그림 · 같은 진영 없으면 other · 같은 ★ 없으면 낮은 ★ · 패널 색 `panel_*` · 일러 뒤 빛 `glow` · 그림자 색 `shadow` · 바탕 `base` · **발밑 그림자 크기 = 표 `unit_shadow.csv`(초상 f000 의 발 띠 폭 실측 · 아트 폴더 `measure_footprint.py` 로 다시 생성 · 새 유닛을 넣으면 다시 돌림) × `shadow_size`** (PD 2026-11-19 「그림자가 캐릭터 크기에 맞게」)) + 그림 12장(1080×1920 · 영웅 발 y 806 = 단/빈 땅 가운데로 구운 판 · 아래끝 = base 색) · 장면 층 = `SceneArt`(Static) · 표가 없으면 예전 등급 색 바탕 · 그림 작업 = `C:/ArtRnD/sprite_gen/ui_illust/samguk/hero_bg/`(`spec_hero_bg.json` 문장 · `post_spec.json` 발 자리·확대) ② 편성(`FormationScreen`) = 표 `Resources/UI/Formation/formation_screen.csv`(무대 그림 · 자리 발 좌표 `seat`(x|y|`above` = 이름표 머리 위 · PD 2026-11-19 「가운데로 모이게」 → 2차 「20 % 더 좁게」 = 전열 발 678 · 후열 858 · 전열 이름표 머리 위) · 유닛 배율 · 원판 · 이름표 · 위 띠 · 보유 판 · 좌표 = 그림 px = 화면 px) + 그림 `bg_formation_stage`(투기장 승인 배경 1.3배 확대 자름 · 생성 0) · 층 Stage → Art(Static) · Seats(Event) · Select(Frame · 호흡) · Units(Frame · 대기 숨 `UiFrameAnim`) · Info(Event + 레이캐스터 · 누름 칸 `Slot<i>` · 이름표 `Plate<i>` · 빈 자리 `Plus<i>`) · 표가 없으면 예전 패널형(`BuildPanels`) · 공개 API(TapSlot · TapCard · Place · Swap · SaveNow) 그대로 ③ 카드(`CollectionCards.Card`) 바탕·그라데이션·빛 = 보유면 테마 `card_star<n>_bg|grad|glow`(n = 현재 ★ 1~5 · ui_theme.csv) · 미보유 = `grade_white_card_*` 그대로 · 공용 표 읽기 = `OutGame/UI/ScreenTable` · 캡처 `-uiOnly formation,formation_select,formation_tall,hero_bg_<진영>_<★>,hero_bg_tall,hero_list_stars`(촉 ★1 = 장수 없음 · 병사만) · 테스트 = OutGameTests.Formation_PresetToSpawn_FullAndPartial · UILayerTests.Canvases_SplitByUpdateRate_InputAndAtlas.
- **영웅 성장 화면 재설계(PD 2026-11-20 「정보 · 진화 · 각성 · 외형 버튼 · 하단 메뉴 · 아이콘을 우리 화풍으로 · 영웅 정보 배경 = 로비와 같이 · ◀ ▶ = 제목 좌우 · 성장 내역 단순 · 열전 = 열전 + 인물 설명만 · 진화 = 직관 · 비주얼」 · 기획 = Fable 초안 `C:/ArtRnD/sprite_gen/ui_illust/samguk/growth_ui/design/디자인기획_초안_r1.md`)** — 공용 = `OutGame/UI/GrowthUi`(제목 좌우 ◀ ▶ `TitleArrows` = 이름 Prev · Next · 판 윗변 고정 + 높이 = 내용 `Place`(표 panel_top · 모든 성장 창 ◀ ▶ · 닫기 같은 자리) · 로비 배경 장면 창 `Scene`(그림 `Resources/UI/Growth/scene_lobby` = bg_lobby x 160~920 · y 300~1060 의 2배 · 영웅 = 로비 규칙 unit_px 206 × zoom · 발밑 그림자 = 로비 표 shadow 줄 · 영웅 = Frame 층 `SceneUnit`) · 명패 `Plaque`(tre_plaque) · 목패 `Tag`(tre_tag) · 칸 `Row` · 그림 판 `Paint`(Samguk 납품 아이콘을 9 분할 판으로)) · 값 = 표 `Resources/UI/Growth/growth_ui.csv`(창별 장면 x|y|폭|높이|zoom|발 원본 x|y|창 안 발 x|y · 메뉴 판 · 아이콘 id · 색) · 표가 없으면 예전 화면. ① 영웅 상세 메뉴 4 = **이전 메뉴 UI 그대로**(남색 둥근 `round08` + 광택 띠 · 테마 menu_btn) + 새 스티커 아이콘 `ic_menu_info|evolve|awaken|costume`(버튼 안 · `HeroScreens` · 이름 Menu0~3 · PD 2026-11-20 2~3차 「옻칠 목패 = 지저분 · 화풍 안 맞음 · 퇴보」 반려 → 목패 그림 폐지) ② 하단 탭 = **승인 화면의 팩 띠 + 붉은 솟음 판 그대로**(대들보 띠 · 아치 명패 그림 폐지 · 반려본 = 아트 폴더 `growth_ui/_prev_r1_game/`) · 아이콘만 새 그림 `Samguk/menu/tab_*`(5 · 동맹 포함) · 크기 · 위치 = growth_ui tab_focus(원래 값) ②-2 로비 세로 버튼 6 = **프레임 없이 스티커 아이콘만 + 외곽선 글자**(PD 2026-11-20 「로비 아이콘도 같은 화풍 · 배경 프레임 없이」 · 표 `Resources/UI/lobby_side.csv` = 판 스킨(비면 프레임 없음) · 아이콘 크기 · 글자 · 자물쇠 · 표가 없으면 예전 팩 버튼) · 그림 `Samguk/lobby/lobby_<mission|mail|option|recruit|shop|chest|event|alliance>.png`(PD 2026-11-20 4차: 임무 = 붉은 영패 + 명패 가운데 **상아 백옥 「M」 별**(임무 포인트 · 등급 금별과 구분 · M = 게임 제목 글꼴 짙은 갈색 새김 · 푸른 별 = PD 「안 어울림」 → 후보 4(비취 · 청록 · 상아 · 은) 중 상아) · 우편 = 봉랍 서신 · 옵션 = 평범한 금빛 기어 · **등용**(오른쪽 맨 위 = 옛 상점 자리 · 거래 「명장 등용」 탭 · 초가집 문틈 금빛 = 등용 연출과 같은 소재) · 상점 = 거래 대저울(tab_trade 사본) · 상자 = 실제 상자 컨텐츠 `Samguk/chest/chest_gold` 가장자리 정리본 · 이벤트 = 위 고리에서 등롱 앞 가운데로 드리운 큰 소원지 + 「Event」(게임 제목 글꼴 붉은 먹색 · 소원지 긴 축 방향 · PD 「더 가운데 방향으로 내려오게」) · 동맹 = 탭 군기 사본 · 오른쪽 열 = 등용 · 상점 · 상자 · 이벤트(166 간격)) ③ 영웅 정보(`HeroInfoWindow`) = 장면 창(영웅 오른쪽) + 진영 · 병종 · 승급 칩 + 이름 명패 + 별호 · ★ · Lv 판 + 전투력 목패(각성 몫 안) · 기본 능력치 칸 아이콘(growth_ui base_icon) · 성장 내역 = 칸 6(이름 Grow_<key> · 바로가기 폐지) · 열전 = 인물 머리(이름 · 한자 · 별호 · 병종) + **인물 설명 문단**(표 `Resources/UI/HeroInfo/hero_desc.csv` = 기획 표 `tables/hero_desc.csv` 사본 · s_key = 영웅 id · 없으면 생략) + 사건 문단(Ev_<n> · 연표 막대 · 연도 배지 · 연의 전기 바로가기 폐지) ④ 각성(`AwakenWindows.OpenAwaken2`) = 장면 창(영웅 왼쪽 · 오른쪽 명패 · ★ · 전투력 · 각성 몫) · ⓘ(Help) = 확률 창 · 잠금 수 칩 · 각성석 칩 · 줄 = 등급 도장 `grow_seal`(등급 색 틴트) + 능력치 + 범위 안 위치
이벤트 화면 — 출석부(오픈 기념 7일 · 일일 14일) · 7일 특별 미션 · 행운 룰렛 · 이벤트 미션 · 선물 팩 팝업 · 특별 이벤트 「준비 중」 (PD 2026-11-19 「게임에 구현해」 · 시안 7장 event_attend/final/mock) PD 결정 4건(모두 추천안): - ① 로비 오른쪽 「이벤트」 버튼 · 기기 세이브 모드만(OutGameSession.EventAvailable · ServerSession = false → 준비 중 · 서버 이벤트 API = 따로) - ② 유료 선물 팩 = 「결제 준비 중」 토스트만(지급 0) · 광고 칸 = 시험 즉시 지급 하루 3회 - ③⑤ 값 = 시안 예시 그대로 게임 표 · 룰렛 판 = 시안 돌(흰 · 검은 · 최종 금 상감) · 등급 색 = 확률 정보 창에만 - ④ 하루 = 0시 · 접속일 기준(출석 = 접속한 날마다 1칸 · 일일 14일 = 다 받으면 새 회차 · 7일 미션 = 첫 접속일부터 하루 1일차 · 룰렛 = 표 날짜 · 문구 「오전 5시」 → 「0시」) - 규칙 표 Resources/Event/*.csv(event_config · items · kinds · attend · mission7(_steps) · roulette(_extra)) → EventData · EventRules · 세이브 SaveData.ev(EventState) - 화면 OutGame/Event/EventScreen(+ Attend · Mission · Roulette · EventSpin) · 화면 표 Resources/UI/Event/event_screen.csv · 글자 event_text.csv(그림에 글자 0) - 층(P41) = Bg(Static) · Page/Art(Static) · Page/Info(Event + 레이캐스터) · Page/Fx(Frame) · EventTabs(Event) · 부품 아틀라스 UI_Event - 미션 집계 = OutGameSession 동작 성공 경로마다 EventRules.Count 한 줄 · OutGameRoot(이벤트 화면 등록 · ShowEvents · OwnTabBar) · LobbyScreen(이벤트 버튼 + 받을 것 붉은 점) - 받은 칸 탈색 셰이더 Resources/UI/UiGray.shader · 세로 그러데이션 OutGame/UI/UiGradient · 임포트 분기 UnitArtImporter UiEventRoot - 공용 표 읽기 OutGame/UI/ScreenTable 함께 올림(이벤트 화면이 씀 · 같은 날 영웅 배경 · 편성 미커밋 작업에서 만든 파일) - 캡처 UICaptureDriver -uiOnly event_*(9장) · 테스트 EventTests 2 검증: 컴파일 오류 0 · EventTests 2/2 · OutGameTests.Lobby_Tabs_Back_ComingSoon 1/1 · UILayerTests.Canvases_SplitByUpdateRate_InputAndAtlas 1/1 · 캡처 9장 시안 대조 · Fable QA r1 PASS(B 0) → M 일괄 수정 · 이 커밋 묶음만(HEAD + 이벤트) 검증 사본 배치 컴파일 오류 0 섞인 파일(OutGameRoot · LobbyScreen · UICaptureDriver · CLAUDE.md)은 이벤트 부분만 올림 — 메뉴 숨김 · 팝업 글꼴 · 영웅 배경 · 편성 변경은 작업 트리에 그대로(미커밋) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-19 13:37:08 +00:00
- **이벤트 화면(PD 2026-11-19 「게임에 구현해」 · 시안 7장 `C:/ArtRnD/sprite_gen/ui_illust/samguk/event_attend/final/mock/mock_event_*.png`)** — 로비 오른쪽 「이벤트」 버튼 → `OutGameRoot.ShowEvents` → `OutGame/Event/EventScreen`(+ `.Attend` · `.Mission` · `.Roulette`) · **기기 세이브 모드만**(PD 결정 ① · `OutGameSession.EventAvailable` · 서버 모드 = `ServerSession` false → 버튼 준비 중 · 서버 이벤트 API = 따로) · 자기 하단 탭 4(출석부 · 특별 미션 · 행운 룰렛 · 특별 이벤트 = 「준비 중」 토스트만 · `OutGameScreen.OwnTabBar` = 메인 하단 탭 끔). 규칙 표 = `Resources/Event/*.csv`(값 = 시안 예시 · PD 결정 ③ · `event_config` 기간 · 횟수 · 룰렛 날짜 / `event_items` 보상 id → 지급(cur_shard = 무작위 보유 영웅 조각 · cur_ticket = 탑 입장권 · 영웅이 이미 있으면 등용 중복 조각) / `event_kinds` 미션 종류 → 글자 키 · 이동 / `event_attend` · `event_mission7(_steps)` · `event_roulette(_extra)`) → `EventData` · 규칙 `EventRules`(하루 = `EconomyRules.DayKey` 0시 · 출석 = 접속한 날마다 1칸 · 일일 14일 = 다 받으면 다음 접속일 새 회차 · 7일 미션 = 첫 접속일부터 하루 1일차 · 룰렛 = 가중치 + 한정 n회 안 반드시 + 최종 n회마다 반드시 · 유료 팩 = 「결제 준비 중」 토스트만(PD 결정 ②) · 광고 = 시험 즉시 지급) · 세이브 `SaveData.ev`(`EventState`) · **미션 집계 = `OutGameSession` 동작 성공 경로마다 `EventRules.Count` 한 줄**(레벨업 · 승급 · 진화 · 스킬 · 등용 · 군량 · 클리어 · 소탕 · 내정 훈련 · 보물 강화 · 훈련장 · 투기장 도전/승 · 맹장 · 금화 = Commit) · 상태형(탑 층 · 깬 스테이지 · 별 · 연의 전기 · n성 영웅) = 세이브에서 계산. 화면 표 = `Resources/UI/Event/event_screen.csv`(자리 · 크기 · 색 = 시안 px 그대로 · 시안 판 `Page` 를 배율 Z 로 맞춤 · 긴 화면 = 판 · 목록이 늘고 아래 묶음은 아래로) · 글자 `event_text.csv`(그림에 글자 0 · ₩ = 본문 글꼴) · 그림 = 아트 폴더 `event_attend/export_game.py`(배너 3 · 팝업 머리 2 = `banners/` · 바둑판 `big/`(안쪽 나무 면 실측 → 표 rou_board) · 룰렛 배경 · 부품 `parts/` = 아틀라스 `UI_Event`). 층 = 화면 → Bg(Static) · Page/Art(Static) · Page/Info(Event + 레이캐스터) · Page/Fx(Frame · 룰렛 도는 고리 `EventSpin`) · EventTabs(Event) · 팝업 = 위 덮개 루트(Event). 받은 칸 아이콘 탈색 = `Resources/UI/UiGray.shader`(비 = 표 gray) · 세로 그러데이션 = `OutGame/UI/UiGradient`(정점 색). 캡처 = `-uiOnly event_*`(9장 · 시안과 같은 진행을 메모리 세이브에 만들고 되돌림 · 나란히 = 아트 폴더 `compare_game.py`) · 테스트 = `EventTests`(규칙 1 · 화면 1).
장수 스킬 144개 새 기획 구현(#1112 · PD 2026-11-10 엑셀 「장수 목록」) — 효과 표 skill_effects.csv(효과 1줄 · 한글 주석 열) · 이름 56개 새로 - 수치 SOT = Assets/Data/OutGame/skill_effects.csv(skill_id·key·target·cond·dur·p1~p3 + effect_ko·p1_ko~p3_ko 주석) · skills.csv effect_key = 키 목록 · heroes.csv gender(m|f) - 처리기 121종(SkillKeys) · 대상 칸(자신·같은 편·진영·반경·행동 반경) · 조건 칸(치명타·상대 상태 이상·병종·성별·턴·장착 중) · 지속 라운드 - 상태 이상 = 혼란·출혈(이동 거리 비례)·중독(중첩)·화상 + 기절(기믹 행동 불가 재사용) · 정화 · 회복·흡혈·부활·무적·무효화·호위(반격) - 재행동(유비·위연·여몽·손견·곽가·우금·맹획·감녕·고순·장합) · 치명타 확률·피해·무조건 - 이동 변형: 관통(손견·안량·손책 아군 통과) · 핀볼 튕김(손책·동탁) · 복귀(조운·손책·여포·문추·공손찬·순우경 · 하후돈 탭 지점·쓸어 감) · 위치 교환(위연) · 끌어오기(장료) · 아군 통과+탭 방향 밀치기(조조) · 반복(정보) · 난동(동탁) - 특수 사격: 거대 화살 · 직선 관통 · 폭발(화염구·독구름·운석·화살비) · 부채꼴 · 멀티샷 · 도탄 · 회오리 · 목책 · 불 장벽·불꽃·독 지대 · 궁병식 비도 · 광역 회복 - 즉시형: 광역 타격·밀기 · 흡수 · 일제 사격 · 미인계 끌어오기 · 범위 회복·정화 · 재행동 부여 · 변진 - 가상 실행(적 AI) 스킬 상태 사본(TakeState/RestoreState) · 옛 견제 스킬 확장 제거 - 테스트(고친 부분 클래스만): SkillTests 19(새로) · BattleFlowTests 42 · TacticalAITests 7 · GimmickTests 19 · OutGameTests 15 · OutGameCTests 12 전부 통과 · console error 0 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 10:00:18 +00:00
- **영웅 72명(PD #1108 · 2026-11-10)** — heroes 87행(영웅 72 + 병사 15) · skills 144 · skill_effects 288 · 옛 키 체계(51+4종 · 견제·관통 배율 등)는 #1112 에서 폐기.
- **지형 기믹 레이어(PD #1097 · 2026-11-06 세션 D)** — SOT = `Assets/Data/Gimmicks/{gimmicks,stage_gimmicks,tutorial_tips}.csv`(기획 `tables/` 사본 · utf-8-sig) → 메뉴 `TKS/Import Gimmicks (기믹 임포트)`(`Editor/GimmickImporter` · 오류 시 자산 불변 · `ai_weights.csv` 도 함께) → `Resources/Gimmicks/GimmickDb`·`StageGimmickTable` · `Resources/AI/AiWeights`. 전투 시작 = `GimmickLayer.Build(stage)`(장-번호 배치 · 배경 위 · 유닛 아래 · 장애물 = 콜라이더 + `GimmickBody` · 지대 = 모양 스윕 · 강 = 늪처럼 통과하는 지대(강 안 ×p3 · 다리 구간 = 효과 없음 · 강가·다리에서 밀려 강물에 들면 빠짐 · PD 2026-11-06 개정) · 겹친 유닛은 빈 자리로). 전투 코드는 질의만: `Combat.FreeTravel`(장애물 = 벽 · 숨은 함정 정지) · `FirstUnitOnArrow`(pass/block/destroy) · `Combat.Damage`(군기 공 · 고지 근접 피격 · 안개 원거리 피격 ×p1 · 책사 광역이 그 반경 안개를 걷음) · `SkillMods.Range`(고지 사거리) · `BattleManager` 턴 시작 `TurnStart`(군기·중독·불·행동 불가). 충돌 반응·폭발·굴림·미끄러짐·지대 = `Gimmicks/ActionResolver.Gimmicks.cs`(partial). 배치 도구 = `TKS/Gimmick Painter (기믹 배치)`. 테스트 = `Tests/PlayMode/GimmickTests` · 캡처 = `-executeMethod TKS.EditorTools.GimmickImporter.Capture -gimmickDir <dir>`(사본 · `-gimmickStages 1-3,…` 시작 화면 · `-gimmickPlayView 1` 전투 배율 1장 더 · `-gimmickCatalog 1` 16종 견본 평상시·상태 변화).
- **지형 기믹 그림(PD 2026-11-10 #1113 「기획된 지형을 화풍에 맞게」)** — 그리는 법 SOT = 표 `Assets/Resources/Gimmicks/gimmick_art.csv`(기믹 id 1줄 · 전투마다 다시 읽음 · 머리 주석이 칸 설명) → `Runtime/Gimmicks/GimmickArt`. **아이콘을 모양 크기로 늘리지 않는다**: 지대 = 모양 거리장 + 월드 좌표 반복 타일(`Resources/Gimmicks/Tiles/` · Read/Write 임포트) + 테두리·그늘·절벽/앞면·외곽선을 전투 시작 때 한 장으로 굽고(캐시 · `GimmickArt.BeginBuild/EndBuild` 로 정리) · 물체 = `Resources/Gimmicks/Art/` 스프라이트를 비율 유지로 세움(object · scatter(`;` 로 여러 그림) · strip 말뚝 줄 · gate 성벽 바닥 + 성루 · banner 원 + 진영색 깃발) · 상태(부서짐 → `sprite_alt` · 불 꺼짐 → `out_tint` + 숯 · 성문 → `base_alt` 돌무더기) · 그림이 있으면 이름 글자 끔. 표에 줄이 없으면 예전 방식(늘린 아이콘/색 도형). 임포트 = `Editor/GimmickArtImporter`. **2차(Fable 1안 시제 · PD 2026-11-10 「인게임 화풍 = 카피바라 Go 류」)**: `patch` = 그림(Art)으로 바닥 지대 — `sprite_round`(원) · `sprite_oval`+`oval_max`(가로세로비 이하) · `sprite_long`(그보다 긴 것) = **통째 그림을 모양 크기로 늘림**(자연 웅덩이 · 낮은 언덕 · 굽이진 강) · 셋 다 없으면 `sprite`+`border`(9-slice · `ppu` · `ext_b`) · scatter `edge`/`edge_sprite`(가장자리 소품) · `obj_layer ground`(물결 = 다리 아래) · `jitter`/`flip`/`obj_a` · strip `sprite` 3개 = 왼끝;가운데(반복);오른끝(녹각 목책) + `shadow` · 안개 = 구름 덩어리 흩뿌림 + 책사 광역 반경 덩어리만 사라짐(`GimmickView.ClearPuffs`). 견본 캡처 = `-gimmickCatalog proto`(크기 변형 · 상태 · 전투 배율 + 유닛). **3차(남은 9종 · 2026-11-11 · 16종 전부 그림 방식 · 굽기(zone) 줄 0)**: strip `sprite_v` = 세로 구간 마디(위끝;가운데;아래끝 · 폭 = 모양 폭 · 세로만 늘려 이음 없이 · 8-6 세로 성벽) · patch `sprite_alt` 「둥근·타원;긴」 = 고른 통째 그림에 맞는 상태 그림(불 꺼짐 · `out_tint` #FFFFFF) · 성문 = object(성루 + 문 한 장 · 부서짐 = `sprite_alt`) · 군기 원 = patch 돌 원(점령 진영 색을 곱함) · 함정 = object(덮개 · 드러나면 말뚝 구덩이). 시안·원본 = 조직 작업 폴더 `C:\ArtRnD\samguk_terrain\`(`styles.json`·`game_rows.json` → `to_game.py` 가 표·타일·그림을 씀) · 기록 = 조직 레포 `공유/대화로그/삼국지슬링샷/2026-11-10_지형그림_화풍반영.md`.
지형 기믹 레이어(PD #1097 세션 D) + 병종 규칙 개정 2건 · 예측 시뮬레이션 적 AI(PD #1098) - 데이터: Assets/Data/Gimmicks/{gimmicks,stage_gimmicks,tutorial_tips}.csv + Assets/Data/AI/ai_weights.csv(기획 tables/ 사본) → 메뉴 TKS/Import Gimmicks(검증 · 오류 시 자산 불변) → Resources/Gimmicks/GimmickDb(16)·StageGimmickTable(16 + 팁 3) · Resources/AI/AiWeights(32) - 레이어: GimmickLayer(전투 시작 = 스테이지 배치 · 배경 위 유닛 아래 · 원/사각/다각 · 색 도형 + 글자 · 내구 핍 · 강 콜라이더 = 다리 구간 제외 · 겹친 유닛 보정) · 장애물 = 병종별 내구 피해·튕김·창 목책 밀기·바위 굴림·기병 정지 · 투사체 pass/block/destroy · 폭약 광역(아군 포함)+밀기+불 · 책사 광역 덤불 제거 · 강 낙하 - 지대: 경로 스윕(독 1→2→3 % · 늪 ×2 · 불 10 % · 빙판 미끄러짐 · 고지 · 안개 · 군기 · 함정) · 양 진영 턴 시작 훅 - 규칙 개정: 보병 튕김 중 다른 적과 연쇄 1회 · 창병 반작용(spearRecoilRatio · 밀며 전진 폐기) · 기존 테스트 기대값 갱신 - 적 AI: Runtime/AI(Sim 가상 실행 · TacticalAI 후보·점수·난이도·턴 운영 · 1부 보스 액티브) · 조준선 = 가상 실행 예상 궤적·기믹 반응·지대 띠 · TKS/Gimmick Painter · 캡처 GimmickImporter.Capture - 검증: 컴파일 0 · 플레이모드 113/113(신규 26) · console error 0 · 적 10기 턴 결정 62 ms Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 16:20:07 +00:00
- **병종 규칙 개정 + 예측 AI(PD #1098 · 2026-11-06)** — 보병 = 적과 싸운 뒤 튕겨나는 길의 다른 적과 연쇄 교환 1회(`ActionOutcome.Chains`) · 창병 = 상대만 밀리고 자신은 × `spearRecoilRatio` 반대로(밀며 전진 폐기). 적 턴 = `Runtime/AI/TacticalAI`(후보 방위 × 파워 3 × 액티브 → `Sim` 가상 실행(연출 없음 · 분산 0 · 상태 복원) → `ai_weights.csv` 점수 · 서포터 → 돌격 → 사격 · 1기마다 재평가) · 가중치 자산이 없으면 `EnemyAI.Decide`(기존 조준) · 적 액티브 = 1부 보스만(`boss_active`). 가상 실행 중(`Sim.Active`)에는 `Fx`·`UnitView`·`BattleEvents`·HUD 갱신이 꺼진다 — 새 연출 코드도 `Sim.Active` 면 건너뛸 것. 조준 미리보기도 같은 가상 실행(`GimmickPreview` · 숨은 함정 모름). 테스트 = `Tests/PlayMode/TacticalAITests`.
- 아웃게임 코드 = `Assets/Scripts/OutGame/**`(asmref → TKS.Runtime) — `OutGameSession`(표 + 세이브 · 바꾸는 동작은 즉시 저장) · 규칙 `HeroRules`·`EconomyRules`·`GachaRules` · 화면 `UI/`(로비·영웅·편성·거래·결과 패널 · `OutGameRoot` 가 전환). 세이브 = `persistentDataPath/save.json`(테스트·검증 캡처는 `SaveStore.UseMemory` / SessionState `TKS_SAVE_MEMORY` 로 메모리 전용). 출전 = `BattleManager.LineupProvider`(편성 프리셋 → `playerSpawnPoints` 자리 0~2 전열 · 3~4 후열). 화면 캡처 = `Unity.exe -projectPath <사본> -executeMethod TKS.EditorTools.DataImporter.CaptureOutGame -outgameDir <dir>`. **UI 수정 검증은 고친 화면만 찍는다**(PD 2026-11-09 「매번 모든 화면 체크 = 시간·토큰 낭비」): `Tools/mirror_verify.py` → `Unity.exe -projectPath E:/Nerdnavis/_tks_verify -force-d3d11 -executeMethod TKS.EditorTools.DataImporter.CaptureUI -uiDir <dir> -uiOnly hero_list,hero_detail*`(이름 = 정확히 또는 「접두*」 · 다 찍으면 바로 종료 · 1장 ≈ 15초 · 전체 21장 ≈ 3분 · 이름 목록 = `UICaptureDriver` 의 Shot 이름).
- **챕터·스테이지 SOT = `Assets/Data/Stages/*.csv`(utf-8-sig · 2026-11-05 145 스테이지 · 기획서 #1086 §4 전사)** — `stages.csv`(chapter·stage·title·type normal|elite|boss·place·faction·병종 4 수·generals `id:병종:true|false`·bg_theme·note) · `chapters.csv`(장 제목·연도·**월드맵 맵 id**·AI 출발값) · `generals.csv`(무장 id → 이름·배율 덮어쓰기) · `factions.csv`(세력 코드 → 이름·병사 아트 접두). 고친 뒤 메뉴 `TKS/Import Stages (스테이지 임포트)`(`StageImporter` · 형식 오류면 자산 미변경) → `BalanceConfig.chapters·stages`. 적 좌표 = `BalanceConfig.formation` 규칙(전위·중군·후군·장수 줄 · `StageTable.Enemies`) · 장수 배율 = `generals.csv` 가 비면 `boss/eliteGeneral*Mult`. 월드맵 노드 = 스테이지 표(챕터별 수 · 보스 = type boss) · 노드 자리 = `ChapterMap/Data/<맵>.json` `slots_N`(없으면 길 위 균등).
성장 · 임무 · 출정 · 외형 · 정보 일괄 — 임무(미션) 메뉴 · 영웅 각성 · 진화(진영 비서) · 스킬 강화(영웅 조각 + 만능 조각) · 각성 칸 = 승급 장비 등급 · 장비 등급 7(불멸 red · 신화 rainbow) · 병종 장비 210 · 장별 드랍 · 영웅 Lv100 · 출정 = 로비 편성(학습 판 = 연의 전기만) · 보스 말풍선만 · 1장 레벨디자인 · 외형(코스튬) 꾸미기 레이어 · 영웅 정보(능력치 · 열전) - 임무: 일일 · 주간 · 업적 · 카운터 36 · 우편 · 로비 버튼(MissionTests) - 각성 · 진화: 표 11장 · 진화 = ★ 최대 레벨 + 진영 비서 + 골드 · 비서 교환 · 각성 굴림 · 잠금 · 칸 = 승급 장비 등급(AwakenTests) - 스킬 강화: skill_upgrade · skill_config(최고 Lv10 · 상한 = 영웅 레벨 10 단위) · 만능 조각 확인 팝업 - 장비: gear_grades · gear_kinds · gear_drop_chapters · gear_drop_stages · 승급 7단계 · 무지개 7색 순환(UiRainbow) · TKS/Import Gear(GearTests) - 출정: 학습 판 = 연의 전기 서장만(WantsTutorialPlan) · boss_intro_config talk_main · 1장 표 · 1-4 가시덤불 정정(MainStageTests · TutorialTests [Ignore]) - 외형: 부위 4(외형 = 추후) · 꾸미기 9 · 기준점 · 알파 경계 · 전투 · UI 레이어 · 미리보기 · 상세(CostumeTests) - 정보: 능력치(기본 + 성장 = 합계 · HeroRules 그대로) · 전투 능력치 7 · 성장 내역 · 내역 창 · 열전(HeroInfoTests) - 같은 작업 트리의 다른 세션 미커밋 변경(스킬 이펙트 · 전투 해석기 · 보급전 표 · 스킬 표 등)은 넣지 않음 PD 2026-11-20 「지금까지 본 PC에서 구현된 모든 성장 관련 기능을 다른 세션에서 확인할 수 있도록 푸시까지 진행해」 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-20 03:15:36 +00:00
- **출정 = 로비 편성 · 학습 판은 연의 전기만(PD 2026-11-20 「출정은 로비에서 편성한 영웅들로 · 튜토리얼은 연의 전기에서 · 출정 메뉴에서는 튜토리얼 기능을 뺀다」)** — `BattleManager.WantsTutorialPlan` = 연의 전기 서장(UsesTutorialPlan)만 · 출정은 시험 강제(ForceOn) 포함 어떤 경우에도 학습 판 없음 → 아래 「1장 학습 판」의 출정 적용 · `TutorialTests`(출정 판 기준 · [Ignore]) 는 지난 설명 · 출정 1장 = `stage_layout.csv` 1장 배치(기획 `_level_design_gen.py --apply`) · 보스 연출 주고받기 = `boss_intro_config talk_main`(0 = 말풍선만) · 테스트 = `Tests/PlayMode/MainStageTests`(4 + 캡처 Explicit → `Logs/main_stage_capture/`).
- **1장 학습 판(PD 2026-11-12 「초반 10개 스테이지는 우리 게임의 기본적인 기능을 학습할 수 있는 시나리오 구성 및 스테이지 구성」 · 개발 요청서 C5 · 2026-11-13)** — SOT = `Assets/Data/Stages/tutorial_{stage,layout,guide,config}.csv`(기획 `tables/` 사본 · utf-8-sig) → 메뉴 `TKS/Import Tutorial (1장 학습 판 임포트)`(`Editor/TutorialImporter` · 스테이지·무장·기믹·영웅 표와 대조 · 배치 표 적 수·무장 ≠ `stages.csv` 행이면 중단 · 오류 시 자산 불변 · 스테이지 → 기믹 → 학습 판을 한 번에 = `TutorialImporter.ImportWithStages`) → `Resources/Tutorial/TutorialDb`. 1장 기믹 배치 = `tutorial_layout.csv` gimmick 행이 SOT(기획 `_stage_gimmicks_gen.py` 가 그 행을 `stage_gimmicks.csv` 로 옮김 · 1-10 만 그 도구의 배치). 코드 = `Runtime/Tutorial/`: `TutorialRules.For(stage)` → `TutorialPlan` — `BattleManager.Begin` 이 적용(고정 편성 `s_lineup` = 보유 여부와 무관 · 아군 시작 자리 · 적 = 배치 표 좌표·배율(무장 = `generals.csv`/보스·엘리트 기본 배율 × 표 배율) · 구출 대상 `Unit.Npc` = 아군 진영·조작 불가(항상 「행동 마침」)·반격 0(`Combat.CounterDamage`)·스킬 없음·승패 인원에서 제외·쓰러지면 패배 · 턴 제한 `BattleManager.TurnLimit`(연무장 `maxTurns` 와 같은 판정) · `b_no_defeat` = `Unit.MinHp`) · `TutorialDirector`(안내 `n_step` 순 진행 — 앞 단계가 닫힌 뒤 `e_trigger` 사건이 오면 띄움 · 사건은 쌓아 둠 · 턴이 지난 단계는 건너뜀 · 끌기 다음이 `unit_select` 면 「조준 안내」(유닛을 잡은 동안 그 문구) · 입력 잠금 = `SlingshotInput` 이 `BlocksInput`·`AllowPress`·`SnapAim`·`AllowShot` 질의 · 잠긴 끌기 = 목표 방향 허용 각도 안 + 최소 당김이면 목표 방향·정해진 세기로 맞춰 발사(`tutorial_config` `drag_lock_*` — 화면 아래쪽 유닛은 끝까지 당길 자리가 모자람) · 남은 턴 칩 · 안내가 가리키는 함정 보이기(1-7) · 결말 카드(첫 클리어) · 실패 카드(매번) · 편성 화면 안내 `before_battle` = 편성 화면이 열렸을 때 다음에 깰 판 기준 · 보스 판 = `BossIntro` 가 끝난 첫 아군 턴에 `boss_intro_end`) · `TutorialGuideUI`(루트 캔버스 정렬 460 → `Fx` Frame(어둡게 덮개 · 테두리 · 손가락) · `Info` Event(띠 · 카드 · 남은 턴 · 누름 막이) · 띠·카드는 대상을 덮지 않게 위·아래 자리 바꿈) · `MatchupMarks`(조준 중 적 머리 위 유리 ▲ 초록 / 불리 ▼ 붉은색 · `matchup_mark_chapter`·`_stage` 부터 모든 판). **메모리 세이브(자동 테스트 · 검증 캡처)에서는 학습 판이 꺼진다**(`TutorialRules.Mode` Auto — 1-1 을 「일반 전투 진입」으로 쓰는 기존 테스트·캡처 드라이버 보호) · 학습 판을 보려면 `TutorialRules.Mode = TutorialMode.ForceOn`. 안내는 그 판을 처음 할 때만(세이브 클리어 기록). 테스트 = `Tests/PlayMode/TutorialTests`(11 · 요청서 배치 5건 실측 포함) · 안내 화면 자체 확인 캡처 = `TutorialTests.Capture_GuideScreens`(Explicit · `test run --filter … --include-explicit` → `Logs/tutorial_capture/`). 장비 패시브(촉 진영 슬링 +30 %)로 1-2 부터 세 사람의 슬링 거리가 기본값보다 길다 — 1장 배치를 고칠 때 이 값으로 계산할 것.
전투 로직 #1080 — 알까기 충돌(보병) · 관통·아군 직전 정지(기병) · 밀며 함께 전진(창병) · 밀린 아군 공격 기회 · 궁병 제자리 사격(사거리 = 슬링샷)+접근 20 % · 궁수 근접 피해 50 %/피격 +50 % · 원화 1차·2차 반영(전장 배경 + 황건적 5 + 동탁군 4) · 테스트 22/22 - ActionResolver 전면 재작성: InfantryRoutine(접촉점 정지 · Push 접촉 방향 × collisionPushRatio · 적이면 공격+반격 뒤 밀림) · SpearRoutine(앞 유닛과 같은 속도로 함께 전진 · 접촉 간격 유지) · CavalryRoutine(벽만 막음 · StopBeforeUnclearedAllies) · ArcherRoutine(AttackRange = 슬링 · ArcherMoveAllow = 슬링 × archerRangeRatio) · PushedAllyAttack(규칙 ⑤ · ActionOutcome.Pushed/Notes) - Combat: Damage(melee) 궁병 근접 배율(근접 유닛 상대만) · FirstUnitOnPath · TouchingOpponent · FreeTravel ignore - BalanceConfig/Defaults: archerMeleeDealtRatio 0.5 · archerMeleeTakenRatio 1.5 · collisionPushRatio 1 · boardArt battlefield_01 (자산 재시드) - Board: Resources/Board/<boardArt> 원화 배경(격자·진영 띠 생략) · UnitArtImporter Board 규칙 · GameBootstrap - Resources/Units: hgj_infantry·spear·cavalry·archer·boss_zhangjiao · dz_infantry·spear·cavalry·archer (원화 세션 납품 정지 그림 · rig_frames_export static) · Resources/Board/battlefield_01.png - BattleManager Describe 「밀어냄 · 밀린 B → 적 공격」 · BattleHUD 궁병 줄 · 테스트 22종(신규·개정 7 + 원화 확인) · CLAUDE.md · README Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-11-04 06:56:02 +00:00
- 규칙 해석 변경 = `Assets/Scripts/Runtime/ActionResolver.cs`(병종 4종) · `BattleManager.cs`(턴·승패·창병 대기) · `Combat.cs`(피해 공식·경로 질의). 변경 시 `Assets/Tests/PlayMode/BattleFlowTests.cs` 에 테스트 추가 후 22종 이상 전부 통과 확인.
- 콜라이더 질의 전 `Physics2D.SyncTransforms()` · 유닛 제거는 `SetActive(false)` 후 `Destroy` · 자식 렌더러가 있는 표시물은 GameObject 통째로 끈다.
전투 로직 #1080 — 알까기 충돌(보병) · 관통·아군 직전 정지(기병) · 밀며 함께 전진(창병) · 밀린 아군 공격 기회 · 궁병 제자리 사격(사거리 = 슬링샷)+접근 20 % · 궁수 근접 피해 50 %/피격 +50 % · 원화 1차·2차 반영(전장 배경 + 황건적 5 + 동탁군 4) · 테스트 22/22 - ActionResolver 전면 재작성: InfantryRoutine(접촉점 정지 · Push 접촉 방향 × collisionPushRatio · 적이면 공격+반격 뒤 밀림) · SpearRoutine(앞 유닛과 같은 속도로 함께 전진 · 접촉 간격 유지) · CavalryRoutine(벽만 막음 · StopBeforeUnclearedAllies) · ArcherRoutine(AttackRange = 슬링 · ArcherMoveAllow = 슬링 × archerRangeRatio) · PushedAllyAttack(규칙 ⑤ · ActionOutcome.Pushed/Notes) - Combat: Damage(melee) 궁병 근접 배율(근접 유닛 상대만) · FirstUnitOnPath · TouchingOpponent · FreeTravel ignore - BalanceConfig/Defaults: archerMeleeDealtRatio 0.5 · archerMeleeTakenRatio 1.5 · collisionPushRatio 1 · boardArt battlefield_01 (자산 재시드) - Board: Resources/Board/<boardArt> 원화 배경(격자·진영 띠 생략) · UnitArtImporter Board 규칙 · GameBootstrap - Resources/Units: hgj_infantry·spear·cavalry·archer·boss_zhangjiao · dz_infantry·spear·cavalry·archer (원화 세션 납품 정지 그림 · rig_frames_export static) · Resources/Board/battlefield_01.png - BattleManager Describe 「밀어냄 · 밀린 B → 적 공격」 · BattleHUD 궁병 줄 · 테스트 22종(신규·개정 7 + 원화 확인) · CLAUDE.md · README Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-11-04 06:56:02 +00:00
- **궁병 규칙(PD 2026-11-04 · #1080)**: 사거리 = `slingMaxDistance`(얇은 원). 조준 방향 사거리 안의 적(가장자리 간격 기준) = **제자리 사격** · 사거리 밖 ~ ×(1 + `archerRangeRatio`)(붉은 도넛) 안의 적 = 들어올 만큼만(최대 `ArcherMoveAllow` = 슬링 × 비율) 다가가 사격 · 더 멀면 **목표점까지 이동만**(#1079). 반격 없음 · 목표점 명중 크리. **근접 전투**(돌진·반격·관통·견제·밀려 닿은 공격)에서 궁병은 근접 유닛 상대 주는 피해 × `archerMeleeDealtRatio`(0.5) · 받는 피해 × `archerMeleeTakenRatio`(1.5) — `Combat.Damage(…, melee)` · 원거리 사격은 패널티 없음.
- **충돌 규칙(PD 2026-11-04 · #1080)** — `ActionResolver`: 보병 = 경로 첫 유닛(아군·적군)에 부딪히면 **알까기**(등속 접근 → 부딪힌 순간 피해·반격을 즉시 교환(`ImpactExchange`) → **양쪽이 동시에 튕김**: 상대는 접촉 방향으로 남은 거리 × `collisionPushRatio` · 자신은 **들어온 방향을 접촉면(중심선)에 거울 반사한 방향**(PD 2026-11-10 「IB 와 같이 비스듬히 맞으면 거울처럼 꺾여 나가야(당구처럼)」 · `ActionResolver.BounceDir` = `Vector2.Reflect` · 정면 = 곧장 뒤로 · 장애물 튕김·연쇄도 같음 · 상대는 중심선 방향으로 밀림)으로 max(남은 거리, 슬링 최대 × `collisionSelfBounceMinRatio` 0.5) × `collisionSelfBounceRatio` 1(2026-11-10 PD 「튕기는 거리가 너무 짧다 · IB 체크」 · 전에는 남은 거리 × 0.5 → 적 바로 앞을 겨누면 남은 거리 ≈ 0 이라 튕김 0.45 · 지금 약 2.2 실측 · IB = 이동 거리가 당김과 무관한 캐릭터 고정값 + 부딪히면 남은 거리를 전부 가진 채 반사 `ActiveSkillSlingShot.ResolveCollisions`) · PD #1081) · 기병 = 유닛 무시 관통(적 피해 · 아군은 지나칠 거리가 안 나오면 **그 아군 직전 정지** `StopBeforeUnclearedAllies`) · 창병 = 첫 유닛을 **크게 밀치고 자신은 적게 밀림**(남은 거리 × `spearPushRatio` 1.5 · 반작용 = 그 × `spearRecoilRatio` 0.2 · 적이면 피해 · 아군은 밀기만 · PD #1098 · 2026-11-10) · **규칙 ⑤** = 밀린 같은 진영 유닛이 상대와 닿으면(`Combat.TouchingOpponent` · 간격 ≤ 0.12) 그 자리에서 근접 공격 1회(조작마다 · 자기 행동 소모 없음 · `ActionOutcome.Notes`). 적 AI 도 같은 코드(대칭). `UnitStats.attackRange` = 옛 창병 견제 반경(견제 제거로 미사용).
- **사거리 표시(PD 2026-11-04)**: 유닛 탭(아군·적군) → `RangeIndicator`(슬링샷 최대 거리 = 얇은 반투명 원 · 궁병 = 슬링샷 범위 ~ ×(1+비율) 채워진 붉은 도넛 · 범위 안 적이 없으면 회색).
성장 · 임무 · 출정 · 외형 · 정보 일괄 — 임무(미션) 메뉴 · 영웅 각성 · 진화(진영 비서) · 스킬 강화(영웅 조각 + 만능 조각) · 각성 칸 = 승급 장비 등급 · 장비 등급 7(불멸 red · 신화 rainbow) · 병종 장비 210 · 장별 드랍 · 영웅 Lv100 · 출정 = 로비 편성(학습 판 = 연의 전기만) · 보스 말풍선만 · 1장 레벨디자인 · 외형(코스튬) 꾸미기 레이어 · 영웅 정보(능력치 · 열전) - 임무: 일일 · 주간 · 업적 · 카운터 36 · 우편 · 로비 버튼(MissionTests) - 각성 · 진화: 표 11장 · 진화 = ★ 최대 레벨 + 진영 비서 + 골드 · 비서 교환 · 각성 굴림 · 잠금 · 칸 = 승급 장비 등급(AwakenTests) - 스킬 강화: skill_upgrade · skill_config(최고 Lv10 · 상한 = 영웅 레벨 10 단위) · 만능 조각 확인 팝업 - 장비: gear_grades · gear_kinds · gear_drop_chapters · gear_drop_stages · 승급 7단계 · 무지개 7색 순환(UiRainbow) · TKS/Import Gear(GearTests) - 출정: 학습 판 = 연의 전기 서장만(WantsTutorialPlan) · boss_intro_config talk_main · 1장 표 · 1-4 가시덤불 정정(MainStageTests · TutorialTests [Ignore]) - 외형: 부위 4(외형 = 추후) · 꾸미기 9 · 기준점 · 알파 경계 · 전투 · UI 레이어 · 미리보기 · 상세(CostumeTests) - 정보: 능력치(기본 + 성장 = 합계 · HeroRules 그대로) · 전투 능력치 7 · 성장 내역 · 내역 창 · 열전(HeroInfoTests) - 같은 작업 트리의 다른 세션 미커밋 변경(스킬 이펙트 · 전투 해석기 · 보급전 표 · 스킬 표 등)은 넣지 않음 PD 2026-11-20 「지금까지 본 PC에서 구현된 모든 성장 관련 기능을 다른 세션에서 확인할 수 있도록 푸시까지 진행해」 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-20 03:15:36 +00:00
- **임무(미션) 메뉴(PD 2026-11-20 컨펌 · 요청서 조직 레포 `공유/기획팀_산출물/삼국지슬링샷/개발요청_임무메뉴_2026-11-20.md` · 목업 `미션_img/`)** — 표 5장 = `Assets/Data/OutGame/{mission_config,mission_list,mission_point_rewards,achievements,mission_counters}.csv`(기획 `tables/` 사본) → 메뉴 `TKS/Import Missions`(`DataImporter.ImportMissions` = MissionDb 하나만 · 오류 시 불변 · 전체 임포트에도 포함) → `Resources/OutGame/MissionDb.asset`(검증 `OutGameTables.Mission.cs`: Main 포인트 합 = 상한 · 대체 임무 = 같은 칸 Fallback · State 카운터 = `MissionRules.StateKeys` 만). 규칙 = `OutGame/Mission/MissionRules`(세이브 `SaveData.mission` · 기기 우편 `SaveData.mail` · 기간 = 기기 현지 시각 + `daily_reset`(cfg:common.daily_reset_hour) · `weekly_reset` 요일;시 · 초기화 = 지난 하루를 먼저 닫음(자동 더함 → 상한이면 daily_full → 닿은 구간 = 우편) · 칸 = 초기화 순간 잠김 판정(대체 임무) · 업적 = 받은 단계 수 · 연쇄 · 반복 단계). 카운터 = `MissionRules.Count`(세션 `CountMission` · 전투 이벤트 `OutGameRoot.OnBattleEvent` → `CountEvent`(s_key 또는 s_code_now 가 같은 것 · 보물 누적은 `BattleEvents.Keys` 만) · 전투 끝 `OutGameRoot.OnPhase` → `BattleEnd`(출정 승리 · 연무장 종류별 · 처치 = 쓰러진 적(구출 대상 · 연병장 허수아비 · 연습 판 제외)) · 치명타 `Combat.DamageCore` · 연쇄 `BattleManager` · 골드/보옥 사용 = `Commit` 차이 · 화면 성공 뒤 1줄(성장 · 수확 · 등용 · 상자 · 보물 강화 · 소탕 · 군량)). 화면 = `MissionScreen`(탭 3 · 포인트 판 · 줄 · 팝업 · 시계 칩 = 자기 Event 캔버스) · `MailBox`(기기 우편함 · 서버 모드 = 기존 `Net/MailPanel`) · 로비 「임무」 = unlock_stage 클리어 뒤 · **기기 세이브 모드만**(서버 임무 API 없음) · 빨간 점 = 세 탭 합. 글자 = `Resources/UI/Mission/mission_text.csv`(UiText) · 아이콘·색·바로가기 = `mission_screen.csv`. 테스트 = `Tests/PlayMode/MissionTests`(8 + 캡처 `Capture_MissionScreens` Explicit → `Logs/mission_capture/` 7장 = 목업 이름과 같음).
- **장비 등급 7 · 병종 장비 · 장별 드랍(PD 2026-11-20 구현 지시 · 요청서 조직 레포 `공유/기획팀_산출물/삼국지슬링샷/개발요청_장비등급드랍_2026-11-20.md`)** — 표 = `Assets/Data/OutGame/{gear_grades,gear_kinds,gear_drop_chapters,gear_drop_stages,gear_items,hero_gear,promotion,awaken_slots}.csv`(기획 `tables/_gear_class_gen.py` 생성분 포함) → 메뉴 `TKS/Import Gear`(`DataImporter.ImportGear` = 전체 해석·검증 뒤 GearDb · HeroDb · PromotionTable · AwakenDb 넷만 씀) · 검증 `OutGameTables.Gear.cs`. 장비 = 병종 5 × 부위 6 × 등급 7(일반 white ~ 전설 orange · 불멸 red · 신화 rainbow) = 210 · 등급 순서 · 이름 · 색 = `GearDb.grades`(`UiKit.GearGradeKo` · 승급 배지 글자는 `UiKit.GradeKo` = 녹 … 금 · 적 · 채) · 아이콘 = `gear_items.icon` · 신화 무지개 = s_color 7색 → `UiRainbow`(`UiKit.GradeTint` · 승급 배지 · 장비 칸). 승급 7단계 = 장비 등급 n 의 6칸 · 각성 칸 5 · 6 = 불멸 · 신화. 스테이지 드랍 = `EconomyRules.RollGear`(등급 = gear_drop_chapters 가중치 · f_focus_pct % = 그 스테이지 지정 장비 · 나머지 = 그 등급 30종 균등 · stage_rewards.gear_grade_max 는 투기장만 씀) · 스테이지 정보 창 = 지정 장비 「확률↑」 줄. 옛 장비 id = `HeroRules.Sanitize` 가 정리. 테스트 = `Tests/PlayMode/GearTests`(6 + 캡처 `Capture_GearScreens` Explicit → `Logs/gear_capture/` 5장).
- **영웅 각성 · 진화 · 스킬 강화(PD 2026-11-20 구현 지시 · 요청서 조직 레포 `공유/기획팀_산출물/삼국지슬링샷/개발요청_각성진화_2026-11-20.md` §0~§5 · 목업 `각성진화_img/` 9장)** — 표 11장 = `Assets/Data/OutGame/{evolve_stars,awaken_config,awaken_cost,awaken_grades,awaken_stats,awaken_slots,evolve_config,evolve_items,goods_awaken_evolve,skill_upgrade,skill_config}.csv` + `hero_levels.csv`(Lv100) → 메뉴 `TKS/Import Awaken · Evolve`(`DataImporter.ImportAwaken` = 전체 해석·검증 뒤 EvolveTable · AwakenDb · LevelTable 셋만 씀) · **진화 표 SOT = `evolve_stars.csv`(옛 `evolve.csv` 는 더 읽지 않음 · EvolveTable 행 = n_star_to 상태 + 재료 · 최대 레벨)** · 검증 `OutGameTables.Awaken.cs`(설정 값은 코드가 아는 값만 통과 = `CfgIs`). 규칙 = `OutGame/Awaken/AwakenRules`(진화 = ★ 최대 레벨 도달 + 영웅 진영 비서 × n + 골드 → ★+1 · 각성 칸과 무관 · 레벨 상한 = min(★ 최대 레벨, 챕터 상한) = `HeroLevelCap` · `HeroRules.CanLevelUp` 이 ★ 상한에서 멈춤 / **각성 칸 = 승급 장비 등급(awaken_slots · 저장 없이 `FilledGearOrder` 로 계산 · 승급해도 유지 · 6칸째 장착 = `OutGameSession.Equip` 이 새 칸 무료 1회 + `LastSlotOpen` → 「각성 칸 열림」 창 · 넘는 저장 줄 = `Shown` 밖 보관)** / 각성 = 보이는 줄 가운데 잠그지 않은 줄 다시 굴림(등급 → 능력치(겹침 제외) → 값) · 잠금 상한 = 열린 칸 − n · 비용 = 잠금 수 · warn_grade 이상 경고 / 비서 교환 = 같은 진영 보유 영웅 조각(남는 몫 = 보유 − 스킬 강화에 남은 조각 · 많은 순 · 미보유 영웅 조각은 안 씀) 또는 등용 포인트(명장 등용 1회 = recruit_point) · 비서별 주간 한도 = `MissionRules.WeekStartFor(shop_reset)`). **스킬 강화 = `Runtime/Skills/SkillRules`(비용 = skill_upgrade n_shard 그 영웅 조각 → 모자란 몫만 만능 조각 · `SkillUp(id, i, allowUniv)` · 만능이 필요하면 `NeedUniv` → 확인 팝업 · 최고 = skill_config max_lv_* · 상한 = 영웅 레벨이 닿은 n_need_hero_lv + ★ active_lv · 전투 배율 최고 = `SkillCatalog` 이 skill_config 로 덮음 · skill_levels(스킬서 + 골드)는 안 씀)**. 세이브 = `HeroState.awaken` · `inv.goods`(s_key → 수) · `tomeShop`. 능력치 반영 = 공·체·방 % → `HeroRules.Compute` 곱셈 1항(전투력 포함) · 나머지 7종 → `LineupEntry.extraEffects` → `Unit.ExtraEffects` → `SkillMods.Get`(단위 변환 = `AwakenRules.Effects` · 「받는 ~ 피해 감소」 = 음수 · 반영법을 모르는 능력치 = 임포트 오류 `AwakenRules.Known`). 창 = `AwakenWindows`(각성 · 확률 · 경고 · 진화 · 진화 완료 · 비서 교환 · 각성 칸 열림 · 스킬 강화 · 만능 조각 확인 · 고른 영웅 카드 ◀ ▶ = `HeroDetailScreen.StepHero`) · 영웅 정보 메뉴 진화 · 각성 버튼 · 스킬 줄 「강화」가 연다 · 글자 = `Resources/UI/Awaken/awaken_text.csv` · 아이콘·색 = `awaken_screen.csv`. 서버 모드 진화 · 스킬 강화는 기존 서버 API(옛 조각 · 스킬서 규칙)로 가므로 서버 쪽 변경 필요(열린 항목). 테스트 = `Tests/PlayMode/AwakenTests`(7 + 캡처 `Capture_AwakenScreens` Explicit → `Logs/awaken_capture/` 9장) · `OutGameTests.Evolve_TomesToNextStar`.
- 보고는 실측·추정·미확인을 분리한다(C23 · C5). 커밋은 의도 변경 파일만.
## UI 캔버스·아틀라스 구조 (PD 2026-11-10 「리소스·정보가 얼마나 자주 바뀌는지에 따라 캔버스를 나누어 최적화 · 드로우콜 최소화 구조 필수」)
UI 를 새로 만들거나 고칠 때 **반드시** 이 구조를 따른다(어기면 `Tests/PlayMode/UILayerTests` 가 실패). 조직 전체 표준 = 조직 레포 프로젝트 규칙 **P41**(`.claude/skills/너드나비스-코어룰/rules/P41.md` · 2026-11-10) — 이 절은 그 표준의 이 프로젝트 구현 SOT 이자 다른 프로젝트의 참조 구현이다.
- **갱신 등급 3단**(`Runtime/UI/UiLayer.cs` `UiRate`): **Static** = 화면을 열 때만(바탕 · 틀 · 고정 글자) · **Event** = 조작·게임 사건 때(값 · 선택 · 턴 · 팝업) · **Frame** = 매 프레임(호흡 · 튀김 · 스크롤 내용 · 끌기 · 미니맵 · 커서). 등급이 다른 것은 같은 캔버스에 두지 않는다 — 캔버스는 자식 하나만 바뀌어도 그 캔버스 전체를 다시 묶는다.
- **만드는 법**: 루트 = `UiLayer.Root(go, cam, order, plane, reference, rate)` · 기존 오브젝트를 층으로 = `UiLayer.Nest(go, rate, raycast)` · 빈 층 = `UiLayer.Group(name, parent, rate)` · 매 프레임 요소 = `UiLayer.Isolate(go)`(`UiPulse`·`UiPop` 은 스스로 호출 · 바로 위 부모가 Frame 층이면 그 층에 합침). 중첩 캔버스는 **overrideSorting 끔**(그리는 순서 · `RectMask2D`/`Mask` 자르기 유지) · **누르는 그래픽이 있는 층에만 GraphicRaycaster**(중첩 캔버스의 그래픽은 부모 캔버스 레이캐스터가 못 봄 → 누름 층은 `raycast: true`).
- **현재 배치**: 아웃게임 루트(Static · 바탕 + 하단 탭) → 화면마다 중첩(Event) → `UiKit.ScrollGrid` 내용(Frame · 자동) · 위 덮개 루트 → 재화 바 · 팝업(`ModalCustom`) · 토스트 · 뽑기 결과 · 편성 끌기 유령 각각 중첩 · 전투 결과 루트(Event · 별 줄 = Frame) · 전투 HUD 루트 = 정적 판(칩 바탕 · 유닛 판 바탕 · 미니맵 틀) → `Info`(글자·값·스킬 버튼 · Event) → `Minimap/MinimapLive`(시야·점 · Frame) · `SkillGlow`(Frame) → `Result`(Event) · 월드맵 루트(Static · 띠·넘김·본영) → `Content`(맵·노드 · 스크롤 · Frame) → `cursor`(Frame) · `Popup`(Event).
- **매 프레임 호출되는 갱신 코드**는 값이 같으면 쓰지 않는다(`sizeDelta`·`anchoredPosition`·`CanvasGroup.alpha/interactable` 비교 후 대입 · `Text.text`·`Graphic.color` 는 Unity 가 이미 비교).
- **아틀라스**: 구성 SOT = `Assets/Data/UI/ui_atlas.csv`(theme 줄 = UI 테마가 쓰는 스프라이트를 경로 match 로 · folder 줄 = 폴더 통째 · `single_area` 보다 큰 그림 = 묶지 않음) → `Editor/UIAtlasBuilder` → `Assets/UI/Atlases/*.spriteatlasv2`(UI_Common 4096×2048 · UI_Content 2048×2048 · WorldMap_UI 1024×1024 · 각 1장). **UI 테마 임포트가 끝날 때마다 자동 갱신**(새 납품 스프라이트 = 코드·표 변경 없이 묶임) · 수동 = 메뉴 `TKS/Build UI Atlases (UI 아틀라스 갱신)`. 패커 = Sprite Atlas V2(에디터 Play 에서도 묶임 · `EditorSettings` m_SpritePackerMode 5). 사각 묶음(Tight 끔 · 회전 끔 — 9-slice·Filled 보존). **스프라이트를 잘라 새로 만드는 코드는 `sprite.packed ? sprite.textureRect : sprite.rect`**(`UISkin.WorldSprite` 참고 · `rect` 는 원본 기준).
- **검증**: `-executeMethod TKS.EditorTools.DataImporter.CaptureUI` 캡처 로그에 화면마다 `layers <화면> batches=… canvases=루트+중첩 … frameRebuildGraphics=…` 줄 + `ui_layers.csv`(캔버스별 그래픽 수 · 등급 · 레이캐스터 · 매 프레임 요소 여부 · `Runtime/UI/UiLayerProbe`). 2026-11-10 개선 전→후(13화면 · 1080×1920) = 배치 합계 1124 → 439 · 평상시 매 프레임 재구성 그래픽(전투 HUD 49 → 10 · 월드맵 241 → 1 · 보물 상자 115 → 2 · 전투 결과 115 → 14).
- **남은 드로우콜 원인**(2026-11-10 실측): 영웅 목록(72)·편성(120) = 유닛 초상(유닛 아트 프레임 797×826 · 유닛마다 다른 텍스처라 카드마다 끊김) — 목록용 축소 초상 아틀라스 = **모든 영웅 리소스 제작이 끝난 뒤 진행**(PD 2026-11-10 결정 · 그 전에는 만들지 않는다).
- 같은 PC 의 다른 세션도 `E:\Nerdnavis\_tks_verify` 를 캡처에 쓴다 → 사본은 세션마다 따로(예 `Tools/mirror_verify.py <본체> E:/Nerdnavis/_tks_verify_ui`) · 남이 돌리는 사본에 미러하지 않는다(실행 중 코드가 바뀜).
스킬 이펙트 작업 준비 — 스킬 테스트 씬 · WL 이펙트 이식 · 이펙트 표 · 보병·창·기병 슬링샷 공격 = WL 창 돌진 이펙트 시험(PD 2026-11-09) PD 「WL 프로젝트에서 스킬을 구현하던 방식과 동일하게 유닛 별 스킬 구현」 · 「테스트 목적: 보병, 창, 기병을 슬링샷으로 공격할 때 WL 창 돌진 공격 이펙트」 - 스킬 테스트 씬 Assets/Scenes/SkillTest.unity(SkillTestBootstrap · 메뉴 TKS/Skill Test/Build Scene): 영웅 목록 선택(heroes.csv 56) · 더미(죽지 않음 · 행동 토글 · 배치 표 Resources/Skills/skill_test.csv) · 슬링샷 · 액티브 버튼 · 쿨 무시 · 영웅 무적 · 이펙트 보기(에디터 · Assets/VFX 검색 → 영웅에 띄움) - 이펙트 표 Resources/Skills/skill_vfx.csv → Runtime/Skills/SkillVfx(키 = 스킬 id 또는 basic_<병종> · cast/travel/hit · f_every 반복 · 사본 Resources/Fx/TKS_Fx_*) · 훅 = SkillSystem Announce/BeginAction/EndAction/Hit/Instant - WL 이펙트 이식 Assets/VFX(약 640 MB · 빌트인 호환분만 · GUID 유지 · 도구 Tools/wl_vfx_import.py) · URP 셰이더 빌트인 이식 4종 Assets/VFX/_BuiltinPorts · com.unity.shadergraph 17.3.0 · 카메라 깊이 텍스처 켬(셰이더 그래프 소프트 파티클) - 시험: basic_infantry/spear/cavalry travel = TKS_Fx_SpearRush · SpearRushWrap · SpearRushDust(WL WLStaffEarth rushFx 1~3 값 환산) — 표 9행 삭제 = 원래대로 - 테스트 118/118 · console error 0 · 이 PC 첫 임포트 자동 재직렬화(png·tga .meta · UITheme · ProjectSettings · InputManager)는 제외 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 14:12:52 +00:00
## 스킬 이펙트 작업 (2026-11-09 PD 「WL 에서 스킬을 구현하던 방식과 동일하게 유닛별 스킬 구현」 · 이 PC = 연출 담당)
스킬 이펙트 1차 + IB(쿠로네코) 연출 시험 — 돌진·조준 UI·타격감 (PD 2026-11-10) - 기본 공격(돌진) = IB 이펙트 그대로 시험: 앞 빛 물결 · 속도 꼬리(진영색 4색 · 멈춘 자리에서 0.12초 흐려짐) · WL 흙먼지 · 기준점 dash(아래로 갈수록 발 쪽) · 히트 이펙트 제거(PD 지정 대기) - 슬링샷 방향 결정 UI = IB GameTouchArrow 이식(IbAimArrow · IB 유닛 반지름 0.496 기준 비율) + 진행 중 캐릭터 연출(IbUnitMarks: 발밑 원 · 몸 빛 · 조준 중 속성 방울) · 값 표 Resources/Skills/ib_ui.csv - 기병: 복귀 영역(채운 원 · PreviewCavalryReturn) · 복귀 때 돌아서기(UnitView.TurnAround) - 타격감: HitFeel + CameraController.Shake · 표 hit_feel.csv(IB 흔들림 값은 디컴파일에 없어 추정값) - 액티브 스킬 1차 연출(Fable 제안 56 스킬 · 사본 Resources/Fx/TKS_Fx_Sk_*) · SkillVfx 확장(s_camp · f_fwd · f_drift · f_fade · s_over · b_flat · 트레일 페이드) · 셀화 셰이더 포트 - 2D 돌진 시험본(Dash2D · Aura2D test_aura) · 이전 시험 행은 skill_vfx.csv 에 # 주석 - 여포 크기: dz_boss_lvbu 몸 높이 819 → 718(깃털 제외 · 말 탄 유닛 머리 끝 상한 때문에 작아졌음) - 원본 = Assets/VFX/IB(쿠로네코 · GUID 유지 · Tools/wl_vfx_import.py --skip-scripts) · 사본 도구 Tools/make_ib_fx_copies.cs · make_ib_camp_textures.py · build_dash2d.cs - 테스트 PlayMode 118/118 통과 · 자동 재직렬화(png meta · UITheme · ProjectSettings) 제외 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 04:19:44 +00:00
- **작업 착수 규칙(PD 2026-11-10)**: 지시가 오면 첫 명령 = `unity command --project-path . editor.playmode stop`(씬이 열려 있든 Play 중이든 끄고 바로 착수 · 기다리지 않음) · 지시를 받은 작업은 끝까지 진행(멋대로 멈추지 않음 · 도구 호출이 끊기면 다시 걸어 이어 감).
- **확인 규칙 = 수정한 부분만(PD 2026-11-10 「수정 지시마다 수정한 부분 외 모든 부분을 다 테스트하는 것 같다 → 수정한 부분만」)**: Play 캡처는 그 지시로 바뀐 이펙트·유닛·상황만(예: 「기병 복귀 재생」 = 기병 1기 돌격·복귀만 · 다른 진영·방향·이펙트 재확인 금지) · 자동 테스트는 전투 규칙 코드(ActionResolver · Combat · BattleManager 판정 · SkillSystem 효과)를 바꿨을 때만 그 관련 테스트 클래스만(`test run --filter`) · 표(csv) · 이펙트 사본 · 셰이더 · 테스트 씬 UI 만 바꾼 지시는 자동 테스트 없음 · 전체 테스트(118)는 PD 가 커밋을 지시할 때 1회.
- **스킬 테스트 씬** = `Assets/Scenes/SkillTest.unity`(메뉴 `TKS/Skill Test/Build Scene` 로 다시 만듦 · 씬 = `SkillTestBootstrap` 하나) — 전투 코드 그대로 + 월드맵·아웃게임·세이브 없음 · 왼쪽 위 「유닛 선택」(heroes.csv 영웅 56 · 진영별) · 「이펙트 보기」(에디터 전용 · `Assets/VFX` 프리팹 검색 → 고른 영웅 몸에 띄움 · 크기 ×0.25~4 · 기울기 0/−45/−90 · 방향 · 경로 복사) · 왼쪽 아래 「다시 배치」(표 다시 읽기 + 처음 자리) · 쿨 무시 · 더미 행동 · 영웅 무적. 더미 = 죽지 않음(`Unit.Invincible` · 아군 턴마다 체력 회복) · 배치 표 `Resources/Skills/skill_test.csv`(hero 행 n_slot + 상대 좌표) · 더미 행동 끔 = `BattleManager.EnemyHold` · **2026-11-10 PD 추가**: 적 더미 = 표 `skill_test.csv` 적 줄 위에서부터 적 1·2·3 · 왼쪽 아래 넷째 줄 「적 N」(1→2→3 · 앞 N 줄만) · 「1 보병」 「2 창병」 「3 기병」(그 칸 병종 순환 · 표 e_type = 기본 · PlayerPrefs) · 정보판 = 영웅 + 액티브·패시브(이름 · 한자 · 발동 · 쿨 · 설명 · 효과 키와 p 값 · 높이 자동) · **연출 완료 체크**(영웅 목록 줄 오른쪽 「○ 완료」 · 정보판 오른쪽 위 버튼) → 표 `Assets/Data/SkillTest/skill_vfx_done.csv`(git 공유 · 에디터에서 씀) · 완료 영웅 = 목록 맨 아래 「연출 완료」 머리글 밑 · **연출 개선 요청 = 목록 첫 번째(미완료) 영웅부터 순서대로**(PD 2026-11-10). 패널 위 누름은 슬링샷이 무시(`SlingshotInput.BlockPress`).
스킬 이펙트 1차 + IB(쿠로네코) 연출 시험 — 돌진·조준 UI·타격감 (PD 2026-11-10) - 기본 공격(돌진) = IB 이펙트 그대로 시험: 앞 빛 물결 · 속도 꼬리(진영색 4색 · 멈춘 자리에서 0.12초 흐려짐) · WL 흙먼지 · 기준점 dash(아래로 갈수록 발 쪽) · 히트 이펙트 제거(PD 지정 대기) - 슬링샷 방향 결정 UI = IB GameTouchArrow 이식(IbAimArrow · IB 유닛 반지름 0.496 기준 비율) + 진행 중 캐릭터 연출(IbUnitMarks: 발밑 원 · 몸 빛 · 조준 중 속성 방울) · 값 표 Resources/Skills/ib_ui.csv - 기병: 복귀 영역(채운 원 · PreviewCavalryReturn) · 복귀 때 돌아서기(UnitView.TurnAround) - 타격감: HitFeel + CameraController.Shake · 표 hit_feel.csv(IB 흔들림 값은 디컴파일에 없어 추정값) - 액티브 스킬 1차 연출(Fable 제안 56 스킬 · 사본 Resources/Fx/TKS_Fx_Sk_*) · SkillVfx 확장(s_camp · f_fwd · f_drift · f_fade · s_over · b_flat · 트레일 페이드) · 셀화 셰이더 포트 - 2D 돌진 시험본(Dash2D · Aura2D test_aura) · 이전 시험 행은 skill_vfx.csv 에 # 주석 - 여포 크기: dz_boss_lvbu 몸 높이 819 → 718(깃털 제외 · 말 탄 유닛 머리 끝 상한 때문에 작아졌음) - 원본 = Assets/VFX/IB(쿠로네코 · GUID 유지 · Tools/wl_vfx_import.py --skip-scripts) · 사본 도구 Tools/make_ib_fx_copies.cs · make_ib_camp_textures.py · build_dash2d.cs - 테스트 PlayMode 118/118 통과 · 자동 재직렬화(png meta · UITheme · ProjectSettings) 제외 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 04:19:44 +00:00
- **이펙트 값 = 표 `Assets/Resources/Skills/skill_vfx.csv`**(머리 주석이 칸 설명) → `Runtime/Skills/SkillVfx`(전투마다 다시 읽음). 키 = 스킬 id(액티브) 또는 `basic_<병종>`(일반 슬링샷 공격 · 이동만인 추가 이동 제외) · 이벤트 = cast(발동) · travel(슬링샷 돌진 동안 · `f_every` 반복) · hit(그 행동의 피해 순간 · 대상마다 1번). 훅 = `SkillSystem.Announce`(cast) · `BeginAction`/`EndAction`(travel) · `Hit`(hit) · 즉시형 `Instant`. 크기 `f_scale` = 유닛 키 대비(WL 배율 ÷ 1.8 ≈ 같은 비율) · 입자 크기 모드는 띄울 때 전부 Hierarchy · 정렬 = 12 + n_order · 가상 실행(Sim) 중 없음. **돌진(travel) 규칙 = WL `WLStaffEarth.Rush` 와 같게**(2026-11-09 PD 「돌진하는 동안 이펙트가 정상적으로 안 보임」 수정): `b_sustain` 1 = 시간당 방출 층을 반복으로(한 번 띄워 돌진 내내 유지 · 다시 띄우면 0.1~0.2 s 만에 끊김) · `b_clear` 1 = 행동 끝에 남은 입자까지 지움(WL ClearEnd) · `b_face` = 이펙트를 옆모습으로 화면에 눕혀 진행 방향으로 돌림(`SkillVfx.FxRotation` · 3D 세계 그대로 놓으면 위쪽 돌진 때 판 모양 섬광이 옆면만 보임) + `f_tilt` = 진행 축 기준 카메라 쪽 기울기(−35 기본 · −90 = 위에서 본 모습) · 이 게임 돌진은 약 0.3~0.4 s(WL 0.95 s)라 배속은 그 길이에 맞춘다. **2026-11-10 추가**: `s_skill` 은 `;` 로 여러 키 · `s_camp` = 진영(heroes.csv faction shu·wei·wu·other · `Unit.Camp` = 출전 영웅만 · 진영 없는 적 병사 = other) · `f_fwd` = 진행 방향 앞(+)·뒤(−) 위치 · `f_drift` = 입자 자체 이동 배율(스스로 날아가는 데모용 돌진 이펙트를 유닛에 붙일 때 0.1) · 회전 = **프리팹 원본 루트 회전을 살리고 그 진행 축만 화면 방향에 맞춤**(`FxRotation(tilt, face, r0)` — MasterStylizedFX 투사체·Dash 는 루트에 (0, 90, 270) 같은 회전이 있어 덮어쓰면 판이 옆으로 서서 가늘게만 보임) · `n_order` −14 = 유닛 바로 아래(캐릭터가 이펙트 안에 보임 · 바닥 −20~−16 · 사거리 원 −10 · 유닛 0) · 팩 데모용 자리표시(`Character` 큐브)는 사본에서 끈다. 현재 시험(PD 2026-11-10 스크린샷) = 보병·창·기병 돌진: 위 `TKS_Fx_EnergyProjectile`(파랑) · 촉 `GreenProjectile` · 오 `FireProjectile`(주황) · 군 `PurpleProjectile` + 뒤쪽 대쉬 느낌 `TKS_Fx_<Blue|Green|Red|Purple>Dash`(f_fwd −0.6). **URP HDR 근사**: MasterStylizedFX 이식 셰이더는 `_BuiltinPorts/TKS_HdrApprox.cginc` 로 1 넘는 밝기를 흰빛으로(빌트인 · 감마 · 블룸 없음이라 그대로면 평평한 단색 띠).
- **돌진 이펙트 재생 구간 · 소멸(PD 2026-11-10)**: travel 이펙트는 「슬링샷 직진 구간」 동안만 — 보병·창병 = 접촉 순간, 기병 = 관통 끝에 `SkillSystem.DashEnd` 로 멈추고 `f_fade` 초 동안 그 자리에서 흐려져 사라짐(`SkillVfxFade` · 입자 색 알파를 직접 낮춰 수명 무한 층도 사라짐) · 기병 복귀 · 위진소요 추가 관통 = `DashBegin` 으로 그 방향에 다시 재생 → 도착 후 같은 소멸(훅 = `ActionResolver` 의 `DashEnd/DashBegin` 5곳). 튕김 · 밀기 · 반작용 = 반응이라 이펙트 없음.
- **이중 레이어(PD 2026-11-10 「돌진 이펙트 앞부분(머리)은 캐릭터보다 상단 · 레이어 이중 · 돌진 방향만 실드 형태로 일부를 가림」)**: 표 `s_over` = 유닛 위(정렬 12)에 그릴 자식 층 이름(`;` 여러 개) · 나머지 층은 `n_order` 그대로 — 진영 혜성 = `BG;Head (1)`(머리 셸) 위 · 꼬리 −2 · 뒤쪽 Dash −3 · 머리 중심 = 몸 앞 0.6 키(0.2 키 = 상반신을 다 덮음 · 실측).
- **IB(쿠로네코) 이펙트 시험(현재 기본 공격 · PD 2026-11-10 「내가 원한 비주얼은 이런게 아니야(이노센트베인 영상) → 우선 IB 이펙트를 그대로 써서 확인 · 나중에 구조에 맞게 새로 그림(화풍 통일)」)**: IB 슬링샷 발사 `UnitVisualEffectControl.ShowBoosterFX()` 와 같은 구성 — `ef_booster`(앞 빛 물결 2장 + 가시 · 0.2초 반복 맥동 · 유닛 위 · 이동 끝에 바로 지움 = IB Breaking 때 Kill) · `ef_speed_tail`(꼬리 0.6초 + 화살표 입자 · 유닛 아래 · 끝나면 꼬리가 줄며 사라짐 — `SkillVfx.Stop` 이 트레일 길이만큼 기다림) · `ef_booster_dust`(출발 먼지 1번) · 타격 `ef_normal_hit`. 원본 = `Assets/VFX/IB/`(쿠로네코 `E:\NerdNavis\Kuroneko\KuronekoClient` 에서 `Tools/wl_vfx_import.py copy … --wl <쿠로네코> --dest Assets/VFX/IB --skip-scripts` · GUID 유지 · 무수정) · 사본 = `Resources/Fx/TKS_Fx_IB_*`(`Tools/make_ib_fx_copies.cs` — IB 전용 스크립트 부품 제거 · 정렬 레이어 Default · 방향 있는 것은 감싸는 루트 + 안쪽 Z −90°(IB 정면 +Y → 이 게임 +X) · 소리 이벤트 받는 곳 `IbFxAnimEvents`(아무것도 안 함 · 없으면 재생마다 콘솔 오류)). 셰이더 = `Fingar/Additive`(더하기 섞기 · 빌트인 그대로). 2D 돌진 3차 행은 표에 `#` 주석(되돌리기). **진영색(PD 「진영 색을 입히고」)** = `TKS_Fx_IB_Booster_<진영>`(스프라이트 색의 색상만 진영색 · 채도·밝기 유지) · `TKS_Fx_IB_SpeedTail_<진영>`(꼬리 그림 `Assets/VFX/IB/_TKS/Tail_Basic02_<진영>.png` = `Tools/make_ib_camp_textures.py` · 재질 같은 폴더 · 화살표 입자 색) — 둘 다 `make_ib_fx_copies.cs` 가 `Tools/dash2d_camps.csv` 로 만듦 · 원색 사본 `TKS_Fx_IB_Booster` · `SpeedTail` 은 비교용으로 남음(표에서 안 씀). **사라지는 시점(PD 「멈춘 이후 뒤늦게 이펙트가 사라짐 · 위치 안 맞음」)** = 속도 꼬리 `f_fade` 0.12 — 멈춘 자리에서 꼬리째 흐려짐(`SkillVfxFade` 가 트레일 색 그러데이션 불투명도도 낮춤 · 전에는 0.6초 꼬리 머리가 기병 돌격 끝자리에 남아 복귀 중에도 보였음). **타격** = 현재 없음(PD 2026-11-10 「적이 피격되었을 때 히트 이펙트는 제거 · 어떤 히트 이펙트를 쓸지 알려줄게」 · IB NormalHit · BounceHit 행은 표에 `#` 주석). **기준점 `e_anchor` = dash**(빛 물결 · 꼬리 · PD 「복귀할 때 이펙트가 캐릭터보다 위쪽에 생겨 안 보임 → 유닛 바닥에」) = 위·옆으로 갈 때 몸 가운데 · 아래로 갈수록 발 쪽(곧장 아래 = 발). **흙먼지** = WL 창 돌진 흙먼지 `TKS_Fx_SpearRushDust`(0.15초마다 발밑 · PD 「복귀할 때 흙먼지가 너무 세서 뭉개짐 → WL 흙먼지로」 · IB 출발 먼지 행은 `#` 주석).
- **방향 결정 UI = IB 이식(PD 2026-11-10 「IB 와 같이 슬링샷 조작 시 방향 결정 UI 등을 그대로 이식」)**: `TKS.IbAimArrow`(IB `GameTouchArrow` 동작 · 프리팹 `Resources/Fx/TKS_Fx_IB_GameArrow` = 원본 `Assets/VFX/IB/AssetResources/Game/GameArrow` 사본) — 누르면 유닛 둘레 고리 + 퍼지는 고리 3개(3초 · 1초 간격) · 당기면 하늘색 화살표가 쏠 방향으로 돌고 당긴 세기만큼 길어짐(0.5~1.5 · 최소 당김 → 슬링샷 최대 거리) · 화살 끝이 전장 밖이면 안으로 · 놓으면 숨김. 전에 쓰던 조준선 · 당김선은 끔(`SlingshotInput.ShowPreview` · IbAimArrow 가 없을 때만 예전 선). 목표 고리 · 강조 · 궁병 화살 경로선 · 기믹 예상 궤적은 그대로. 화살표 색 = IB 공격 종류 3(하늘색) 하나. **2026-11-16 부터 화살표 길이 = 이동할 거리 / 최대 거리(= 게이지) · 「당기면」 설명은 아래 게이지 조작 줄이 대신한다.**
- **조작 = 게이지 조작(PD 2026-11-16 · FGT 「당겼다 놓기 · 반대로 가는 화살표가 어렵다」 → 뒤로 당기기 폐기)**: 아군 유닛을 누른 채 **유닛 밖으로(반지름 × `aimStartRadiusRatio` 1.2) 끌면** 끄는 쪽으로 화살표가 뜨고(**끈 거리는 방향만** 정함 · 유닛 → 손가락) **그때부터** 게이지가 차오른다(순환형 = 가득 차면 0 부터 다시). 손가락을 유닛 원 안으로 되돌리면 화살표·게이지가 사라지고 놓아도 발사 없음 = 스킬 사용 가능 · 다시 끌면 게이지는 0 부터(PD 2026-11-16 5차 · `SlingshotInput.AimActive` — 켜는 거리와 끄는 거리가 달라 경계에서 깜빡이지 않음). 놓으면 그 방향으로 **최대 거리 × 놓는 순간의 게이지**(최소 `minDragDistance`)만큼 이동·공격 · 끌지 않거나 손가락을 유닛 위로 되돌려 놓으면 발사 없음. 수치 = `BalanceConfig.unitStats[].gaugeCycleSec`(한 번 차는 시간 · 보병 1 · 기병 0.8 · 궁병 0.5 · 창병 1 · 책사(= PD 표현 「승병」) 0.6) · `aimGaugeCritFrom` 0.9(이 값 이상에서 놓은 행동 = 그 유닛이 주는 공격 **반드시 치명타** · `Unit.GaugeCrit` 을 `BattleManager.PlayerActionRoutine` 이 행동 동안만 켬 → `Combat.DamageCore` · 책사 광역은 크리 없음 규칙 그대로). 스킬 효과 키 2종 = `gauge_pingpong`(왕복형 · 가득 차면 내려옴) · `gauge_time_pct`(한 번 차는 시간 +비율 · 개발 메뉴·성급 연결용 · 그 연결은 미구현 · 표에서 쓰려면 기획 생성기 KEY_DOC 에도 추가) → 질의 `SkillMods.GaugeCycle` · `GaugePingPong`. 코드 = `SlingshotInput`(`GaugeAt` · `AimPoint` · `OnHold` · `RefreshGauge` 게이지 막대 = 유닛 오른쪽 세로 막대(아래 → 위로 참 · 위쪽 끝 구간 강조 · PD 2026-11-16 2차 「체력 바와 겹쳐 보이지 않게」) · 크기·색·자리 = `ib_ui.csv gauge_*`) · `IbAimArrow.Aim(u, 방향, 세기 0~1)` · 화살표 = `arrow_scale` 0.8 배 · `order_arrow` −6(유닛 0 아래 층 · PD 2026-11-16 2차) · **꼬리 끝 = 유닛 가운데**(그림 `skill-arrow_b_filled` 피벗이 y 0.3 이라 꼬리 30 % 가 유닛 뒤로 뻗던 것 → `Aim` 이 그림 아래 끝만큼 앞으로 옮김) · 길이 `arrow_s_min` = `arrow_s_max` = 0.5(고정 · 유닛 가운데에서 약 2.1 · 방향만 보이면 됨 · PD 2026-11-16 3차 → 4차 「움직임이 부자연스럽다」로 게이지 연동 길이 변화 제거 · 두 값을 다르게 두면 다시 게이지를 따라 변함) · 가로 `arrow_width` 1.3(길이와 따로 · 4차 「좌우가 넓어지면」). 학습 판 = 손가락 안내가 목표 쪽으로 끔(`TutorialDirector.DrawDrag`) · `drag_lock_min_pull` 0(잠금 끌기 = 방향만 맞으면 게이지와 상관없이 정해진 세기로 발사) · `finger_pull_ratio` 0.5. 테스트 = `BattleFlowTests.AimGauge_CycleDistanceAndGuaranteedCrit`. 실제 손 조작 확인은 PD 플레이(레거시 Input 이라 자동 테스트로 누름·끌기를 못 만든다).
- **이동·충돌 물리(PD 2026-11-16 「알까기·당구처럼 미는 힘에 맞춰 세게 날아가 세게 부딪히게 · 등속이면 안 됨 · 힘과 거리에 비례」)**: ① **부딪히는 힘** = `ActionResolver.ImpactPower(쏜 거리, 부딪히기까지 간 거리)` = 쏜 거리 − 간 거리 × `impactFalloff` 0.4(그 전 = 남은 거리 → 멀리 있는 상대일수록 힘이 0 에 가까웠다) — 보병 밀어내기·자기 튕김 · 창병 밀치기 · 바위 굴리기 · 튕김 연쇄 · 연쇄 밀기(`Push`)가 같이 쓴다 · 고순 재행동 한도만 남은 거리 그대로. ② **쏘는 최대 거리** = 병종 값 `unitStats.launchDistance`(`Unit.LaunchDistance` → `SkillMods.SlingMax` = 조준·이동·적 AI · 보·창·궁·책 7.2 · 기 10.4 — 아래 4차 · 배율 `meleeLaunchScale` 은 폐지) · 스킬 「행동 반경」·밀치기 스킬 거리는 병종 값(`SlingMaxDistance`) 그대로. ③ **이동 연출 = 등감속**: `Fx.MoveDuration` = √(거리 × `moveRefDistance` 4.5) / 속도(멀리 갈수록 빠르게 출발해 마찰로 멈춤) · 부딪히러 가는 직진 = `Fx.MoveAlong(…, launch)`(가는 동안 감속 × impactFalloff → 부딪히는 순간의 속도 = 밀려나는 유닛의 출발 속도) · 수치는 `BattleManager.Configure` 가 `Fx.Configure` 로 넘긴다. ④ `collisionSelfBounceMinRatio` 0.5 → 0(힘에 비례 · 하한을 둔 이유였던 「적 바로 앞을 노리면 힘이 0」이 ①로 없어짐). 세 값 모두 제안값(PD 확인 대상). 테스트 기대식 = `BattleFlowTests.Impact`. 지형지물(언덕·산) 배치는 이 수치가 정해진 뒤의 레벨 작업(미착수).
- **병종별 밀기·튕김(PD 2026-11-16 2차)**: 보병 = 미는 거리·튕기는 거리 30 % 감소(`collisionPushRatio` · `collisionSelfBounceRatio` 1 → 0.7 · 연쇄 밀기 전달과 보병·기병의 지형 튕김도 같은 값) · 창병 = 보병보다 더 밀고(`spearPushRatio` 1.5) **보병이 튕기는 거리의 절반만 밀려남**(`spearRecoilRatio` 0.5 = 부딪히는 힘 × collisionSelfBounceRatio × 이 값 — 뜻이 바뀜: 그 전 = 상대가 밀린 거리 × 0.2) · **상대를 쓰러뜨려도 · 상대가 안 밀려도 밀려난다**(그 전 = 상대가 살아서 밀릴 때만 → 처치하는 타격은 전혀 안 튕김 = PD 「전혀 튕기지 않는 것 같아」의 원인) · **지형(장애물 기믹)에 부딪히면 세 병종 모두 튕긴다**: 보병·기병 = 부딪히는 힘 × collisionSelfBounceRatio · 창병 = 그 × spearRecoilRatio · 바위도 포함(보·창 = 바위를 굴리면서 튕김 · 기병 = 바위에 막혀 튕김 · 그 전 = 정지) · 기병이 지형에 부딪히는 힘도 `ImpactPower`(`CavalryRoutine` gimLeft). 전장 가장자리 벽은 그대로(멈춤 · 손책 스킬만 튕김). 기병의 유닛 관통은 그대로. 학습 판 = 판별 발사 세기 키 `drag_lock_shot_pull_<장>_<판>`(`TutorialDirector.ShotPull` · 1-2 = 1 · 1-8 = 0.75 · 그 밖 = 공통 0.37). **3차(같은 날 PD 「창병이 미는 거리가 현재의 30 % 정도 · 이에 맞게 보병도」)**: `spearPushRatio` 1.5 → 0.45 · `collisionPushRatio` 0.7 → 0.21(창병 : 보병 비율 유지) · 연쇄 밀기 전달은 `pushChainRatio` 0.7 로 분리(미는 비율을 줄여도 연쇄는 그대로 · `Push` 안) · 튕기는 거리(`collisionSelfBounceRatio` 0.7)와 창병 반작용은 그대로 · 학습 판 1-2 = 4번 척후 y −6 → −7.9(장비가 2.2 밀려 닿는 자리 · 최대 세기) · 테스트 배치 2곳(창병이 아군 밀기 · 강물로 밀기)은 수치에서 계산. **4차(같은 날 PD 「전반적인 이동 거리 20 % 줄여 · 기병은 통과할 때마다 이동 거리가 줄어야 · 보병도 약간씩 · 창병·기병 = 덜 밀림 · 궁병·승병 이동 거리도 보병만큼 · 이동 범위 밖 최대 사거리 1.5배」)**: ① 쏘는 최대 거리 = 병종별 `launchDistance`(보·창 9 → 7.2 · 기 13 → 10.4 · 궁·책 4 → 7.2 = 보병과 같게) · 궁병·책사 사거리 = `LaunchDistance`(사거리 = 이동 범위 규칙 #1080 유지 → 제자리 사격 7.2) · `archerRangeRatio` 0.2 → 0.5(다가가 쏘는 최대 사거리 = 이동 범위의 1.5배 = 10.8 — PD 문장을 이렇게 읽음 · 다른 뜻이면 이 값 하나만 바꾼다). ② **기병 관통 감쇠** `cavalryPassLossRatio` 0.25: 유닛(적·아군) 하나를 지날 때마다 그 뒤 남은 거리 × 0.75(`ActionResolver.PassLossTravel` · `CavalryRoutine` 구간마다 · 대상 미리 계산도 같은 식 · 줄어든 거리로 못 지나는 밀집 대열에서는 종착점이 앞으로 되짚힌다 = 기존 `BackOffFromUnits`). ③ **유닛에 부딪혀 잃는 힘** `unitHitBounceLossRatio` 0.15: 보병이 유닛에 부딪힌 뒤 튕기는 거리 = 힘 × collisionSelfBounceRatio × 0.85(`UnitHitKeep` · 지형 튕김은 그대로 · 창병 반작용에도 적용해 「보병의 절반」 유지). ④ **병종 밀림 가중치** `unitStats.pushTakenRatio`(보·궁·책 1 · 창·기 0.6 → `Unit.PushTaken` · `ActionResolver.PushTakenMult` = 가중치 × 스킬 knockback_taken): 보병·창병의 밀기 · 튕김 연쇄 · 연쇄 전달(`Push`)에 곱한다 · 기병 관통 밀어내기(`cavalryKnockback`)와 스킬 넉백은 그대로. ⑤ 학습 판: 1-2 4번 척후 y −7.9 → −9.3(유비가 기병 장비를 미는 거리 약 1.15) · 1-7 발사 세기 키 `drag_lock_shot_pull_1_7` 1(늘어선 넷을 모두 지나려면 최대 세기). 값(0.25 · 0.15 · 0.6)은 제안값. **5차(같은 날 PD 「궁병이 이동과 동시에 공격하지 못하게 · 보병이 아군과 닿아 튕겨서 추가로 적을 공격 · 여러 번 공격 · 기병과 창병이
- **조준·턴 표시(PD 2026-11-16 2차)**: 방향 화살표 = 유닛·체력 바 위(`order_arrow` 10 — 같은 날 −6 으로 내렸던 것을 되돌림) · **손 조작 중에는 화살표만** 보인다(`SlingshotInput.ShowAim`) — 맞을 유닛의 주황 강조 · 예상 궤적(노란 점선) · 화살 경로선 · 광역 원은 `ShowPreview`(자동 플레이 캡처·테스트용)에만 남음 · **쏜 행동이 끝나면 다음에 행동할 아군을 자동 선택 + 화면 이동**(`FocusNext` · 방금 유닛이 또 행동할 수 있으면 그 유닛 · 아니면 편성 순서로 다음 · 즉시형 스킬 연출 뒤와 학습 판 잠금 안내 중에는 안 옮김) · 전원 행동 시 자동 적 턴은 원래 구현(`BattleManager.AllPlayersActed`) 그대로 — 스킬로 얻은 추가 이동만 남았을 때만 빈 곳 탭으로 넘긴다.
스킬 이펙트 1차 + IB(쿠로네코) 연출 시험 — 돌진·조준 UI·타격감 (PD 2026-11-10) - 기본 공격(돌진) = IB 이펙트 그대로 시험: 앞 빛 물결 · 속도 꼬리(진영색 4색 · 멈춘 자리에서 0.12초 흐려짐) · WL 흙먼지 · 기준점 dash(아래로 갈수록 발 쪽) · 히트 이펙트 제거(PD 지정 대기) - 슬링샷 방향 결정 UI = IB GameTouchArrow 이식(IbAimArrow · IB 유닛 반지름 0.496 기준 비율) + 진행 중 캐릭터 연출(IbUnitMarks: 발밑 원 · 몸 빛 · 조준 중 속성 방울) · 값 표 Resources/Skills/ib_ui.csv - 기병: 복귀 영역(채운 원 · PreviewCavalryReturn) · 복귀 때 돌아서기(UnitView.TurnAround) - 타격감: HitFeel + CameraController.Shake · 표 hit_feel.csv(IB 흔들림 값은 디컴파일에 없어 추정값) - 액티브 스킬 1차 연출(Fable 제안 56 스킬 · 사본 Resources/Fx/TKS_Fx_Sk_*) · SkillVfx 확장(s_camp · f_fwd · f_drift · f_fade · s_over · b_flat · 트레일 페이드) · 셀화 셰이더 포트 - 2D 돌진 시험본(Dash2D · Aura2D test_aura) · 이전 시험 행은 skill_vfx.csv 에 # 주석 - 여포 크기: dz_boss_lvbu 몸 높이 819 → 718(깃털 제외 · 말 탄 유닛 머리 끝 상한 때문에 작아졌음) - 원본 = Assets/VFX/IB(쿠로네코 · GUID 유지 · Tools/wl_vfx_import.py --skip-scripts) · 사본 도구 Tools/make_ib_fx_copies.cs · make_ib_camp_textures.py · build_dash2d.cs - 테스트 PlayMode 118/118 통과 · 자동 재직렬화(png meta · UITheme · ProjectSettings) 제외 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 04:19:44 +00:00
- **여포 크기(PD 2026-11-10 「왜 여포는 다른 기병보다 작지?」)**: 말 탄 유닛은 머리 끝 상한(BalanceConfig.mountedArtMaxTop 1.3 × 표준 키)에 맞춰 줄어드는데, `dz_boss_lvbu` 의 몸 높이(`meta.json` bodyHeightPx · `art_size.csv` body_px)가 머리 깃털 끝까지 819 px 라 몸 전체가 더 줄었음 → 왕관 끝 ~ 발 718 px(front_idle 실측 · 깃털 제외 · 다른 기병의 투구 끝 기준과 같은 규칙)로 고침 → 배율 0.2381 → 0.2716(+14 %). 원본 백업 = 세션 scratchpad. **다른 PC 에서 그림을 다시 export 하면 819 로 되돌아갈 수 있음**(export 규칙 = 불투명 폭 30 % 행 — 깃털이 넓어서 안 걸러짐).
- **근접 3병종 특징 = 한 줄 정의(PD 2026-11-10 직접 지시)**: **보병** = 적을 밀치고 튕겨나며 튕기면서 다른 적을 추가로 공격(알까기 + 연쇄 · #1098 그대로 · 목표점 명중 추가 이동 = 제거(PD #1112 결정 ⑱)) · **창병** = 적을 크게 밀치지만 자신은 적게 밀림(`spearPushRatio` 1.5 > 보병 `collisionPushRatio` 1.0 · 반작용 남은 거리 × 0.3 < 보병 자기 튕김(2026-11-10 = max(남은 거리, 슬링 최대 × 0.5) × 1)) · **창병 대기(견제) 제거**(「유저가 인지하기 어려움」 · 목표점 명중해도 `SetOverwatch` 안 함 · HUD 「견제 반경·대기 중」 문구 삭제) · **기병** = 적을 관통해 이동 · **목표점 명중 시 제자리 복귀 제거**(「유저가 인지하기 어려움」 · `PreviewCavalryReturn` · 조준 때 복귀 영역 `ShowReturnZones` 삭제 · AI 가중치 `cav_return`·`cav_stranded` 삭제). 견제·복귀 스킬 = #1112 PD 새 기획으로 전부 재설계(견제 없음 · 복귀는 스킬 효과 `return_on_hit`·`return_always`·`return_aim` 으로만) · `SkillMods.Overwatch*` 삭제 · `BattleManager.ApplyOverwatch` · `Unit.Overwatch` 는 스킬 확장 없이 남음(대기 유닛이 없어 실행 안 됨).
스킬 이펙트 1차 + IB(쿠로네코) 연출 시험 — 돌진·조준 UI·타격감 (PD 2026-11-10) - 기본 공격(돌진) = IB 이펙트 그대로 시험: 앞 빛 물결 · 속도 꼬리(진영색 4색 · 멈춘 자리에서 0.12초 흐려짐) · WL 흙먼지 · 기준점 dash(아래로 갈수록 발 쪽) · 히트 이펙트 제거(PD 지정 대기) - 슬링샷 방향 결정 UI = IB GameTouchArrow 이식(IbAimArrow · IB 유닛 반지름 0.496 기준 비율) + 진행 중 캐릭터 연출(IbUnitMarks: 발밑 원 · 몸 빛 · 조준 중 속성 방울) · 값 표 Resources/Skills/ib_ui.csv - 기병: 복귀 영역(채운 원 · PreviewCavalryReturn) · 복귀 때 돌아서기(UnitView.TurnAround) - 타격감: HitFeel + CameraController.Shake · 표 hit_feel.csv(IB 흔들림 값은 디컴파일에 없어 추정값) - 액티브 스킬 1차 연출(Fable 제안 56 스킬 · 사본 Resources/Fx/TKS_Fx_Sk_*) · SkillVfx 확장(s_camp · f_fwd · f_drift · f_fade · s_over · b_flat · 트레일 페이드) · 셀화 셰이더 포트 - 2D 돌진 시험본(Dash2D · Aura2D test_aura) · 이전 시험 행은 skill_vfx.csv 에 # 주석 - 여포 크기: dz_boss_lvbu 몸 높이 819 → 718(깃털 제외 · 말 탄 유닛 머리 끝 상한 때문에 작아졌음) - 원본 = Assets/VFX/IB(쿠로네코 · GUID 유지 · Tools/wl_vfx_import.py --skip-scripts) · 사본 도구 Tools/make_ib_fx_copies.cs · make_ib_camp_textures.py · build_dash2d.cs - 테스트 PlayMode 118/118 통과 · 자동 재직렬화(png meta · UITheme · ProjectSettings) 제외 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 04:19:44 +00:00
- **IB 크기 · 캐릭터 연출(PD 2026-11-10 「IB 와 화살표 크기도 다르고 선택된 캐릭터 주위 연출도 누락」)**: 값 표 `Resources/Skills/ib_ui.csv`(`TKS.IbUi`) — IB 유닛 반지름 0.496(ExportCharacter size 8 × 0.062) 기준 배율 = 이 게임 유닛 반지름 / 0.496 → 고리 지름 = 반지름 × 5.4 · 화살표 세기 s = IB 월드 당김 × 0.6(0.5~1.5) · IB 취소 거리 0.5. **`TKS.IbUnitMarks`** = 선택한 행동 가능 아군 발밑 도는 원(`TKS_Fx_IB_TargetCircle` · IB ShowUserTurnMark) + 몸 둘레 빛(`TKS_Fx_IB_AttackReady`) · 조준 중(누름 ~ 놓음) 모든 유닛 속성 방울(`TKS_Fx_IB_Attribute_<속성>` · IB SetActiveBarrierVisualEffect · 진영 → 속성 = 표 element_*: 위 물 · 촉 나무 · 오 불 · 군·진영 없음 어둠).
- **타격감(PD 2026-11-10 「화면 흔들림 등도 IB 를 참고해서」)**: `TKS.HitFeel` + 표 `Resources/Skills/hit_feel.csv`(행동 중 유닛이 상대에게 처음 피해를 준 순간 · `SkillSystem.Hit` · 흔들림 = `CameraController.Shake`(추적 위치는 그대로 두고 흔들림만 더함) · 히트 스톱 칸 있음(현재 0)). **IB 실측**: 흔들림 함수 6종은 스킬·궁극기·기믹 이펙트 애니메이션 이벤트로만 불리고 본문이 디컴파일에서 비어 있어 값 없음 · 일반 타격·벽 튕김엔 흔들림 없음 · 히트 스톱 없음 → 표 값(hit 0.15초 · 키 10 % / 기병 0.18초 · 13 %)은 추정.
- **2D 돌진(PD 2026-11-10 「기본 공격(돌진) 이펙트가 너무 3D 느낌 → 2D 처럼」 · MSFX 혜성 행은 표에 `#` 주석으로 남김 = 되돌리기)**: **3차(현재 · PD 2026-11-10 「검기는 이전 형태가 더 나음 · 대쉬 이펙트는 캐릭터 몸을 벗어나지 않도록 · 첨부 같은 느낌으로 몸을 뒤덮는 연출을 스킬용 시험」)** = 초승달 `Head` = 1차 그림 `dash2d_crescent`(검정 외곽선 · 진영색 곱) · 대쉬 층(꼬리 0.04초 · 바람 줄기 · 알갱이 · 흙먼지) = 유닛을 따라 움직이는 Local 공간 · 몸 기준점 반경 0.45 키 안(실측 그림 경계 좌우 ±0.56 · 아래 −0.60 ~ 위 +0.59 키) · 바람 줄기 `Lines` · 알갱이 `Dots` = 유닛 위 반투명(표 `s_over` = `Head;Lines;Dots` · 유닛 아래면 몸에 다 가려 안 보임 · PD 「몸의 대쉬 효과가 왜 안 보이나」) · 꼬리 · 흙먼지 = 유닛 아래 · **기병 복귀 = 돌아서서 감**(`UnitView.TurnAround` · 복귀 방향으로 보기 + 곧장 위·아래면 좌우 반전 · 도착 뒤에도 마지막 이동 방향 PD #1082) · **몸 뒤덮는 기운(시험)** = `TKS_Fx_Aura2D_<진영>`(혜성 기운 `aura_comet_<진영>` 겹쳐 깜빡임 · 불꽃 혀 `aura_wisp` · 반짝임 = 유닛 아래 · 옅은 막 `Veil` · 앞 테 `Rim`(2차 검기 그림) = 유닛 위) · 표 키 `test_aura` · 테스트 씬 「기운 시험」 스위치(`SkillVfx.TestTravelKey` · 켜면 슬링샷 공격 돌진에 함께 · 실제 전투 = 늘 빈칸). 2차 = 외곽선 없음 · 그림 `Assets/VFX/TKS2D/`(만들기 = `python -I -X utf8 Tools/make_dash2d_textures.py` · 진영색 원본 = `Tools/dash2d_camps.csv`) → 프리팹 `Resources/Fx/TKS_Fx_Dash2D_<wei|shu|wu|other>`(검기 초승달 `Head` = 진영별 그림 `dash2d_slash_<진영>` · 유닛 위 · 반투명 꼬리 `Trail`(앞 0.7 → 0) · 흰 바람 줄기 `Lines` · 알갱이 `Dots` = 유닛 아래 · 수명 동안 투명해짐) + `TKS_Fx_Dust2D`(부드러운 반투명 흙먼지 · 모든 진영) · 다시 만들기 = `unity command … script eval --file Tools/build_dash2d.cs`(값을 바꾸면 이 파일과 프리팹을 함께). 1차(검정 외곽선 셀 그림)의 `dash2d_crescent.png` · `dash2d_highlight.png` 는 안 씀. 표 `b_flat` = 1 이면 화면 안에서 진행 방향으로만 돌림(기울기·팩 루트 회전 무시 · `SkillVfx.FlatRotation`) · 크기 단위 = 유닛 키 1(`f_scale` 1) · 끝 소멸 = `f_fade` 0.12(`SkillVfxFade` 가 스프라이트 불투명도도 낮춤).
- **액티브 스킬 1차 연출(PD 2026-11-10 「fable 제안 이펙트 연출을 구현까지 1차로 · 테스트 씬에서 하나씩 피드백」)**: Fable 제안(조직 레포 `공유/기획팀_산출물/삼국지슬링샷/스킬연출_1차_Fable제안_2026-11-10.csv` · 56 스킬 · 138행 · 기믹 14유형) → `skill_vfx.csv` 스킬 id 행(메모 = 원본 경로 · 이유) · 사본 `Resources/Fx/TKS_Fx_Sk_<원본 이름>`(131) + 진영색 안 맞는 10개 = 영웅 전용 보정 사본 `…_<진영>` · WL 추가 이식 1(서황 hit `FX_Whirlwind Ax`). 점검 = 사본 누락 0 · 셰이더 오류 0 · 짧은 이펙트 8 정상 방출(실측). **알려진 한계(PD 확인 대상)**: 아군 전원·적 전원 효과는 시전자 위치에만 표시 · 피해 0 인 매혹·밀기는 hit 이 안 뜰 수 있음 · 장합 변진 도착 연출 지연(f_delay) 없음 · 서황 도끼 뒤 판 메시(`Plane_Trail`)가 정지 시 사각형으로 보일 수 있음 · 색은 YAML 근사 판독(Fable).
- **액티브 스킬 연출 2차 = 새 기획 #1112 기준 재정리(PD 2026-11-10 「재정리부터 시작」)**: 1차 56행은 옛 기획(13:19) 기준이라 새 기획(19:00)과 효과가 다름(유비 인덕 → 이도류 · 관우 견제 → 청룡언월 등) → 액티브 72개 전부 다시 정리(1차 그림 중 뜻이 맞는 것은 유지 · 새 16개 추가) · 표 `skill_vfx.csv` 스킬 행 215 · 재정리 표 = 조직 레포 `공유/기획팀_산출물/삼국지슬링샷/스킬연출_2차_새기획_2026-11-10.csv`(스킬 이름 · 효과 · 이벤트 · 이펙트 · 이유) · 1차 원본 = 같은 폴더 `스킬연출_1차_Fable제안_2026-11-10.csv`. **이벤트 추가(코드)**: `shot` = 특수·일반 사격 투사체(`SkillVfx.Shot` · `Fx.Arrow` 자리 전부 · 비행 시간 `Fx.ArrowDuration` 동일 = 피해 시점 불변 · 행 없으면 선 화살) · `blast` = 광역 중심(`SkillVfx.Blast` · 즉시 광역 · 폭발 사격 · 황충 명중점 · 목책 칸 · **f_scale 단위 = 광역 반경** · 띄우면 납작한 원 `Fx.Burst` 생략) · `zone` = 스킬 지대 그림 밑에 반복(`SkillVfx.Zone` · 반경 단위 · 선분 = f_every × 반경 간격 · 지대와 함께 사라짐) · `aura` = 그 스킬 효과가 남아 있는 동안 반복(예약 대기 · 시전 중 · 시한 효과 대상 = 범위 버프 받은 아군 각각 / 대상 없는 시한 효과 = 시전자 · `SkillVfxLoops` 0.15초마다 맞춤) · `status` = 공통 상태 이상 반복(키 `status_stun`(기절·행동 불가) · `status_confuse` · `status_bleed` · `status_poison` · `status_burn`) · `heal` = 공통 회복(키 `common` · `SkillSystem.Heal`). 반복(지대·기운·상태)은 원래 반복인 층만 남기고 한 번만 터지는 층은 끈다(가속 오라 섬광 층을 반복시키면 화면을 덮는 빛기둥 · 실측) · 반복 층이 없는 프리팹은 전체 반복. 새 사본 13(`TKS_Fx_Sk_Stun_loop` · `HCFX_Sign_QuestionMark_Loop` · `FX_splash_blood_air` · `HCFX_Poison_02` · `Fire_small` · `Fire_medium` · `Fire_cartoon_poison` · `Regeneration_health_loop` · `HCFX_Meteor_03_Single` · `FX_Shoot_Arrow_projectile` · `FX_Shoot_Arrow_hit` · `FX_Shoot_Poison_projectile` · `FX_Shoot_Dagger_projectile`). **크기 재는 법(2026-11-10)**: 프리팹 지름은 입자 크기·모양 값으로 추정하면 몇 배씩 틀림 → 영웅 위 3.5 칸에 배율 0.5 로 띄우고 직전 화면과 캡처 차이(픽셀 상자)를 재서 1 배율당 지름을 구한다(기준 = 1×1 사각형 · 게임 창 캡처는 세로 화면을 가로로 눌러 담아 가로 125 · 세로 39 px/칸) · 짧은 폭발은 0.1·0.45초 두 번 캡처 · `while read` 반복 안의 `unity` 명령은 `</dev/null`(안 그러면 목록 입력을 먹어 첫 항목만 실행).
- **Hyper Casual · Shoot&Hit(VFX_Klaus 셰이더 그래프) 안 보이던 문제(2026-11-10 실측)**: 재질 속성 `Boolean_BB495B7B` = 「Use SoftParticleFactor?」 = 1 이면 장면 깊이로 투명도를 깎아 이 게임(직교 2D · 스프라이트 깊이 없음)에서 입자가 있어도 색 0 → `SkillVfx.SpawnPrefab` 이 띄울 때 그 속성만 0 인 재질 복제본으로 바꿔 끼움(`DisableSoftParticles` · 원본 팩 무수정 · 재질마다 1번 복제) · 1·2차 표의 HCFX·FX_Shoot 행 전부 이제 보임(크기 재조정 필요할 수 있음). **react 이벤트** = 그 스킬로 재행동 기회가 생긴 순간 1번(`SkillSystem.EndAction` · 유비 = Vol.1 `HCFX_Energy_08`) · 유비 예약 기운(aura) = Vol.2 `HCFX_Energy_03`(사본 `TKS_Fx_Sk_HCFX_Energy_03_v2`) — PD 2026-11-10 지정(스크린샷 대조 추정). **입력(PD 2026-11-10)**: 유닛을 누른 뒤 화면에서 `TapPixels` 이상 움직여야 당김 시작(그 전에 놓으면 선택만 · 스킬 버튼 사용 가능) · 행동 가능 유닛을 누르면 카메라 초점 이동 멈춤 · 패널 위 마우스 휠 = 확대 안 함 · 테스트 씬 영웅 고를 때·다시 배치 = 기본 확대(`cameraViewHeight`). **사본 색 바꾸기(2026-11-10)** = 표 `Tools/fx_recolor.csv`(원본 사본 → 새 사본 · 색상 범위 blue/red/green/all 또는 tint(회색도 밝기만 남기고 물들임) · 투명도 배수 · 더하기 섞기 층) → `unity command … script eval --file Tools/recolor_fx.cs` · 지금 = 유비 예약 기운 금빛(`…Energy_03_v2_gold`) · 돌진 흙먼지 모래색(`TKS_Fx_SpearRushDust_sand` · 보병·창병·기병 공통). **2026-11-11 PD**: 표에 `f_sat`(채도 배수) · `s_off_layers`(끌 층) 칸 추가 · 흙먼지 = 돌 조각 층 끔 · 투명도 ×0.45(경로마다 연속은 유지) · 재행동 = 연녹색 `…Energy_08_lime`. **2026-11-11 PD 3차**: 유비 기운 감싸기 해제(경계가 잘려 보임 → 유닛 아래 한 벌) · `b_loopall` = 이어지는 방출(층마다 한 주기 터짐 수를 초당 방출로 바꾸고 첫 터짐만 시작 때 1번 · 끝 = 방출만 멈춰 자연 소멸) · 조준 화살표·고리 색 = `ib_ui.csv aim_arrow_color[_진영]` · `aim_ring_color[_진영]`(촉 = 녹색) · 화살표 그림 = `Assets/VFX/IB/_TKS/skill-arrow_b_filled.png`(원본 IB 2단 촉에서 위 촉 ~ 아래 미늘 끝 사이·바깥 윤곽만 채움 · 아래 미늘 밑 안쪽 홈은 비움(PD 2026-11-11 예시 · X 표시) · 머리~꼬리 하나의 매끈한 외곽선 · 좌우 두 톤(1 : 0.86) + 꼬리 밝기 그라데이션 · 불투명도 222 · 흰 그림에 색을 곱함(기본 #08FEFE · 촉 #46F27A) · 테두리 = 원본 실측 세 겹(바깥 2px 검은 그림자 · 가장자리 1px 어두움 → 그림 안 · 안쪽 3px 하얀 띠 → 색을 곱하지 않는 겹그림 `skill-arrow_b_rim.png` = 프리팹 arrow 의 자식 `arrow_rim` · 순서 arrow + 1) · 8배 해상도 거리로 부드럽게 · 다시 만들기 = `python -I -X utf8 Tools/make_aim_arrow.py`(그 뒤 두 그림 다시 불러오기) · 사본 프리팹 `TKS_Fx_IB_GameArrow` 의 arrow) · 목표 지점 흰 고리(`SlingshotInput.targetRing`) = 끔. 기운 몸 감싸기 = 표 `f_wrap`(같은 씨앗 두 벌 + 사각 SpriteMask · 발 ~ 발 + 키 × f_wrap = 캐릭터 앞 · 그 위 = 캐릭터 뒤 · `SkillVfx.SpawnWrap` · 유비 0.45) — 「뒷모습이면 캐릭터 위」 규칙은 PD 「후면일 때 상단 X」로 삭제. 단색 노란 선택 원(UnitView) = 끔 · 선택 표시 = IB 발밑 도는 원(빛나는 타원 · `ib_ui.csv show_target_circle` 1 · `target_circle_scale` 1.3). 아군 선택 = 그 유닛을 제자리에 두고 부드럽게 확대(`BalanceConfig.selectZoomRatio` 0.85 · 해제 = 원래 크기 · `CameraController.ZoomTo`). **2026-11-11 PD 2차**: 당기는 동안 발사 방향을 봄(`SlingshotInput.OnDrag` → `UnitView.SetFacing`) · 조준 중 속성 방울 = 유닛 아래(`ib_ui.csv order_bubble` −7) · 몸 둘레 모이는 빛 = 파란 조준 고리와 같은 범위(`
- **액티브 스킬 연출 본작업(2026-11-11 PD 「유비를 제외한 모든 영웅 · 상업용 게임처럼 화려하게 · 게임 화풍을 고려해 색감·질감·라이팅을 조정하는 셰이더를 설계」)**: 유비를 뺀 액티브 71개 전부 다시 설계 → 표 `skill_vfx.csv` 스킬 행 311(유비·`basic_*`·`test_aura` 줄은 그대로) · 설계 원본 = `Tools/skill_vfx_design.py`(스킬 → 이벤트별 이펙트 · 목표 크기 · 색 · 이유 → 표를 다시 씀 · **손으로 고친 값은 이 파일에도 옮길 것** · 실행 `python -I -X utf8 Tools/skill_vfx_design.py Tools/fx_catalog` → `unity command … script eval --file Tools/make_skill_fx_copies.cs`).
- **화풍 층(`TKS.FxStyleLayer` · 셰이더 `Resources/Shaders/TKS_FxResolve` · `TKS_FxStyle` · 값 표 `Resources/Skills/fx_style.csv`)**: 이 게임 그림 = 굵은 먹선 + 평평한 단색 면 + 빛 번짐 없음 → 팩 이펙트(부드러운 빛 · 그러데이션)를 재질마다 고치지 않고, 표 `b_cel` 1 인 행의 이펙트만 전용 층(28 유닛 아래 · 29 유닛 위)으로 옮겨 보조 카메라로 검은 바탕·흰 바탕에 한 번씩 그린 뒤(= 어떤 섞기 방식이든 칠한 색·덮은 정도를 되찾음) 화면을 덮는 판 2장(그리는 순서 −2 · 12)에 「덮은 정도 단 나누기(옅은 테 → 몸 → 밝은 단) · 색상/흰 섞임/밝기 단계화(흰 심 = 미색) · 먹선 외곽선」으로 그린다. 화풍 층 이펙트가 없으면 비용 0 · 있을 때 = 이펙트만 4번 더 그리고 판 2장(모바일 최적화가 필요하면 `rt_scale` 을 낮추거나 이펙트를 프레임 그림으로 구워 쓰는 방식으로 전환). `b_cel` 빈칸 = 팩 원본 그대로(유비 · 기본 공격 IB).
- **화풍 층 2차(2026-11-11 PD 「연기 형태를 포함해 지저분함 · 해상도가 깨진 느낌 · 번쩍번쩍 → 더 깔끔하게」)**: 원인 = ① 8방향 표본 먹선이 작은 입자마다 점선 테를 만듦 ② 선 떨림(초당 10번)이 윤곽 전체를 지글거리게 함 ③ 밝기 단이 계단지게 끊김 + 팩 그림의 망점·잔무늬가 점으로 남음 ④ 회색·검정 연기가 어두운 얼룩 · 어두운 노랑 = 국방색 ⑤ 약한 빛이 문턱을 넘는 순간 불투명 면으로 툭 나타남. 고친 구조 = `FxStyleLayer.Resolve`(실행 중·미리보기 도구 공용): 되찾기(곱한 색 · 옅은 빛 버림 `glow_knee`) → 가장자리 다듬기(3×3 텐트 번짐 `smooth_world`·`smooth_iter` · 16비트 그림) → 몸 마스크(r 몸 · g 덮음 · b 밝기 · a 채도)를 절반 해상도에서 먹선 굵기만큼 번지게 → `TKS/FxStyle` 이 마스크를 일정 높이(`ink_level`)로 잘라 **굵기가 고른 먹선** · 가는 줄기에는 먹선 없음(`thin_*`) · 몸 안 잔 구멍 메움(`hole_*`) · 옅은 것은 반투명 + 먹선 없음(`solid_*`·`faint_alpha`) · 명암·색 단은 둘레 평균으로(`tone_smooth`) · 무채색은 밝은 미색(`gray_v_min` 0.84) · 색 있는 면 최저 밝기 `v_min` 0.68 · 검정에 가까운 칠 = 무채색으로 봄. 선 떨림(`wobble_*`)·안쪽 먹선(`ink_inner`)은 삭제. 비용 = 층마다 번짐 2번(전체 해상도) + 마스크 3번(절반 해상도)이 더 듦. 값 표를 통째로 덮어쓰면 데이터 보호 훅이 막음 → 줄 단위로 고칠 것(백업 = `_backup_assets/` · git 미추적).
- **화살·비도(2026-11-11 PD 「투사체 크기가 비정상 · 화살이 그림 맨 위에 어색 → 입체적으로 박혀 있는 느낌」)**: 팩 `FX_Shoot_Arrow/Dagger_projectile·hit` 은 3D 메시라 크기가 맞지 않고(비도 = 유닛 키의 2배) 꽂힌 화살이 머리 위에 길게 섬 → 자체 제작으로 교체(화풍 층을 거치지 않음 `b_cel` 0 · 그리는 순서 +1 = 다른 이펙트보다 위). `TKS_Fx_C_ArrowShot`·`DaggerShot`(길이 1 단위 = 표 `f_scale` 이 유닛 키 대비 길이 · 화살 0.42~0.55 · 황충 0.9 · 비도 0.42 · 가슴 높이 `f_dy` −0.12) · `TKS_Fx_C_ArrowStuck`·`DaggerStuck`(보이는 길이 0.27~0.38 · `SkillVfxStuck` = 날아온 방향 그대로 몸통에 박힘 · 촉은 몸속 · 파고들며 떨림 · 몸에 지는 그림자 · 깃 쪽이 굵은 원근 · 1.6초 뒤 흐려짐 · 대상에 붙어 함께 움직임 · 표 hit 행 `b_follow` 1 · `f_fwd` −0.08 · `f_dy` −0.14 · `f_life` 1.8). 기준점 `target`·`body` 는 얼굴 높이(위치 + 키 × 0.45)라 몸통에 놓으려면 `f_dy` 로 내린다.
- **피격 먼지 제거 · 돌진 먼지(2026-11-11 PD 「스킬 공격에 피격 시 먼지 발생되는 이펙트는 제거 · 모든 유닛의 슬링샷 먼지를 이번에 화풍에 맞춘 먼지 형태로」)**: 표 칸 `s_off` 추가(끌 자식 층 이름 · `;` 여러 개 · 끝 `*` = 그 글자로 시작하는 층 전부 · `@root` = 뿌리 층 → `SkillVfx.TurnOff` 가 그 층의 방출·그리기만 끔 · 사본·팩 원본 무수정). 맞는 쪽 행(hit · blast) 규칙 = 설계 도구 `HIT_DROP`(통째로 먼지인 `HCFX_Dust_*` = 행을 만들지 않음 · 5행 빠져 스킬 행 306) · `HIT_OFF`(이펙트 안의 뭉게구름·먼지 줄기·연기·흰 번짐·바닥 금·그을음 층 = 땅 스킬 뿌리 층/`FX_earth_skill_hit_air_01`·`dust*`·`particle_splash`·`crack*` · 폭발 `smoke*`·`floor_trace` · 베기 `smoke`·`spread*` · `Poof_*` `clouds` — 돌·불티·섬광·베기 줄기는 남김). 독 안개 · 하트 고리 · 불 연기(더하기 층) · 시전(cast)·돌진(travel) 먼지는 그대로. 불꽃 지대 `FX_Firesmoke_2` 는 큰 연기 뿌리 층이 화풍 층에서 미색 원반으로 덮여 `@root` 끔. 자체 제작 박힘·화살비의 먼지 층도 뺌(조각은 남김). 끌 층을 고를 때 = 무채색 · 반투명 섞기 · 0.35초 넘게 남는 층이 화풍 층에서 미색 구름이 됨. **일반 슬링샷 먼지**(`basic_infantry;basic_spear;basic_cavalry` travel `TKS_Fx_SpearRushDust_sand`) = `b_cel` 1(화풍 층 = 밝은 미색 구름 + 먹선). **화풍 층 보완**: 새까만 칠(둘레 평균 밝기 `black_lo`~`black_hi` 아래 · 먹 무늬·먹 베기)은 먹색 그대로 — 2차에서 검정까지 미색으로 올려 `HCFX_Hit_07` 같은 먹 무늬가 미색 덩어리로 보였음. 촬영 도구 = 영웅 id 앞에 `-`(예 `-guanyu`)면 액티브 없이 일반 슬링샷. ⚠ 같은 에디터를 쓰는 다른 세션이 Play 중에 .cs 를 저장하면 재컴파일이 끼어들어 `FrameAnimator` NullReference 가 쏟아짐(2026-11-11 실측) → Play 전에 `ListAgents` 로 확인·조율.
- **유비 예약 기운·재행동(2026-11-11 PD 직접 지시 · 유비 행은 표 생성 도구가 그대로 보존)**: 예약 기운 = 이전 팩 이펙트(`TKS_Fx_Sk_HCFX_Energy_03_v2_gold`) 유지 — ① 끊김 원인 = 팩 층의 방출이 「1초 주기 중 앞 0.5초만」 내는 곡선 → `b_loopall` 이 한 주기 평균으로 고르게 폄(`SkillVfx.ForceLoop` · 고른 방출 층과 수명 ≥ 주기인 터짐 층(다른 영웅 구슬 기운)은 예전 값 그대로) ② 몸 감싸기 `s_wrap`(층 이름*방출 배수) = 금줄 층을 같은 씨앗 두 벌로 나눠 카메라에 가까운 반 = 유닛 위 · 먼 반 = 유닛 아래(셰이더 `Resources/Shaders/TKS_FxPackHalf` = 팩 HCFX apb 그래프를 손으로 옮기고 면 고르기를 엶 · 좌우 뒤집기 끔) · `f_wrap` 을 함께 쓰면 그림 발에서 키 × 값 위(얼굴)는 줄이 머리 뒤로 지나감(입자 그림은 월드 좌표라 기준 높이를 `SkillVfxFaceLine` 이 렌더러마다 넣음) ③ 금색 3단 `s_ramp`(#테;#몸;#심;불투명도 배수;감싸기 밖 층 심 시작;모양 가장자리 테 굵기 픽셀) = 팩 메시 층 전부를 그림 G 채널(가장자리 0 → 가운데 1)로 테 → 몸 → 심 색칠 + 모양 가장자리를 따라 갈색 테(둘레 8곳을 더 읽음) — PD 「금줄에 맞게 캐릭터 주위 이펙트를 바꾸라고」 「캐릭터 아래층 이펙트도 캐릭터를 회전하는 이펙트와 동일하게 브라운 계열의 아웃라인」(화풍 층 먹선은 넣어 봤다가 뺌 · b_cel 빈칸 · 빛 번짐 두 층 s_off) ④ 높이 = `f_height`(오르는 속도 × k · 간격도 좁아짐 = 예약 기운 0.28) / `f_top`(오르는 입자 수명 × k · 속도·간격 그대로 그 높이에서 사라짐 = 재행동 0.4 · PD 「높이가 낮아지면서 나선형 간격이 너무 좁아짐」) — 둘 다 세운 메시 길이·세로로 긴 빛도 × k. 자체 제작 금줄(`SkillVfxSwirl`)은 PD 「이전 이펙트와 너무 달라짐」으로 삭제. 확인 도구 = `SkillVfxShots` 영웅 id 앞 `~`(예약 기운만 시각마다) · `+`(쏜 뒤 화면이 유닛을 따라감).
- **관우 청룡언월 · 공통 출혈(2026-11-11 PD 직접 지시 · 표 생성 도구 `Tools/skill_vfx_design.py` 의 관우·출혈 줄에 반영)**: ① 출혈(`status_bleed`) = 유닛 아래 층(n_order -14) · 머리 뒤에서 바라보는 쪽 위로 튀어나옴(기준점 `headside` = 머리 가운데 · f_dx 0.7 · f_dy 0.3 = 유닛 반지름 배수 · 지름 배수 0.95 = 덩이 대부분은 머리에 가려지고 가장자리의 튀는 조각만 실루엣 밖으로 — PD 「크기를 키우되 캐릭터 뒤쪽에 대부분을 가리면 · 좀 더 튀는 느낌」 — 키 배수로 두면 기병처럼 키 큰 유닛은 머리에서 멀어져 PD 「타겟이 된 몬스터와 다른 위치」 · 반복 이펙트의 `b_face` 1 = f_dx 를 유닛이 바라보는 쪽 기준으로 · 돌아서면 따라감 `SkillVfxFacing`) · 크기 이력 = 1.1 → 0.33(30%) → 0.4(+20%) → 0.95(뒤에 가리는 방식) · `b_nofall` 1 = 층은 그대로 두고 떨어지는 움직임만 끔(중력 0 · 아래로 가는 속도 0 — PD 「기존 프레임을 삭제하라는 지시가 아니라 낙하하는 이펙트만 제거」 · 처음엔 떨어지는 두 층을 통째로 꺼서 갑자기 사라져 보였음) ② 초록 초승달 고리(`Slash_magic_long`)는 한 번 반경에 맞춰 키웠다가 PD 「깨진 이미지 같은 느낌 · 톱니처럼 회전하는 이펙트는 제거」로 뺌 ③ 관우 둘레 이펙트 = PD 「유비처럼 하라는 뜻이 아니라 이펙트 표현 방법(아웃라인·텍스쳐 등)을 동일하게 · Simple Stylized Slash Pack 2 의 slash_aoe_a 로 교체」 → 베기 `TKS_Fx_Sk_Slash_Aoe_A`(blast · 크기 0.5 × 스킬 반경 · n_order -13 · 연기·섬광 층 s_off) — 금줄(`HCFX_Energy_03_v2_gold`) 행은 뺌. 원본 = `Assets/VFX/NamuFX`(에셋 스토어 패키지에서 그 프리팹이 쓰는 17개 파일만 `Tools/unitypackage_pick.py` 로 옮김 · WL 사본은 `wl_vfx_import.py` 판정 탈락 = 쓰지 않는 꼬리 재질 칸이 URP 기본 재질). 원본 Namu 셰이더 그래프는 이 게임 화면에서 하늘색 덩어리로 깨짐(깊이 읽기) → 표 `s_ramp` 가 재질을 `TKS/FxPackHalf` 의 모양 시트 방식(`_Mode` 1 = 흰 모양 플립북 시트 · 둘레를 읽어 테두리 → 몸 → 밝은 심 · 테 굵기보다 가는 조각은 몸 색 · `_Tiles` = 플립북 칸)으로 바꿔 그림(옥빛 `JADE_RAMP` = #테;#몸;#심;1;;테 1.8픽셀;심 깊이 16픽셀). 원본은 베기 10개가 0.04초 간격 · 세 축 무작위 회전으로 나오는 「난무」 구성 — 사본에서 회전을 땅과 나란하게 고정했더니 10개가 한 고리로 겹쳐 PD 「검기가 난무하는 이펙트가 보이지 않음」 → 고정을 풀고 원본 그대로 다시 사본(사본을 손대지 말 것). `s_ramp` 는 한 번 재생하는 행(cast·blast·hit)에서도 적용(`SkillVfx.SpawnPoint`·`Spawn` · 감싸기 `s_wrap` 은 반복 기운 전용) · 도구에 `ramp=` `height=` `top=` 인자와 `GOLD_RAMP` · `JADE_RAMP`. ④ 스킬 범위(PD 「관우의 스킬 범위를 슬링샷 이동 가능한 거리만큼 확장 · 캐릭터를 선택할 때 스킬 범위도 함께 보이도록」): `skill_effects.csv` 관우 aoe_strike p1 3 → 0 = 행동 반경(`SkillSystem.AoeRadius` · 창병 4.5 · 다른 광역 타격은 p1 그대로) · 선택 표시 `RangeIndicator` 에 금색 스킬 범위 원(`SkillSystem.ActiveRadius` = 광역 타격·광역 흡수·미인계·대상 range/aura/radius 효과 · 슬링샷 원과 반경이 같으면 0.09 바깥으로 띄워 두 줄).
- **장비 장판 일갈 · 공통 기절(2026-11-11 PD 직접 지시)** · 🔴 **PD 상시 지시 「앞으로 내가 말하지 않아도 우리 게임의 화풍에 맞게 이펙트를 보정해야 해」** = 팩 이펙트를 넣을 때는 묻지 않고 화풍 보정까지 한다 (지금 PD 가 고른 방식 = 유비·관우와 같은 표현 방법: 3단 색 + 짙은 테두리 `s_ramp` · 빛 번짐 층 끔 · 화풍 층 `b_cel` 은 작은 그림을 뭉개고 검은 먹선이라 유비·기절 별에서 PD 가 뺌): ① 영웅에게서 터져 나오는 기운 = Vol.2 `HCFX_Energy_10`(cast · 크기 배수 2.5 · 유닛 아래 n_order -13(= 정렬 -1 · **-12 는 유닛과 같은 0 이라 유닛 위에 그려짐**) · 0.7배속 · 가운데 줄기 높이 f_height 0.35 · `glow_floor` 끔) — PD 「잘 보이지 않음 → 더 키우되 캐릭터가 가려지지 않게 · 캐릭터를 중심으로 폭파되는 느낌 · 색 = 충격파와 같은 옐로우 계열 · 검은색은 너무 튀니 어울리는 색으로」 → 집중선과 같은 노랑 3단 `SHOUT_RAMP`(아홉째 값 = 팩의 새까만 층에 칠할 색 = 짙은 갈색 `_Ink`) · 겹쳐 가리던 먹 폭발 별(`FX_Explosion_P_1`) 행은 뺌 ② 방사형 집중선 2줄(`FX_splash_flash_air` · `_floor`) = 광역(blast) 행 + `s_radial` 0.45;1(반경 배수 · 중심에서 스킬 반경의 45% 부터 옅어져 반경 끝에서 투명 · 값은 렌더러마다 `MaterialPropertyBlock`) · 화풍 층 대신 노랑 3단 `SHOUT_RAMP`(화풍 층은 반투명을 단계로 끊음 · 검은 선도 짙은 갈색) · 유닛 아래(n_order -14 · -15) ③ `s_ramp` 여덟째 값 1 또는 `s_radial` = 메시가 아닌 띠·판 층도 재질 교체 · 셰이더 `TKS/FxPackHalf` 는 방식별 키워드(`_MODE_SHEET` = Namu 모양 시트 · `_MODE_DISSOLVE` = Element Splash `Fx_dissolve_particle_apb` 근사 · 없음 = HCFX apb) — 실행 중 분기(if) 안에서 그림을 여러 번 읽으면 셰이더 컴파일러가 죽어 전부 분홍으로 나옴(실측) · `editor_sync_compilation`(처음 쓰는 순간 하늘색 임시 그림 방지) ④ 기절(`status_stun` · Lana `Stun_loop`) = 큰 별 층 `stars_large` 가 「한 번 내는 층」이라 반복 규칙에서 꺼져 있었음 → `s_hold`(끝날 때까지 유지 = 수명 600초 + 수명 비율 곡선·꼬리 길이를 원래 초 단위로 당김 `SkillVfx.Hold`) · 각도 -25 · 끝 0.25초 흐려짐 · PD 「별의 형태가 너무 뭉개진 것처럼 보여」 → 화풍 층 뺌(b_cel 0 = 팩의 별 그림 그대로).
- 🔴 **스킬 이펙트 작업 인계(2026-11-11)** — 이펙트 작업을 이어받는 세션은 **`Tools/skill_vfx_노하우.md` 한 장을 먼저 읽는다**(PD 검수표 12항 · 작업 순서 · 화풍 맞추는 방법 고르기 · `s_ramp` 칸 순서 · 함정 · 새 표 기능 · 보고 방식) · 캡처 도구 = `Tools/vfx_capture/`(`go.sh` · `strip.cs` · `dump_layers.cs` … · 출력 `C:/Users/sw/AppData/Local/Temp/tks_vfx_capture`) · 완료 = 유비·관우·장비·조운·황충·제갈량 · 다음 영웅은 PD 가 지정 · 게임 레포 미커밋(PD 지시 때만). · 2026-11-12 주창 완료 + 시전(발동 예정) 패턴 13종 일괄 적용(`CAST_PATTERN` · `cast_<타입>()` · 노하우 문서 §0·§4·§5).
- **조운 단기구주(2026-11-11 PD 직접 지시)** · 🔴 **PD 상시 지시 「다음 행동 예약 형태의 스킬은 항상 이런 형태로 발동 예정 이펙트가 필요」** = 예약형(next_action) 스킬은 ① 예약 중 = 반복 가능한 구간만 끊김 없이 반복하는 「발동 예정」 이펙트(aura 행 · 한 번 재생하는 팩 이펙트는 `b_loopall`) ② 공격이 시작되면 뚝 끊지 않고 출발한 자리에서 자연스럽게 끝남(aura 의 `f_fade` 빈칸 = 방출만 멈추고 남은 입자가 제 수명대로 사라짐). 🔴 **교훈 2개**: (가) **이펙트를 잘못 골랐음** — PD 가 그림으로 지정한 것은 `HCFX_Energy_06`(바닥면이 빛나며 에너지가 솟아남)인데 썸네일만 보고 「모으기」 `HCFX_Charging_01_Step2`(도는 호 + 모여드는 구름)로 넣고 세 번을 고침 → PD 「이제보니 내가 지시한 이펙트가 아니었어 · 회전하는 형태의 엉뚱한 이펙트」. 그림으로 지정받으면 후보를 **시각별로 그려**(바탕색 RenderTexture · 팩 데모처럼 비스듬한 시점 · 직접 저장한 PNG 는 위아래를 뒤집지 않는다) 그림의 요소(바닥 빛 · 솟는 선 · 가시 · 연기 · 호)를 하나씩 대조하고, 고른 프리팹 이름과 대조 그림을 첫 보고에 함께 낸다. (나) **원본을 바꾸지 말 것** — PD 「폭풍처럼 강렬한 기운」을 방출 5배·겹쳐 쌓기·1.5배속으로 풀었다가 PD 「원본 이펙트가 재생되던 형태와 같은 연출을 바랬는데 재생 속도도 너무 빠르고 전혀 어울리지 않아」. PD 가 고른 팩 이펙트는 원본 재생 모습(구성·속도·방출량)을 그대로 두고 지적받은 것만 고친다(유비 때 「이전 이펙트와 너무 달라졌잖아」와 같은 지적). **현재 값**: ① 발동 예정 = `HCFX_Energy_06` 원본 한 벌 · 원래 속도 · `b_loopall`(1.5초 중 앞 0.75초만 방출하는 한 번 재생 → 반복 구간만 고르게) · `f_tilt` -30(팩 데모처럼 비스듬히 내려다본 각도 · 바닥 빛이 타원으로 깔림) · 크기 1.8(기준 크기 9.03 = 바닥 빛 지름이 유닛 키의 2배) · 색 묶음이 한 행에 하나라 **세 행**으로 나눔: 바닥 빛(`glow_view`·`glow_floor` · `FLOOR_RAMP` 짙은 파랑 → 하늘색 심 · 불투명도 2.2배 · n_order -16) / 연기(뿌리 층 · `CLOUD_FAINT` · 방출 0.6배 · -15 — PD 「먼지는 살짝만 보이게」) / 에너지(`power_floor` 바닥 가시 · `circle_ring` 호 = 유닛 아래 -14 · `power_up` 솟는 가시 = `s_wrap` 으로 앞 반만 유닛 위 · `line_up`·`particle_up` 솟는 선·알갱이 = `s_over` 로 유닛 위 · `ENERGY_RAMP` 흰 몸 + 밝은 파랑 테 1.2픽셀 · 불투명도 2배 — PD 「전부 캐릭터보다 낮은 레이어라 어떤 연출인지 잘 보이지 않아」). 한 묶음(하늘색)으로 칠하면 흰 가시가 파란 바닥 빛에 묻히고 · 가는 가시는 테두리 색이 대부분이라 테가 짙으면 전부 파랗게 보임(실측). **새 칸 `s_rate`**(층별 방출 배수 · 「층 이름*배수」 · `@root` = 뿌리 층 · 반복 이펙트 전용 · `SkillVfx.SpawnLoops` 가 반복으로 고르게 편 뒤에 곱함): 한 번 재생 이펙트를 반복시키면 방출이 한 주기 평균(가장 셀 때의 1/4 쯤)이 되어 솟는 선이 성김 → 솟는 선 3배 · 알갱이 2배 = 원본이 가장 셀 때와 비슷한 밀도(그 이상 올리지 않음) · 표 생성 도구 `R()` 에 `rate=` `wrap=` `over=` 인자. **공격 시작 순간에 바로 끝내기**: 예약 기운은 0.15초마다 맞추던 것이라 돌진하는 유닛을 따라가다 도착한 자리에서 꺼져 남았음(수명 1초인 바닥 빛에서 드러남) → `SkillSystem.BeginAction` 이 장착 직후 `SkillVfxLoops.RefreshNow()` 를 불러 출발한 자리에서 끝냄. ② 공격 = PD 「Game VFX - Cartoon Skill Collection(URP) 의 두번째 첨부한 창 이펙트 형태로 공격」 = `FX_Blast_Up` — **PD 「창 이펙트는 아주 좋은<ECA28B><EC9D80>
- **황충 백발백중(2026-11-11 PD 직접 지시)** · PD 4건: ① 「황충 스킬을 발동하면 Hyper Casual FX Pack Vol.1 의 첨부한 이펙트를 재생(기존과 동일하게 황충이 마법진 위에서 에너지를 방출하는 느낌)」 = `HCFX_MagicCircle_02`(조운 교훈대로 후보 `MagicCircle_01~04` 를 시각별로 그려 대조 — 02 = 연두 마법진 + 가시 장식 고리 + 솟는 선·알갱이) · 한 번 재생(2초)이라 예약형 상시 지시대로 반복 구간만: 고리 3겹(뿌리 층 · `magic_circle_center` · `magic_circle_inner`) = **`s_hold` 를 `b_loopall` 행에서도 쓰게 함**(`@root` = 뿌리 층 · 한 번 낸 입자를 끝까지 유지 · 안쪽 두 겹은 계속 돎 · 주기마다 다시 내면 깜박임) · 바닥 빛·솟는 선·알갱이 = `b_loopall` · 시작 순간의 고리 터짐·알갱이·연기 = 처음 1번만(`s_rate` 0) · 색 묶음이 행마다 하나라 **네 행**(바닥 빛 `LIME_FLOOR` -16 · 고리 `LIME_RING` -15 · 연기 `LIME_CLOUD` -14 · 기운 `LIME_ENERGY` -14 + 솟는 층은 `s_over` 로 유닛 위) · 기울기 -30 · 크기 1.9(기준 크기 5.0 = 바깥 고리 지름) · 끝 = 고리·바닥 빛은 0.3~0.4초에 흐려짐(`f_fade`). 🔴 **실측 함정**: 유지 층(`SkillVfx.Hold`)은 수명을 600초로 늘리는데, 셰이더로 넘기는 수명 곡선(Custom Data = 「나타나는 녹임」)을 같이 당기지 않으면 나타나는 동작이 10분에 걸쳐 진행돼 **고리가 안 보인다** → `Hold` 가 Custom Data 곡선도 원래 초 단위로 당김. ② 「황충 스킬이 적에게 화살이 날아갈 때 발생하는 먼지 이펙트는 제거(대신 황충 이동 시 최초 이동 때와 도착할 때 먼지 연출)」 → 먼지로 보이던 것 = 발사 순간 황충 둘레에 퍼지던 미색 줄기(cast `FX_Shoot_15_muzzle` 조준 고리가 화풍 층에서 미색 줄기로 보임) = cast 행 뺌 · 명중 자리의 돌조각·잔 알갱이(`FX_EarthSkill_Hit_air_02` 의 `rock` · `particle` 이 화풍 층에서 미색 덩어리로 보이고 화면 아래(황충 쪽)로 떨어짐) = 황충 blast 행에서만 끔(같은 이펙트를 쓰는 장비·허저·전위·맹획 hit 행에는 그대로 남아 있음 — PD 피격 일괄 변경 때) · 이동 먼지 = **새 이벤트 `depart`(실제 이동을 시작한 자리 1번) · `arrive`(도착한 자리 1번)** — `ActionResolver.ArcherRoutine` 의 실제 이동 구간에서만(`MoveFxBegin` · `MoveFxEnd` · 제자리 사격·스킬 사격에는 없음) · 감속 이동은 끝의 10 % 거리를 전체 시간의 1/3 동안 천천히 가서 이동이 끝난 뒤에 내면 0.4초 늦음(실측) → 목적지까지 남은 거리가 10 % 이하가 되는 순간 냄(`ArriveWatch` · 위치 = 화면에 보이는 자리) · 먼지 = 모든 유닛의 슬링샷 흙먼지와 같은 것(`s_style` dust). ③ 「황충의 기본 공격 화살이 백발백중 스킬에 사용한 화살과 동일한 투사체」 → **새 키 `hero_<장수 id>`**(`SkillVfx.HeroKey` · 스킬을 장착하지 않은 일반 행동에서 `basic_<병종>` 행에 더해짐 · 이동만 하는 행동 포함 · 장착 중에는 안 붙음 = 화살이 두 번 겹치지 않게) · `hero_huangzhong` 의 shot = 같은 자체 제작 화살 · 같은 크기(금빛 기운은 스킬에만) · depart·arrive 도 이 키. ④ 「황충 스킬 사용 시 Casual RPG VFX 의 두번째 첨부한 이펙트를 화살과 합쳐서 발사(화살에 강력한 힘이 담긴 연출)」 = `Projectiles_light`(후보 `Projectiles_*` 10종을 움직이며 그려 대조 — light = 흰 타원 머리 + 금빛 꼬리 + 반짝이 · 프리팹 앞 = +X → `b_flat` 1 + `b_face` 1) · shot 행 2개를 화살과 같은 자리에서 같이 날림: 금색 빛(뿌리 층 · `head_glow` · `ARROW_GLOW_RAMP` · n_order -1) / 흰 타원 머리 + 줄기 + 반짝이(`head` · `lines` · `flares` · `ARROW_HEAD_RAMP` · 0) · 화살은 그 위(1) — 한 행으로 칠하면 금색 빛 덩어리가 흰 머리를 덮어 밋밋한 노란 <20>
- **제갈량 칠성 기원 · 와룡의 가호(2026-11-11 PD 직접 지시)** · PD 「제갈량의 스킬을 시전하면 첫번째 첨부한 이펙트를 제갈량에게 한번 재생 · 이후 스킬 범위 내 유닛에게 두번째 첨부한 빛 덩어리가 내려와 퍼지는 연출과 함께 세번째 연출 이펙트가 효과 대상 유닛을 감싸며 1회 재생되며 회복 효과가 발생 · 패시브 효과는 턴이 종료할 때 대상 유닛들에게 세번째 이펙트가 한번씩 재생되며 회복 · 이펙트는 모두 Casual RPG VFX」 → 후보를 시각별로 그려 대조: 첫번째 = `Regeneration_health_area`(빛나는 연두 고리) · 두번째 = `Loot_drop`(위에서 내려오는 미색 빛 덩어리 → 0.4초에 닿아 퍼짐) · 세번째 = `Regeneration_health`(빛기둥 + 연기 + 십자 + 반짝이 + 바닥 고리). **순서**: 시전(cast · 제갈량 발밑 고리 + 십자·반짝이) → 0.3초 뒤 대상마다 빛 덩어리(**새 이벤트 `drop`** · `f_delay` 0.3 · **새 칸 `f_wait`** 0.7 = 효과를 적용할 시점) → 닿는 순간 회복 + 세번째 이펙트(heal 행). **코드**: `SkillSystem.Instant` 의 회복(`heal_atk`)이 `SkillVfx.Drop(대상들, 스킬 id)` 가 돌려준 시간만큼 기다린 뒤 회복(행이 없으면 0 = 예전과 같음 · 시뮬레이션은 기다리지 않음) · `Heal(u, 양, 회복시킨 유닛, fxKey, fxAlways)` = **heal 행을 스킬 id(액티브·패시브) 키로 두면 그 스킬의 회복은 공통(common) 이펙트 대신 그것** · 액티브는 범위 안 아군 전원에게(이미 가득 찬 유닛도 · fxAlways) · 패시브 `turn_end_heal_lowest` 는 `s.Passive.Id`(zhugeliang_p) 키로 실제 회복된 유닛에게만. **행 구성**(유닛을 가리지 않게 아래/위로 나눔): 시전 = 굵은 고리(`glow` = ring04 · 유닛 아래 -15) / 안쪽 구름(`shadow` · -16 · 반투명) / 십자·반짝이(유닛 위) · 가늘게 퍼져 나가는 고리(`circle`)는 끔(가는 선) · drop = 빛 덩어리·닿는 빛(`wave_up` · `flash` · `sparkles` · 유닛 위) / 바닥으로 퍼지는 빛(`glow` · 기울기 -30 · 유닛 아래) · heal = 바닥 고리 + 연기(유닛 아래 · 반투명 = 얼굴을 가리지 않음) / 빛기둥 + 십자 + 반짝이(유닛 위) = 유닛을 앞뒤로 감쌈. 🔴 **Casual RPG VFX 함정 3개(실측)**: (가) 이 에셋의 입자는 **스프라이트 방식**(층마다 스프라이트 1장 · 재질 그림 없음)이라 `numTilesX/Y` 는 남은 값일 뿐 — 그대로 칸 수로 쓰면 칸 경계마다 테두리가 그려져 **격자무늬 네모**가 됨 → 칸 수는 격자 방식일 때만(`SkillVfx.WrapAndRamp`). (나) 부드러운 빛 그림을 또렷하게 끊으면 빛 덩어리가 **가는 줄 두 개**만 남음 → `s_ramp` 열한째 값 = 모양 문턱 배수(크게 = 옅은 빛까지 모양으로). (다) 안쪽으로 옅어지는 빛 고리(ring04 = 흰색 + 알파에 모양)를 끊으면 **속이 찬 원판**이 됨 → `s_ramp` 열두째 값 = 모양 경계의 부드러움(0 = 또렷 · 1 = 원본의 번짐 그대로 · `_ShapeLo/_ShapeHi`). 확인 = 정지 화면(시전 0.08~1.05초 · 시험 장면에는 아군이 제갈량뿐이라 본인에게만) · 패시브는 표 행과 키 연결만 확인(화면에서는 못 봄) · 움직임 못 봄. **→ 2026-11-11 PD 추가 2건(위 값보다 이 줄이 최신)**: (1) 「떨어지는 빛줄기가 훨씬 더 빨리 떨어져야 · 좀 더 빛나는 연출이 들도록 라이팅이 적용」 → drop 행 재생 속도 2.4배(`f_speed` · 내려오는 데 0.42초 → 0.18초) · 시전 0.2초 뒤 시작(`f_delay`) · 닿는 0.38초(`f_wait`)에 회복 · 빛나게 = 같은 이펙트를 **팩 원본 재질 그대로**(빛을 더해 그리는 방식 · `s_ramp` 없음) 조금 크게 한 벌 더 깔아 빛 덩어리 둘레와 닿는 자리에 번지는 빛을 냄(그 위에 또렷한 미색 덩어리) — 🔴 「빛나는 · 라이팅」 요청은 3단 색으로 끊는 대신 원본의 더하는 빛을 한 벌 함께 <20>
- **표 칸 추가**: `b_cel` · `f_alpha`(원본 세기 배수 · 화풍 층에서는 낮추면 단색 면 대신 옅은 테 = 몸을 가리는 빛 기둥·막을 옅게) · `s_hue`(#RRGGBB 로 물들임 · 색상 = 그 색 · 채도·밝기 = 원본 × 그 색 · 무채색은 그대로 · 띄운 것에만 적용 = 사본을 늘리지 않음) · `f_sat` · aura·status 행의 `f_fade`(효과가 끝날 때 붙은 채 흐려져 사라짐).
- **실측에서 찾은 것**: ① 소프트 파티클 스위치 참조 이름이 셰이더마다 4가지(`BB495B7B` · `2FAC1FE4` · `52F3CBA5` · `9C0948F4`) — 하나만 끄고 있어 895개 중 258개(Kyeoms 폭발 전부 · 더하기 층 다수 · Element Splash)가 안 보였음 → `SkillVfx.DisableSoftParticles` 가 넷 다 끔 ② 반복(aura) 규칙이 「원래 반복인 층만 남김」이라 Lana `Orbs_*` 의 구슬 층(한 번만 터지는 층)이 꺼짐 → 그런 프리팹은 `b_loopall` 1 + `f_fade` ③ `prewarm` 입자는 띄우는 순간 원래 색으로 이미 만들어짐 → 색을 바꾼 뒤 껐다 켬(`Recolor`) ④ `FX_Blue Rune` 은 재질 색이 파랑이라 금빛을 넣으면 녹색 ⑤ 실측 크기는 「가장 많이 보이는 한 순간」이라 화살·집중선처럼 길게 뻗는 것은 실제보다 작게 잡힘(설계 파일 `size=` 로 보정) ⑥ MasterStylizedProjectiles 의 hit·muzzle(어두운 얼룩) · Lana `Shield_*`(불투명 도넛) · HCFX `Sign_*` · `Fire_cartoon_*`(유닛 아래에 두면 안 보임) · `Fireball01Orange`(화풍 층에서 청록 원뿔)는 이 게임에서 못 씀.
- **도구**: `Tools/fx_catalog.cs`(Assets/VFX 프리팹 895개를 게임과 같은 방식으로 RenderTexture 에 그려 옆모습·위에서 본 모습 그림 + 배율 1 실측 크기 `Tools/fx_catalog/catalog.csv` · 출력 폴더 = `Tools/fx_catalog_dir.txt`) · `Tools/fx_style_preview.cs`(에디터 정지 상태에서 원본/화풍 층 비교 그림 · 색 바꾸기·세기 포함) · `Tools/build_skill_custom_fx.cs` + `make_skill_custom_textures.py`(자체 제작 `TKS_Fx_C_ArrowRain` 손권 화살비 · `TKS_Fx_C_SwordWave` 주태 검기 · `TKS_Fx_C_ArrowShot`·`DaggerShot`·`ArrowStuck`·`DaggerStuck` 화살·비도 · 그림을 고치면 py → cs 순서로 다시 실행) · `Runtime/SkillTest/SkillVfxShots`(Play 중 `SkillVfxShots.Begin(폴더, "guanyu,zhangfei", "0.07,0.25,…", 한 변 픽셀, 화면 높이)` = 영웅을 차례로 골라 액티브를 발동하고 시각마다 주 카메라를 직접 그려 저장 · HUD 제외 · `Time.captureFramerate` 고정 간격 · 행동 중 탭 대기 스킬은 자동 입력 · 자체 품질 확인용).
스킬 이펙트 1차 + IB(쿠로네코) 연출 시험 — 돌진·조준 UI·타격감 (PD 2026-11-10) - 기본 공격(돌진) = IB 이펙트 그대로 시험: 앞 빛 물결 · 속도 꼬리(진영색 4색 · 멈춘 자리에서 0.12초 흐려짐) · WL 흙먼지 · 기준점 dash(아래로 갈수록 발 쪽) · 히트 이펙트 제거(PD 지정 대기) - 슬링샷 방향 결정 UI = IB GameTouchArrow 이식(IbAimArrow · IB 유닛 반지름 0.496 기준 비율) + 진행 중 캐릭터 연출(IbUnitMarks: 발밑 원 · 몸 빛 · 조준 중 속성 방울) · 값 표 Resources/Skills/ib_ui.csv - 기병: 복귀 영역(채운 원 · PreviewCavalryReturn) · 복귀 때 돌아서기(UnitView.TurnAround) - 타격감: HitFeel + CameraController.Shake · 표 hit_feel.csv(IB 흔들림 값은 디컴파일에 없어 추정값) - 액티브 스킬 1차 연출(Fable 제안 56 스킬 · 사본 Resources/Fx/TKS_Fx_Sk_*) · SkillVfx 확장(s_camp · f_fwd · f_drift · f_fade · s_over · b_flat · 트레일 페이드) · 셀화 셰이더 포트 - 2D 돌진 시험본(Dash2D · Aura2D test_aura) · 이전 시험 행은 skill_vfx.csv 에 # 주석 - 여포 크기: dz_boss_lvbu 몸 높이 819 → 718(깃털 제외 · 말 탄 유닛 머리 끝 상한 때문에 작아졌음) - 원본 = Assets/VFX/IB(쿠로네코 · GUID 유지 · Tools/wl_vfx_import.py --skip-scripts) · 사본 도구 Tools/make_ib_fx_copies.cs · make_ib_camp_textures.py · build_dash2d.cs - 테스트 PlayMode 118/118 통과 · 자동 재직렬화(png meta · UITheme · ProjectSettings) 제외 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 04:19:44 +00:00
- **크기 = 유닛에 맞춤(PD 2026-11-10)**: 혜성 머리 폭(진행 방향에 수직) = 유닛 키 × 1.3(그림 높이 ≈ 키 × 1.17 을 살짝 넘게) — 실측 머리 폭(배율 1.0) 파랑 2.34 · 주황 2.30 · 녹색 2.11 · 보라 2.05 단위 → `f_scale` 0.56 · 0.57 · 0.62 · 0.63 · 머리 중심 = 몸 앞 0.6 키(`f_fwd` · 유닛 아래 층이라 몸 위에 두면 그림에 가려짐) · 뒤쪽 Dash 0.4. 새 이펙트는 같은 방식으로 머리 폭을 재서 정한다(경계 상자 `bounds` 는 입자 시뮬레이션 범위라 실제보다 10배 큼 → 픽셀 측정).
- **색감 · 셀화(PD 2026-11-10 「게임 분위기와 안 맞음」 → Fable 검토 단독 권고 = 이식 셰이더 수정 · 원본 Master Stylized FX 빌트인 셰이더도 수식 동일)**: `TKS_HdrApprox.cginc` = 흰 섞임 상한 `TKS_HOT_MAX` 0.2 · 색 · 불투명도 3단계(`TKS_CEL_STEPS` · 불투명도 반올림 · 보강 `TKS_ALPHA_GAIN` 1.25) · `CommonMeshLoop` 뒷면 셸 = 같은 색 × `TKS_RIM_SHADE` 0.45(고정 갈색은 검은 얼룩으로 보여 바꿈) · 사본 프리팹 진영색 = 위 #3F7FD6 · 촉 #5FAE57 · 오 #E0633A · 군 #9A5BB5(원래 밝기 유지 · 흰 층 제외) · 발광 배수(CustomData Custom1.x) 1·2·5 → 1·1.3·2.
스킬 이펙트 작업 준비 — 스킬 테스트 씬 · WL 이펙트 이식 · 이펙트 표 · 보병·창·기병 슬링샷 공격 = WL 창 돌진 이펙트 시험(PD 2026-11-09) PD 「WL 프로젝트에서 스킬을 구현하던 방식과 동일하게 유닛 별 스킬 구현」 · 「테스트 목적: 보병, 창, 기병을 슬링샷으로 공격할 때 WL 창 돌진 공격 이펙트」 - 스킬 테스트 씬 Assets/Scenes/SkillTest.unity(SkillTestBootstrap · 메뉴 TKS/Skill Test/Build Scene): 영웅 목록 선택(heroes.csv 56) · 더미(죽지 않음 · 행동 토글 · 배치 표 Resources/Skills/skill_test.csv) · 슬링샷 · 액티브 버튼 · 쿨 무시 · 영웅 무적 · 이펙트 보기(에디터 · Assets/VFX 검색 → 영웅에 띄움) - 이펙트 표 Resources/Skills/skill_vfx.csv → Runtime/Skills/SkillVfx(키 = 스킬 id 또는 basic_<병종> · cast/travel/hit · f_every 반복 · 사본 Resources/Fx/TKS_Fx_*) · 훅 = SkillSystem Announce/BeginAction/EndAction/Hit/Instant - WL 이펙트 이식 Assets/VFX(약 640 MB · 빌트인 호환분만 · GUID 유지 · 도구 Tools/wl_vfx_import.py) · URP 셰이더 빌트인 이식 4종 Assets/VFX/_BuiltinPorts · com.unity.shadergraph 17.3.0 · 카메라 깊이 텍스처 켬(셰이더 그래프 소프트 파티클) - 시험: basic_infantry/spear/cavalry travel = TKS_Fx_SpearRush · SpearRushWrap · SpearRushDust(WL WLStaffEarth rushFx 1~3 값 환산) — 표 9행 삭제 = 원래대로 - 테스트 118/118 · console error 0 · 이 PC 첫 임포트 자동 재직렬화(png·tga .meta · UITheme · ProjectSettings · InputManager)는 제외 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 14:12:52 +00:00
- **이펙트 사본 규칙(WL `WL_Fx_*` 와 같음)**: 게임이 읽는 것 = `Assets/Resources/Fx/TKS_Fx_<이름>.prefab` 사본만(메뉴 `TKS/VFX/Make Skill Fx Copy` · 고른 프리팹 → 사본) · 원본 팩 `Assets/VFX/**` 는 고치지 않는다.
- **WL 리소스 옮기기** = `Tools/wl_vfx_import.py`(scan · copy · unpack · `--wl <WL 루트>` · GUID 유지 · URP 전용 셰이더 재질 프리팹은 자동 제외 · WL 원본 무수정) → 에디터 새로고침 → 메뉴 `TKS/VFX/Check Imported VFX`(분홍 재질 · 빠진 스크립트). 판정 표 = `Assets/VFX/_wl_import_report.csv`. 2026-11-09 옮긴 것 = VFX_Klaus(Hyper Casual 1·2 · Shoot&Hit 1·2 · Earth Skills · Element Splash 3) · Lana Casual RPG VFX · Slash Effects FREE · EricWang 4묶음 중 빌트인 통과분 · MasterStylizedProjectiles 통과분 · Kyeoms 폭발 · GAP 툰 투사체(빌트인 패키지 unpack) · WL 창 돌진 사본 3(`Assets/VFX/WL/`) = 약 640 MB.
- **URP 셰이더 이식판** = `Assets/VFX/_BuiltinPorts/*.shader`(원본과 같은 GUID · 셰이더 이름 · 속성 → 옮겨 온 재질이 그대로 사용 · 현재 Eric AdditiveFlow · AlphaBlendFlow · MasterStylizedFX EmissiveParticle · CommonMesh2Side). 새로 필요한 URP 셰이더는 같은 방식으로 이식하면 `wl_vfx_import.py` 가 통과(port)로 본다.
- **카메라 깊이 텍스처 켬**(`GameBootstrap` · `SkillTestBootstrap` `depthTextureMode |= Depth`): Hyper Casual 등 셰이더 그래프의 소프트 파티클이 `_CameraDepthTexture` 를 읽음 — 없으면 이펙트가 안 보이거나 불투명 하늘색 덩어리(2026-11-09 실측). 셰이더 그래프 재질은 `com.unity.shadergraph 17.3.0`(Built-In 타깃) 필요.
## 유닛 아트 반영 (다른 세션의 원화·애니 → 이 게임)
- 아트 위치 = `Assets/Resources/Units/<art>/<clip>/f000.png …` + `meta.json`(fps · ppu · pivot(발) · charHeightPx · clips). `<art>` 는 `BalanceConfig.asset` 의 `heroes[].art` / `stages[].enemies[].art`(비면 도형). 아군 = `liubei`·`guanyu`·`zhangfei`·`zhaoyun`·`huangzhong`(2026-11-04 재디자인 원화 · 스켈레탈 B단계 전까지 front_idle 정지 1장 · 납품 후 리그 v2 12 클립으로 교체) · 적 = `<세력>_<병종>`(`hgj_infantry` …) · 보스 = `<세력>_boss_<로마자>`(`hgj_boss_zhangjiao` …).
- 스켈레탈 리그 → 프레임: 조직 레포 스킬 `skeletal-anim-pipeline/files/scripts/rig_frames_export.py rig <리그 패키지> --parts <작업>/parts --out Assets/Resources/Units/<art> --clips back_idle,back_ready,back_action,back_damage,back_stop,front_idle,front_ready,front_action,front_damage,front_stop,front_victory,front_failed --px 180 --step 2`(ComfyUI venv python · 실측 482×470 · 15 fps · 3인 11 MB).
전투 로직 #1080 — 알까기 충돌(보병) · 관통·아군 직전 정지(기병) · 밀며 함께 전진(창병) · 밀린 아군 공격 기회 · 궁병 제자리 사격(사거리 = 슬링샷)+접근 20 % · 궁수 근접 피해 50 %/피격 +50 % · 원화 1차·2차 반영(전장 배경 + 황건적 5 + 동탁군 4) · 테스트 22/22 - ActionResolver 전면 재작성: InfantryRoutine(접촉점 정지 · Push 접촉 방향 × collisionPushRatio · 적이면 공격+반격 뒤 밀림) · SpearRoutine(앞 유닛과 같은 속도로 함께 전진 · 접촉 간격 유지) · CavalryRoutine(벽만 막음 · StopBeforeUnclearedAllies) · ArcherRoutine(AttackRange = 슬링 · ArcherMoveAllow = 슬링 × archerRangeRatio) · PushedAllyAttack(규칙 ⑤ · ActionOutcome.Pushed/Notes) - Combat: Damage(melee) 궁병 근접 배율(근접 유닛 상대만) · FirstUnitOnPath · TouchingOpponent · FreeTravel ignore - BalanceConfig/Defaults: archerMeleeDealtRatio 0.5 · archerMeleeTakenRatio 1.5 · collisionPushRatio 1 · boardArt battlefield_01 (자산 재시드) - Board: Resources/Board/<boardArt> 원화 배경(격자·진영 띠 생략) · UnitArtImporter Board 규칙 · GameBootstrap - Resources/Units: hgj_infantry·spear·cavalry·archer·boss_zhangjiao · dz_infantry·spear·cavalry·archer (원화 세션 납품 정지 그림 · rig_frames_export static) · Resources/Board/battlefield_01.png - BattleManager Describe 「밀어냄 · 밀린 B → 적 공격」 · BattleHUD 궁병 줄 · 테스트 22종(신규·개정 7 + 원화 확인) · CLAUDE.md · README Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-11-04 06:56:02 +00:00
- 정지 그림(적 SD 전신 `_rgba.png`) → `rig_frames_export.py static <png> --out Assets/Resources/Units/<art>`(front_idle 1장 · 발 = 불투명 상자 아래). 원화 세션 납품 = `C:\ArtRnD\samguk_game\manifest.json` · 파일명 `<art>_rgba.png` → `<art>` 폴더(2026-11-04 1차 `hgj_*` 5종 + 2차 `dz_infantry·spear·cavalry·archer` 반영 완료 · 여포 `dz_boss_lvbu`·`cc_*`·`wei_*` 는 납품 시 같은 명령).
- 전장 배경 = `Assets/Resources/Board/<boardArt>.png`(자산 `boardArt` · 5:8 불투명 · PPU 100 = 전장 20×32) → `Board.Build` 가 있으면 바닥으로 쓰고 격자·진영 띠는 생략. 임포트 규칙(스프라이트 · 4096 · 압축)은 같은 `UnitArtImporter` 의 `Board/` 분기 · 재임포트 메뉴가 두 폴더 처리.
- 임포트 설정은 `Editor/UnitArtImporter.cs`(AssetPostprocessor · meta 의 pivot·ppu) 가 자동 적용 · 프레임을 넣거나 meta 를 바꾼 뒤 = 메뉴 `TKS/Reimport Unit Art`(Build/BuildFresh 가 함께 호출).
- 재생 = `UnitArt.cs`(Resources 로더 · 캐시) + `FrameAnimator`(대기 loop · 준비 = 조준 중 · 공격·피격 = 1프레임 자세 유지 후 대기 · 승리 = 끝 프레임 유지). **포즈 규칙(PD #1084 · 2026-11-05)**: 공격 애니 대신 1프레임 포즈 전환 — 조준(당기는) 중 = `ready`(출발 자세) · 슬링샷 이동(돌진) 중 = `action`(병종 돌진 포즈 · `UnitView.SetCharging` · `ActionResolver.Resolve` 가 루틴 전후로 켜고 끔) · 멈추면 `idle`. 돌진 중 피격은 색만 바뀜. **4방향 보기(PD #1082)**: `UnitView.SetFacing(dir)` — 마지막 이동 방향의 세로 성분으로 `back_*`(위 ↖↗) / `front_*`(아래 ↙↘) 세트를, 가로 성분으로 `flipX`(왼쪽 = 반전 · 오른쪽 = 기본)를 정한다. 시작 = 아군 ↗ · 적군 ↘. `ActionResolver.Face()` 가 이동·튕김·밀림·돌진·사격·밀린 아군 공격 때 호출(기병 복귀는 방향 유지). 없는 클립은 다른 보기 → 대기로 대체. 세로 크기 = `unitArtHeight`(자산) × 반지름 배율 · 발 = 원 중심 아래 0.55 R.
## 구조 (README 와 동일)
- `Assets/Scripts/Runtime/` — `GameBootstrap`(씬 구성) · `BattleManager` · `ActionResolver` · `Combat` · `SlingshotInput`(조작·스크롤·줌) · `RangeIndicator`(사거리 원·궁병 도넛) · `CameraController`(넓은 전장 카메라) · `EnemyAI`(교전 범위) · `BattleHUD`(HUD·미니맵) · `Unit`/`UnitView` · `UnitArt`(아트 로더·`FrameAnimator`) · `Board` · `Fx` · `AutoPlayDriver`
- `Assets/Scripts/Editor/` — `ProjectSetup`(CLI 진입점·씬 생성) · `BalanceDefaults`(최초 시드) · `StageImporter`(스테이지 표 → 자산) · `UnitArtImporter`(아트 임포트 설정) · `DataImporter`(아웃게임 표 → 자산 · 화면 캡처)
아웃게임 2차(PD #1093 세션 C) — 내정(훈련·순찰·개발) · 보물(수집품·세트·상자) · 연무장(탑·일일 던전·투기장·적장 토벌) · 거래 상자 탭 + 영웅 56명 확장(PD #1096 · 신규 effect_key 4) - 데이터: C 표 10장(training · training_ranks · patrol · dev_tree · treasures · treasure_sets · chests(+iron/buy 열) · tower · dungeons(+reward_amount) · arena(+상점 키)) + economy.csv C 키 24 → 임포트 18 자산(OutGameTables.C.cs 검증: 행·연속 Lv/랭크/층·참조·확률 합 1·선행 노드·효과 키 처리기·카운터 키 · 오류 시 자산 불변) - 영웅 56명: heroes 71 · skills 112 · hero_gear 1344 · gacha_pool 71 재복사 · 신규 키 4(team_dmg_pct_turn · cooldown_add · charm · heal_self_pct) + 기존 키 조건 열(받는 피해 p2 HP 임계/보스/근접 · p3 출전 인원 아군 전원 · 최대 HP·반격 아군 전원 · 피해 % 발동 턴) · 대장군 키는 표 미사용(처리기 유지) - 내정: 훈련(병종 5 · 3항목 Lv · cost_mult · 랭크 승급 · train_bonus → §3-2 항목별) · 순찰(챕터 행 × 시간 · 오프라인 · 상한 12h + 농업 · 소수점 이월 · 광고 2배 스텁 · 즉시 수확 보옥) · 개발(갈래 3 · 선행 · 골드·도면 비용 · 효과 키 → 군량·보상·상점·순찰·상자 적용 지점 · 초기화 보옥 + 도면 환급) - 보물: 보유 중(4열 · 등급 색 · 상세·강화) · 세트(단계 효과) · 상자(포인트 → 명장 · 확률 · 중복 조각) · 효과 hp/atk/def → HeroRules · crit/range/splash → BattleManager.SideEffectsProvider → SkillMods · 조건 카운터 8종 = Runtime/BattleEvents(전투 코드 Raise 1줄씩 · 아군만) · 스테이지 청동 상자 10 % - 연무장: BattleManager.StartMode(BattleMode = 적 편성·제한 턴·onExit) · 탑 100층(입장권·층 배율·보상·10층 상자) · 던전 3(요일·2/일·보상) · 투기장(샘플 10 · EnemyAI 방어 · 메달·주간 순위·조각 상점) · 적장 토벌(주간 순환·hp ×20·5턴·누적 피해·명장 상자·천기) · 결과 패널 → 탭 = 연무장 - 거래: 상자 탭(구매 = 골드/보옥/포인트 · 거래 할인) · 패스·월정액·챕터 팩·첫 결제 팩 = 준비 중 스텁 · 스킬서 임시 판매 제거(사당 던전) - 테스트 87/87(기존 73 유지 · 갱신 3 = 로비 탭 · 표 키 목록 · 상점 스킬서 칸 / 신규 14 = OutGameCTests 12 + 확장 키 2) · console error 0 · 캡처 = DataImporter.CaptureC Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 15:22:54 +00:00
- `Assets/Scripts/OutGame/` — 아웃게임(세이브·로비·영웅·편성·거래·보상 · 내정 `Domestic/` · 보물 `Treasure/` · 연무장 `Arena/` · 위 「코드 규칙」)
- `Assets/Data/Stages/` — 챕터·스테이지 표 CSV 4장(위 「코드 규칙」) · 해석·배치 = `Runtime/StageTable`
- `Assets/Resources/Units/<art>/` — 유닛 아트 프레임 + meta.json(위 절)
스킬 시스템(PD #1093 세션 B) — skills.csv effect_key 51종 처리기 · 액티브(예약/즉시)·패시브 · HUD 스킬 버튼 · 적 무장 패시브 · 스킬 레벨업·스킬서 - 데이터: SkillInfoDb(= 스킬 DB) 에 effect_key·p1~p3(pMask)·lv_scale·needs_impl 추가 · 임포터 검증(trigger · 키 51종 · p 칸 · skill_levels 연속 · lv_max) · skill_levels = levels(비용 표) - 처리기 Runtime/Skills: SkillKeys(51종 · 레벨 계수 = 값×계수 / 배율은 1 넘는 몫 / 횟수 반올림 / 켜기·치환 고정 · 팀 키) · SkillDef·SkillCatalog · SkillSystem(유닛별 쿨·예약 · 즉시형 시한 효과 이번 아군 턴/이번 적 턴 · 행동 훅 · 호위 분담 · HUD 한 줄) · SkillMods(전투 코드 수치 질의) · SkillRules(상한 = 등급 + ★3 액티브 +1 · ★5 패시브 ×1.5 = evolve.csv · 레벨업 · 스킬서 판매) - 전투 연결: ActionResolver(밀기·튕김·추가 이동 n·추가 이동 공격·충돌 추가 피해·밀며 전진 ×·삼첨도·관통 피해/넉백/반격 없음/빗나가도 복귀/한 번 더 관통·사거리·사선 통과·크리·광역 반경/비율/아군 0·백기습영 이동 후 사격·군령/대장군 공격 횟수) · Combat(상성 하한·공 %·주는/받는 피해·근접 패널티 해제·반격 배율/받는 반격·견제 배율) · BattleManager(편성·적 무장 부착 · 견제 반경/횟수/무제한/회복 · 교전 반응 정지 · 교전 범위 · 즉시형 실행) · EnemyAI·RangeIndicator(슬링·사거리 스킬 반영) - UI: HUD 스킬 버튼(이름·Lv·쿨·사용 가능/불가·패시브) · 탭 = 예약/취소/즉시 · 조준 중 2손가락 탭 · 발동 = 이름 글자 + 플래시 · 스킬 한 줄 · 예약 배지 · 변진 반경 원 · 영웅 상세 스킬 레벨업 팝업 · 거래 상점 스킬서 칸(임시) - 표: economy.csv start_skill_books 10 · skill_book_shop_daily 3 · skill_book_price 300(임시 · PD 확인) - 테스트 73/73(기존 56 + SkillTests 17 · 51종 전부) · console error 0 · 캡처 = DataImporter.CaptureSkills Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 14:31:27 +00:00
- `Assets/Scripts/Runtime/Skills/` — 스킬 처리기(위 「코드 규칙」 스킬)
지형 기믹 레이어(PD #1097 세션 D) + 병종 규칙 개정 2건 · 예측 시뮬레이션 적 AI(PD #1098) - 데이터: Assets/Data/Gimmicks/{gimmicks,stage_gimmicks,tutorial_tips}.csv + Assets/Data/AI/ai_weights.csv(기획 tables/ 사본) → 메뉴 TKS/Import Gimmicks(검증 · 오류 시 자산 불변) → Resources/Gimmicks/GimmickDb(16)·StageGimmickTable(16 + 팁 3) · Resources/AI/AiWeights(32) - 레이어: GimmickLayer(전투 시작 = 스테이지 배치 · 배경 위 유닛 아래 · 원/사각/다각 · 색 도형 + 글자 · 내구 핍 · 강 콜라이더 = 다리 구간 제외 · 겹친 유닛 보정) · 장애물 = 병종별 내구 피해·튕김·창 목책 밀기·바위 굴림·기병 정지 · 투사체 pass/block/destroy · 폭약 광역(아군 포함)+밀기+불 · 책사 광역 덤불 제거 · 강 낙하 - 지대: 경로 스윕(독 1→2→3 % · 늪 ×2 · 불 10 % · 빙판 미끄러짐 · 고지 · 안개 · 군기 · 함정) · 양 진영 턴 시작 훅 - 규칙 개정: 보병 튕김 중 다른 적과 연쇄 1회 · 창병 반작용(spearRecoilRatio · 밀며 전진 폐기) · 기존 테스트 기대값 갱신 - 적 AI: Runtime/AI(Sim 가상 실행 · TacticalAI 후보·점수·난이도·턴 운영 · 1부 보스 액티브) · 조준선 = 가상 실행 예상 궤적·기믹 반응·지대 띠 · TKS/Gimmick Painter · 캡처 GimmickImporter.Capture - 검증: 컴파일 0 · 플레이모드 113/113(신규 26) · console error 0 · 적 10기 턴 결정 62 ms Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 16:20:07 +00:00
- `Assets/Scripts/Runtime/Gimmicks/` — 지형 기믹 레이어(위 「코드 규칙」) · `Assets/Scripts/Runtime/AI/` — 예측 시뮬레이션 적 AI(`Sim` · `TacticalAI` · `AiWeights`)
- `Assets/Data/Gimmicks/` · `Assets/Data/AI/` — 기믹 표 3장 · AI 가중치 표
- `Assets/Tests/PlayMode/` — `BattleFlowTests` · `OutGameTests` · `SkillTests` · `OutGameCTests` · `GimmickTests` · `TacticalAITests` · `UILayerTests`(캔버스 층·아틀라스 구조 · 2026-11-10 · 전체 119) · `ArenaHubTests`(연무장 허브 · 2026-11-18 · +1)
- `.claude/skills/` — Unity CLI 에이전트 스킬(`unity skill install claude-code --local` 산출물 · 재설치는 `unity skill refresh`)