ThreeKingdomsSlingshot/CLAUDE.md

146 lines
122 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

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

# 삼국지 슬링샷 (가제) — 에이전트 작업 지침
> 너드나비스 조직 프로젝트 ⑤ (조직 레포 `.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` 인덱싱 예외는 무해).
### 에디터가 닫혀 있을 때 (배치 · 재현 가능한 실측)
```
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차(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장).
- **영웅 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`.
- **병종 규칙 개정 + 예측 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`(없으면 길 위 균등).
- **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장 배치를 고칠 때 이 값으로 계산할 것.
- 규칙 해석 변경 = `Assets/Scripts/Runtime/ActionResolver.cs`(병종 4종) · `BattleManager.cs`(턴·승패·창병 대기) · `Combat.cs`(피해 공식·경로 질의). 변경 시 `Assets/Tests/PlayMode/BattleFlowTests.cs` 에 테스트 추가 후 22종 이상 전부 통과 확인.
- 콜라이더 질의 전 `Physics2D.SyncTransforms()` · 유닛 제거는 `SetActive(false)` 후 `Destroy` · 자식 렌더러가 있는 표시물은 GameObject 통째로 끈다.
- **궁병 규칙(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+비율) 채워진 붉은 도넛 · 범위 안 적이 없으면 회색).
- 보고는 실측·추정·미확인을 분리한다(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`) · 남이 돌리는 사본에 미러하지 않는다(실행 중 코드가 바뀜).
## 스킬 이펙트 작업 (2026-11-09 PD 「WL 에서 스킬을 구현하던 방식과 동일하게 유닛별 스킬 구현」 · 이 PC = 연출 담당)
- **작업 착수 규칙(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`).
- **이펙트 값 = 표 `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 「궁병이 이동과 동시에 공격하지 못하게 · 보병이 아군과 닿아 튕겨서 추가로 적을 공격 · 여러 번 공격 · 기병과 창병이 지금보다는 더 밀려야」)**: ① **원거리 = 제자리 사격만**: 사거리 = `LaunchDistance × (1 + archerRangeRatio)` = 10.8(이동 범위 7.2 밖까지 제자리에서 쏜다 · 붉은 도넛 = 이동 범위 밖 ~ 사거리) · 조준 방향 사거리 안에 적이 있으면 제자리 사격, 없으면(사거리 밖 · 방향이 안 맞음) 쏘지 않고 목표점까지 이동만 · 다가가 쏘기(`ArcherMoveAllow` · `ShotPlan.Approach` · `SlideBeforeShot`) 삭제 · 책사도 같은 규칙(#1087 ⑤) · 백기습영 같은 스킬의 이동 후 사격은 그대로. ② **보병 튕김 연쇄 여러 번**: `Bounce(…, int chain)` = 남은 연쇄 횟수(`bounceChainMax` 6) · 적과 싸운 뒤 튕겨 나가다 닿은 유닛이 적 = 다시 공격 후 튕김 · 아군 = 밀어내고 **그 아군에게서도 다시 튕김**(그 전 = 연쇄 1회 · 아군이면 밀기만 하고 정지) · 같은 적과 다시 부딪힐 수 있다 · 다음 충돌은 앞서 밀린 유닛이 멈춘 뒤에 계산 · 아군을 처음 친 경우(밀기)는 5차까지 연쇄 없음 → 6차에서 같은 연쇄로 바꿈(아래). 밀림 가중치는 상대가 밀리는 거리에만 곱하고 보병이 튕기는 거리에는 들어가지 않는다(테스트 `Infantry_HitsEnemy…` 가 창병 상대로 확인). ③ 창병·기병 `pushTakenRatio` 0.6 → 0.8. **6차(2026-11-17 PD 「아군을 친 경우에도 연쇄로 튕겨져 공격하거나 아군을 더 미는 등의 행위가 발생되어야 · 플레이어가 기대한 패턴대로 동작하지 않으면 복잡성이 증가」)**: 보병이 처음 닿은 유닛이 아군이어도 `Bounce` 에 `bounceChainMax` 를 넘긴다 — 아군을 밀고 튕겨 나가다 닿은 유닛이 적 = 공격 후 다시 튕김 · 아군 = 더 밀고 다시 튕김(적을 먼저 친 경우와 같은 규칙 하나) · 테스트 `Infantry_FirstHitAlly_…` 2종.
- **조준·턴 표시(PD 2026-11-16 2차)**: 방향 화살표 = 유닛·체력 바 위(`order_arrow` 10 — 같은 날 −6 으로 내렸던 것을 되돌림) · **손 조작 중에는 화살표만** 보인다(`SlingshotInput.ShowAim`) — 맞을 유닛의 주황 강조 · 예상 궤적(노란 점선) · 화살 경로선 · 광역 원은 `ShowPreview`(자동 플레이 캡처·테스트용)에만 남음 · **쏜 행동이 끝나면 다음에 행동할 아군을 자동 선택 + 화면 이동**(`FocusNext` · 방금 유닛이 또 행동할 수 있으면 그 유닛 · 아니면 편성 순서로 다음 · 즉시형 스킬 연출 뒤와 학습 판 잠금 안내 중에는 안 옮김) · 전원 행동 시 자동 적 턴은 원래 구현(`BattleManager.AllPlayersActed`) 그대로 — 스킬로 얻은 추가 이동만 남았을 때만 빈 곳 탭으로 넘긴다.
- **여포 크기(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` 는 스킬 확장 없이 남음(대기 유닛이 없어 실행 안 됨).
- **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) · 몸 둘레 모이는 빛 = 파란 조준 고리와 같은 범위(`attack_ready_scale` 1.39 = 고리 반지름 1.335 / 빛 0.96 실측) · 유비 재행동 고리 = 0.55 · 올라가는 고리(circle_up)만 유닛 위. 테스트 씬 「☠ 죽음」 = 영웅을 가장 가까운 적의 공격으로 강제 사망(무적·부활 무시) → 1.5초 뒤 패배 판정.
- **액티브 스킬 연출 본작업(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 「창 이펙트는 아주 좋은데」** (에셋 스토어 패키지에서 `Tools/unitypackage_pick.py` 로 옮김 → `Assets/VFX/Eric VFX Studio` · 재질 셰이더는 이식판 `_BuiltinPorts` AdditiveFlow · AlphaBlendFlow 와 같은 GUID 라 그대로 동작 · 후보로 함께 옮긴 `FX_FireCharge` · `FX_Blast` · `FX_Blast_Ground` 는 미사용) · 사본 `TKS_Fx_Sk_FX_Blast_Lance` = `Tools/build_blast_lance.cs`(원본 창은 팩 세계에서 150° 로 비스듬히 날고 중심이 원점에서 벗어남 → 빈 뿌리 아래에 돌려 넣어 창끝 = +X · 창 가운데 = 원점 · 표 `b_flat` 1 + `b_face` 1 이 +X 를 돌진 방향으로) · 창 층(cannon 아래)은 travel 행(유닛 아래 n_order -13 · `b_sustain` 1 = 돌진 내내 · 끝나면 자연 소멸) · 터지는 층(Bomb 아래 = 고리·날카로운 섬광·파편 / 연기)은 cast 두 행(출발한 자리에 남음) · 빛 번짐 층(`lb`·`lb (2)`·`shield`·`shock`·`Flare`·`Glow_b`·`glow`·`wind`·`aura_sl`) 끔 ③ 화풍 보정 = Eric 재질(더하기로 그리는 불꽃 그림)용 **밝기 방식** `_MODE_LUM`(`TKS/FxPackHalf` · `SkillVfx.PackTexProp` 이 셰이더 이름 `Eric/URP_` 로 판별): 그림 밝기 × 알파 × (재질 밝기 × 색 세기)를 문턱으로 끊어 또렷한 모양 → 몸 색 → 밝은 심(`s_ramp` 다섯째 값 = 심이 시작되는 밝기 · 빈칸 0.7) + 둘레 테두리 · 흐르는 그림(리본·고깔)은 재질의 흐름·반복 값을 그대로 · 플립북이 아니면 칸 자르기 끔 · 창 색 = 은백·하늘색 `SILVER_RAMP`(발동 예정 이펙트의 파란 기운과 같은 계열 — 장비 때 PD 「충격파와 같은 계열로 맞춰」 · 원본 주황 불색으로 되돌리려면 travel·cast 행의 묶음만 바꿈). ④ PD 「피격 된 적에게 발생되는 이펙트도 제거(추후 피격 이펙트는 일괄 변경할 예정)」 → 조운 hit 행 2줄(`Double_Slash` · `HCFX_Hit_01`) 뺌(다른 영웅의 hit 행은 그대로 — PD 일괄 변경 때). 기병 기본 돌진 이펙트(촉 녹색 빛 물결 · 흙먼지)는 예전대로 함께 나옴. 잘못 넣었던 사본 `TKS_Fx_Sk_HCFX_Charging_01_Step2` · `_Step2_End` 는 Resources/Fx 에 남아 있음(미사용). **→ 2026-11-11 PD 추가 3건(위 값보다 이 줄이 최신)**: (1) PD 「이펙트는 아주 마음에 들어 · 색감이 너무 쨍한 원색 계열 · 색상을 톤다운 하거나 라이팅을 조금 부여해서 부드러운 색감 · 특히 바닥에 깔리는 원형 이펙트 색상이 문제」 → 바닥 빛 `FLOOR_RAMP` = `#6F9FE0;#8EBFF5;#E3F1FF;1.8;0.55;;;1;;0.4`(몸 색 채도 82 % → 42 % · 불투명도 2.2 → 1.8배) + **`s_ramp` 열째 값 = 색 단 경계 폭**(빈칸 0.12 · `SkillVfx.RampSoft` · 0.4 = 테 색 → 몸 색 → 심 색이 띠로 끊기지 않고 가장자리에서 가운데로 부드럽게 밝아짐 = 빛이 번지는 느낌) · 솟는 기운 테두리 `#5AA9F5` → `#7FB4EA` · 더 옅은 안(몸 `#A6C8F0` · 1.5배)은 회색 안개처럼 빠져 버려 기각(실측) · 창 색은 그대로. 🔴 **이펙트 색 기준(PD 상시 지시 「말하지 않아도 화풍에 맞게 보정」에 더함)**: 넓게 깔리는 면(바닥 빛 · 큰 원)은 원색(채도 80 % 안팎)을 쓰지 않는다 — 채도 40~50 %의 파스텔 + 경계 폭 0.4 로 부드럽게 · 이 게임 배경은 따뜻한 황토색이라 진한 원색 면이 혼자 튄다. (2) PD 「조운의 스킬 발동 후 찌르기 이펙트가 몬스터보다 레이어 순서가 하단에 있어서 어색해 · 공격 이펙트는 몬스터보다 상단에 배치」 → **새 칸 `b_lift`**(`FxOwnerLift`): 이펙트를 다른 유닛 위(`n_order` -2 이하 = 유닛 그림 0 · HP 바·이름 2~6 보다 위)에 그리고, 이펙트가 살아 있는 동안 쓴 유닛의 그림만 그 위(`SortingBase - 1` = 11)로 올렸다가 이펙트가 사라지면 되돌림(실측: 끝난 뒤 순서 0 · 남은 올림 0) — 적은 덮되 쓴 캐릭터는 가리지 않음 · 조운 창 travel = -2 · 출발 자리 고리 = -3 · 연기 = -4(셋 다 `b_lift` 1). 🔴 **공격 이펙트는 몬스터 위**가 PD 기준 — 다른 영웅의 돌진·찌르기 이펙트를 만들 때도 유닛 아래(-13 이하)에 두지 말 것. (3) PD 「모든 유닛의 슬링샷 이동 시 발생하는 흙먼지 이펙트 가장자리도 검은색 보다는 좀 더 부드러운 브라운 계열」 → 화풍 층의 먹선 색은 판 하나에 하나라 흙먼지만 따로 못 바꿈 → **새 칸 `s_style`**(화풍 층 변형 이름 · `b_cel` 1 인 유닛 아래 이펙트 전용) + `fx_style.csv` 의 **「키@변형」 줄**(`ink_color@dust` `#96683C` · `ink_tint@dust` 0) · `FxStyleLayer` 에 변형 판 1장 추가(층 번호 27 · 기본 아래 판과 같은 순서 · 조금 멀리 놓아 먼저 그려짐 · 변형은 한 번에 하나) — 흙먼지 행(`TKS_Fx_SpearRushDust_sand`)만 `s_style` = dust · 다른 화풍 층 이펙트의 먹선은 그대로(먹색). 확인 = 정지 화면(발동 전 1장 · 공격 0.16 · 0.30초) · 움직임은 못 봄. **→ 2026-11-11 PD 「좀 더 창 찌르기와 유사한 색상으로」(이 줄이 최신)**: 바닥 빛 `FLOOR_RAMP` = `#7CC8FF;#8AD0FF;#F6FCFF;1.8;0.55;;;1;;0.4` — 테 = 창 몸 색 `#7CC8FF` 그대로 · 몸 = 한 단 밝게(반투명이라 황토색 바닥과 섞여 짙어지는 만큼) · 심 = 창 심 색 · 솟는 기운 테두리 `#74C0F7` · 실측(캡처 색 재기): 창 몸 `#7CC8FF` ↔ 바닥 빛 `#80C9FB`(직전 값은 `#66A9E9` 로 더 짙고 파랬음). 한 스킬 안의 이펙트 색은 캡처에서 색을 재서 맞춘다(표 값이 같아도 반투명 면은 바닥색과 섞여 다르게 보임).
- **황충 백발백중(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) — 한 행으로 칠하면 금색 빛 덩어리가 흰 머리를 덮어 밋밋한 노란 타원이 됨(실측) · **`b_clear` 를 shot 행에 주면** 도착하는 순간 한 번 낸 입자(반복 아닌 층 = 수명 5초짜리 머리·빛)를 바로 지움(줄기·반짝이는 제 수명대로) · 화풍 보정 = Casual RPG VFX(Lana Studio · `Mobile/Particles/Additive` · `Alpha Blended`) 재질도 밝기 방식 `_MODE_LUM` 으로(`SkillVfx.PackTexProp`). 확인 = 정지 화면(발동 전 0.15 · 1.2초 / 발사 0.05~0.6초 / 일반 슬링샷 제자리 사격 / 이동만) · 움직임과 「이동 후 사격」 장면은 못 봄 · 시험 도구 `SkillVfxShots` 에 `>` 접두어(적이 없는 쪽으로 일반 슬링샷 = 이동만 · 파일 이름 `<id>move`) 추가. **→ 2026-11-11 PD 추가 지시(위 값보다 이 줄이 최신)**: (1) 「황충의 스킬 시전 이펙트를 좀 더 화풍에 맞게 · 화풍과 다르다고 느껴지는 이유 = 너무 샤프한 느낌의 선으로 구성 된 느낌 · 아웃라인을 더 부드럽게 · (매듭 장식 층 그림) 위 레이어는 제거해」 → 마법진 고리를 **굵고 둥근 3단 그림으로 다시 구운 사본** `TKS_Fx_Sk_MagicCircle_Bold`(`Tools/bake_magic_circle_bold.py` 가 팩 그림의 알파를 굵히고 잔 틈을 메운 뒤 번져서 다시 끊어 뾰족한 끝을 둥글게 → `Assets/VFX/TKS2D/MagicCircleBold_04·02.png` · G 값 = 바깥 0(테) 에서 몸 0.45 까지 서서히 오르고 원래 선 자리 = 1(밝은 심) · `Tools/build_magic_circle_bold.cs` 가 재질·사본을 만듦) · 굵히기만 하면 얽힌 장식이 굵은 선 뭉치가 되어 지저분함(실측) → 틈 메우기로 단순한 덩어리 + 안쪽 밝은 무늬 · 뿌리 층(네 귀퉁이 매듭 장식 + 십자 가시)은 PD 지시로 뺌(`s_off` `@root` · 유지 층 = `magic_circle_center` 겹고리 + `magic_circle_inner` 호) · `LIME_RING` = `#7CAB3A;#A9D856;#ECF8AE;1.3;0.6;;;1;;0.3`(테 색 = 짙은 초록 대신 중간 초록 · 색 단 경계 폭 0.3 · 불투명도 배수 1.3 = 윤곽이 딱 끊기지 않게 · 테두리는 그림에 구워져 있어 테 굵기 칸은 비움). 🔴 **기준**: 팩의 가는 선 그림(마법진·문양)은 이 게임 화풍과 안 맞는다 — 굵고 둥글게 다시 굽고 아웃라인은 짙은 색으로 딱 끊지 말고 몸 색으로 번지게. (2) 「황충 스킬에 피격 시 발생하는 이펙트를 제거(피격 이펙트는 추후 일괄 수정 예정)」 → blast(충격 별) · hit(박힌 화살) 행 뺌. (3) 「화살의 크기도 너무 작아(스킬 컨셉이 매우 거대한 화살로 피격 판정도 키워서 먼 거리의 적도 맞추기 쉽게 하기 위함)」 → 스킬 화살 길이 = 유닛 키 × 2.3(폭 = 피격 판정 지름 1.0 쯤 · 반지름 0.5 = `skill_effects.csv` p1) · 금빛 기운 크기 4.4 · `f_fwd` 1.0 을 shot 행에서도 씀(`SkillVfx.Shot` = 출발할 때만 진행 방향 앞에서 시작 · 긴 화살의 꼬리가 황충 뒤로 튀어나오지 않게 · 날아가며 0 으로 줄어 도착점은 그대로) · 기본 공격 화살은 0.9 그대로. (4) 「스킬로 발사 된 투사체의 이동 거리도 늘려야 해」 = PD 「스킬로 발사 된 투사체가 황충의 기본 공격 사거리 밖으로도 날아가야 한다는 뜻」 → 원인 = 실제 화살은 사거리와 무관하게 벽·첫 적까지 날아가는데(먼 적 9.4칸 실측 명중) **조준 미리보기**(`ActionResolver.PreviewShot`)가 일반 사격 계획(`PlanShot` = 기본 사거리 · 접근 이동)을 그려 사거리 밖 적은 안 맞는 것처럼 보였음 → 거대 화살을 예약했으면 실제와 같은 궤적으로(`TraceGiant` 를 발사 `GiantArrow` 와 미리보기 `PlanGiant` 가 같이 씀 · 쏘는 자리 → 첫 적 또는 벽 · 맞을 적 강조). 🔴 다른 특수 사격(관통 · 폭발 · 부채꼴 · 선풍 · 목책 · 불 장벽)의 미리보기는 아직 일반 사격 계획을 그림(실제 동작과 다를 수 있음 · 미수정). 시험 도구 `SkillVfxShots` 에 `^` 접두어(적을 위로 6칸 옮긴 뒤 스킬 · 첫 장에 조준 미리보기 · 파일 이름 `<id>far`). 확인 = 정지 화면(발동 전 0.15 · 1.2초 / 발사 0.04~0.5초) · 움직임은 못 봄. **→ 2026-11-11 PD 「스킬로 발사되는 화살이 강력한 느낌이 나도록 강조 된 연출 · 화살이 너무 꾸며지지 않은 것 같아 · 예시와 같은 느낌」(예시 = 흰 화살촉 + 흰빛 심이 든 금빛 몸통 + 긴 금빛 꼬리 · 이 줄이 화살 연출의 최신)**: 나무 화살 + 금색 타원(Projectiles_light 의 빛 덩어리·흰 타원 머리) 대신 **자체 제작 「힘 실린 화살」 `TKS_Fx_C_PowerArrow`**(`Tools/make_power_arrow_textures.py` → `Tools/build_power_arrow.cs` · 그림 `Assets/VFX/TKS2D/pw_arrow` · `pw_comet` · `pw_trail`): 빛나는 화살(게임 화살 그림의 선·무늬를 살리고 색만 금·흰색으로 — 모양만 따서 흰색으로 채우면 깃이 네모난 덩어리로 보임 · 실측) + 화살 앞쪽을 감싼 물방울 기운(금 → 노랑 → 흰빛 심 · 가장자리는 주황으로 번짐 · 촉 끝은 기운 밖으로 조금 나옴) + 뒤로 길게 가늘어지는 꼬리 3겹(TrailRenderer · 주황금 0.20초 · 노랑 0.15초 · 흰빛 0.10초 = 날아가는 속도만큼 길어지고 도착하면 줄어들며 사라짐) + 옆 줄기 2개 · 🔴 **그리는 순서 함정**: 이 게임 카메라는 `TransparencySortMode.CustomAxis`(같은 순서 값 안에서는 세로 위치로 정렬)라 한 사본 안의 층 순서를 z 값으로 정할 수 없음(위로 쏘면 뒤쪽의 기운이 화살을 덮음 · 실측) → 같은 사본을 **세 행**으로 나눠 `s_off` 로 층을 고르고 `n_order` 를 따로 줌(꼬리 -1 · 기운 0 · 화살 1 · `s_off` 는 TrailRenderer 층도 끔). Projectiles_light 는 뒤로 흩날리는 줄기·반짝이 층(`lines` · `flares`)만 함께 날림(-1). 확인 = 정지 화면(먼 적 9.4칸 · 0.08~0.8초) · 움직임은 못 봄. **→ PD 「황충 스킬의 투사체 이동 속도를 30% 빠르게」**: 새 칸 `f_fly`(shot 행의 비행 속도 배수 · 빈칸 1 · 여러 행이면 가장 큰 값 · `SkillVfx.Shot` 의 비행 시간 ÷ 배수 = 피해 시점도 그만큼 빨라짐) = 1.3 (실측: 9.4칸 밖 적에 0.56초 안에 명중 · 예전 0.67초).
- **제갈량 칠성 기원 · 와룡의 가호(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단 색으로 끊는 대신 원본의 더하는 빛을 한 벌 함께 쓰는 것으로 푼다. (2) 「제갈량의 기본 공격 투사체를 Casual RPG VFX 에셋의 첨부한 스크린샷과 같은 투사체로」 = `Projectiles_dark_magic`(보라 타원 + 옥빛 앞머리 + 붉은 줄기 + 전기 조각) → `hero_zhugeliang` 의 shot 세 행(보라 빛 -1 · 붉은 줄기+반짝이 0 · 옥빛 머리+전기 조각 1 · `b_clear`) · 🔴 **함정**: 이 프리팹에는 입자 층이 아닌 **TrailRenderer 자식 `trail_shadow`**(보라 꼬리)가 있어 층 목록(입자 기준)에 안 나옴 — 세 행이 모두 그리면 세 겹으로 겹쳐 명중 뒤 짙은 보라 잔상이 0.2초 남음(실측) → 보라 빛 행에만 남기고 나머지 행은 `s_off` 로 끔 · `SkillVfx.Shot` 의 `b_clear` 는 반복 아닌 층을 지우면서 그리기도 끔. 확인 = 정지 화면(스킬 0.30~0.80초 · 기본 공격 0.06~0.45초) · 움직임 못 봄. **→ PD 기본 공격 투사체 3건(이 줄이 최신)**: 「크기가 너무 커 · 황충의 기본 공격 화살을 참고해서 크기를 줄여줘」 = 크기 1.9 → 0.95(보라 머리 길이 약 0.6칸 · 꼬리까지 합쳐 황충 기본 화살 길이쯤) · 「고리 앞쪽(머리 부분)에 튀어나온 이펙트를 제거」 = 옥빛 앞머리(`head` · 보라 타원 앞으로 튀어나오던 초승달 모양) 끔 · 「피격 후 이펙트도 제거」 = **shot 행의 `f_life`**(도착한 뒤 이 초만 남기고 통째로 지움 · 0.01 = 꼬리·줄기·반짝이도 명중 뒤 남지 않음 · `SkillVfx.Shot`) · 명중 자리의 분홍 원은 이 이펙트가 아니라 책사 광역 범위 표시(`Fx.Burst` · 게임 코드)라 그대로 둠. **→ PD 「크기가 줄어들고 이펙트 앞쪽 머리를 제거하자 투사체가 탁해진 느낌 · 수정 전 상태에서 크기만 줄일 수 없어?」(이 줄이 기본 공격 투사체의 최신)**: 옥빛 앞머리(`head`)를 되살림 = 수정 전 구성 그대로 크기만 0.95 (보라 타원만 남으면 밝은 곳이 없어 탁해 보임 — 「튀어나온 이펙트 제거」를 앞머리로 해석한 것이 틀렸음) · 테두리는 화면 픽셀 굵기라 작아진 만큼 1.2 → 0.8 · 명중 뒤 통째로 지움(`f_life` 0.01)은 유지. 🔴 이펙트를 줄일 때는 구성(층)을 건드리지 말고 크기만 — 밝은 층을 빼면 탁해진다. **→ PD 「머리 부분은 안보이게 할 수 없어?」(이 줄이 기본 공격 투사체의 최신)**: 옥빛 앞머리(`head`)는 끄고, 탁해지지 않게 보라 몸을 밝고 또렷하게 — `DM_SHADOW` = `#5636C8;#8462FA;#DDF4FF;1.4;0.5;0.8;;1;;0.25;2;0.15`(몸 가운데 = 옅은 옥빛 · 불투명도 1.4배 · 가장자리 번짐 0.45 → 0.15 · 가는 보라 테두리 0.8) · 🔴 탁해 보이던 원인 = 반투명하게 번지는 보라가 황토색 바닥과 섞임(밝은 앞머리가 가려 주던 것) → 층을 빼면 남은 층을 불투명·밝은 심으로 보강한다. **→ PD 기본 공격 투사체 교체(이 줄이 최신)**: 「지금 제갈량의 기본 투사체는 잠시 보류하고 Stylized Shoot & Hit Vol.1 의 FX_Shoot_05 투사체로」 → `Projectiles_dark_magic` 세 행은 표 생성 도구에 주석으로 보류(사본은 Resources/Fx 에 남김) · FX_Shoot_05 는 PD 「네가 변형한 투사체가 너무 불덩이 같은 느낌이 들지 않아(파이어볼 컨셉) · 어떻게 해야 불덩이 같은 느낌을 살릴 수 있을까?」 = 원본 그대로는 황토색 바닥에서 하얗게 날아가고 · 화풍 층은 작은 모양에서 검은 테두리에 탁하고 · 3단 색으로 바꾸면 불꽃 그림이 얇은 조각으로 끊김(실측 · 사본 `TKS_Fx_Sk_FX_Shoot_05_projectile` 은 미사용으로 남음) → PD 「아니면 Game VFX - FireSkill Collection(URP) 의 FX_Fireball_Bullet 로 대체하는 것도 고려」 = **이것으로 정함** (`Tools/unitypackage_pick.py` 로 패키지에서 옮김 → `Tools/build_fireball_bullet.cs` 가 사본 `TKS_Fx_Sk_FX_Fireball_Bullet` · 조운 창과 같은 제작사라 밝기 방식 화풍 보정이 그대로 맞음 · 앞 = +X): `hero_zhugeliang` shot 두 행 = 불꼬리(`fire` 2겹 · `fire_real` · `FIRE_TAIL` 주황 + 노란 심 + 붉은 가장자리 · 불투명도 2.2배 · n_order 0) / 불덩이 몸(`ball` · `FIRE_BALL` 노랑 + 옅은 심 + 주황 테 · 1) · 회색 연기(`smoke`) 끔 · 크기 0.4(기준 크기 1.2 = 몸 지름) · `f_life` 0.01. 🔴 **불덩이로 읽히는 조건**: 둥글고 꽉 찬 밝은 몸 + 몸(노랑) → 꼬리(주황 → 붉은 가장자리)의 색 변화 + 진행 반대쪽으로 끌리는 불꼬리 · 값 함정 = 심이 시작되는 밝기를 낮게 두면 몸 전체가 미색으로 하얗게 되고(0.6 → 0.9) · 원본 불꽃이 반투명(0.47)이라 불투명도를 올려야 바닥에 안 묻힘. 새 선택 값 = `s_ramp` 열셋째 값 1(더하기 재질도 3단 색으로 · `SkillVfx.RampAdd` · 지금 쓰는 행 없음). 확인 = 정지 화면 · 움직임 못 봄. **→ PD 「원본 에셋과 다르게 구체가 너무 튀는 느낌 · 원본 에셋과 같이 색상의 그라데이션도 부족한 느낌」(불덩이 색의 최신)**: 테두리 선을 없애고 색을 밝기에 따라 셋으로 잇는 **3색 그러데이션**을 밝기 방식에 추가 (`s_ramp` 열넷째 값 = 테 색이 끝나는 밝기 · 빈칸 = 끔 · 셰이더 `_LumRimOn/_LumRimLo/_LumRimHi` · 어두운 가장자리 = 테 색 → 몸 색 → 밝은 곳 = 심 색 · 켠 행만 적용돼 조운 창 등 기존 행은 그대로) · `FIRE_TAIL` = `#A82414;#FF661A;#FFC83A;2.4;0.78;;;1;;0.4;0.7;0.45;;0.62`(붉은 가장자리 → 주황 → 노란 심 · 문턱 배수 1.6 이면 불꽃 전체가 한 색으로 뭉쳐 0.7 로) · `FIRE_BALL` = `#FF8E22;#FFC636;#FFE884;1;0.75;;;1;;0.45;0.8;0.55;;0.35`(구슬 = 불꼬리의 밝은 쪽 색 · 테두리 없음 · 가장자리 번짐 = 불꽃의 심으로 녹아듦). 🔴 원본이 부드러운 빛 덩어리인 이펙트(불·빛)는 테두리 선 3단보다 테두리 없는 3색 그러데이션 + 번지는 가장자리가 원본에 가깝다. **→ PD 「불덩이의 구체를 숨기거나 주변 불과 동일한 색상으로 바꿔서 형태를 인지하지 못하게 · 구체가 보이지 않고 무늬가 없는 매끈한 느낌이 좀 더 깔끔」(불덩이 구성의 최신)**: 구슬(`ball`) 행을 뺌 = shot 한 행(불꽃 `fire` 2겹 + `fire_real` · `FIRE_TAIL`)만 · 두 방법을 캡처로 비교: 같은 색으로 칠하면 납작한 노란 원판이 불꽃 위에 떠 보여 모양이 그대로 읽힘(메시 구슬은 윤곽이 딱 끊겨 번지게 할 수 없음) → 숨기는 쪽으로 · 불꽃만으로 둥근 머리가 됨 · 구슬 행은 도구에 주석으로 남김. **→ PD 「원본과 같이 그라데이션 색상도 적용 · 꼬리쪽으로 갈수록 짙은 색이 되도록」(불덩이 색의 최신)**: 원본 불꽃 그림(`Fire_00002` · 4x3)에 밑동 노랑 → 주황 → 끝 붉은색이 이미 그려져 있고 밑동이 머리 쪽이라 **색을 입히지 않고 원본 그림 색 그대로** 씀 — `s_ramp` 의 색 칸 셋을 모두 비우면 색 입히기를 끄고(`_Ramp` 0) 원본 그림 색 × 재질 색·밝기(`_LumTint`)로 그림 · 모양은 밝기로 부드럽게 따고(열두째 값 0.6) 불투명도 배수만 적용(2.4 · 셰이더가 색을 안 입히는 행에도 배수를 씀) · `FIRE_ORIG` = `;;;2.4;;;;1;;;1;0.6` · 3색 그러데이션(`FIRE_TAIL` · 열넷째 값)은 이 행에서 뺌(기능은 남김). 🔴 원본 그림에 색 변화가 그려진 이펙트(불꽃)는 3단 색으로 다시 칠하지 말고 원본 색을 그대로 — 더해 그리던 것을 덮어 그리는 방식으로만 바꾸면 황토색 바닥에서도 원본 색이 나온다.
- **표 칸 추가**: `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` 고정 간격 · 행동 중 탭 대기 스킬은 자동 입력 · 자체 품질 확인용).
- **크기 = 유닛에 맞춤(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_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).
- 정지 그림(적 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`(아웃게임 표 → 자산 · 화면 캡처)
- `Assets/Scripts/OutGame/` — 아웃게임(세이브·로비·영웅·편성·거래·보상 · 내정 `Domestic/` · 보물 `Treasure/` · 연무장 `Arena/` · 위 「코드 규칙」)
- `Assets/Data/Stages/` — 챕터·스테이지 표 CSV 4장(위 「코드 규칙」) · 해석·배치 = `Runtime/StageTable`
- `Assets/Resources/Units/<art>/` — 유닛 아트 프레임 + meta.json(위 절)
- `Assets/Scripts/Runtime/Skills/` — 스킬 처리기(위 「코드 규칙」 스킬)
- `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)
- `.claude/skills/` — Unity CLI 에이전트 스킬(`unity skill install claude-code --local` 산출물 · 재설치는 `unity skill refresh`)