146 lines
122 KiB
Markdown
146 lines
122 KiB
Markdown
# 삼국지 슬링샷 (가제) — 에이전트 작업 지침
|
||
|
||
> 너드나비스 조직 프로젝트 ⑤ (조직 레포 `.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`)
|