ThreeKingdomsSlingshot/CLAUDE.md

122 KiB
Raw Blame History

삼국지 슬링샷 (가제) — 에이전트 작업 지침

너드나비스 조직 프로젝트 ⑤ (조직 레포 .claude/skills/너드나비스-코어룰/rules/P38.md §P38-3 ⑤). 새 세션은 조직 레포 공유/인계서/삼국지슬링샷_인계서.md → 이 파일 → README.md 순서로만 읽고 시작한다. 조직 규칙 본문 전수 읽기 금지(C10-1).

프로젝트 정보

  • Unity 6000.3.23f1 · 2D · 빌트인 RP · 레거시 Input(activeInputHandler: 0) · Portrait · 패키지 = 기본 모듈 + com.unity.ugui 2.0.0 + com.unity.test-framework 1.6.0 + com.unity.pipeline 0.10.0-exp.1(2026-11-04 P38-7 적용).
  • git = 이 폴더가 레포 루트 · main · 원격 origin = https://burning.i234.me/NerdNavis_AiDev/ThreeKingdomsSlingshot.git(비공개 · 2026-11-09 · 다른 PC 와 함께 작업 = 시작 전 git pull · 커밋 후 git push). 미추적 = Library/ Temp/ Logs/ UserSettings/ obj/(Unity 표준 .gitignore · Pipeline 포트 파일 Library/Pipeline/.unity-pipeline-port 도 그 안).
  • 기록 = 조직 레포 공유/대화로그/삼국지슬링샷/ · 인계서 공유/인계서/삼국지슬링샷_인계서.md · PD 지시 로그 #1077.

에디터 제어 = Unity 공식 CLI + com.unity.pipeline (P38-7)

기본 호출은 MCP 가 아니라 셸에서 unity … 직접 호출이다(Unity 공식 권장 · 토큰 적음). unity 명령은 PowerShell 로 호출하되, C# 코드에 큰따옴표가 들어가는 eval 류는 Bash 도구로(K-DEV-026). 에디터가 둘 이상 열려 있으면 --project-path E:\Nerdnavis\ThreeKingdomsSlingshot 또는 환경 변수 UNITY_PROJECT_PATH 로 대상을 지정한다(K-DEV-024).

에디터가 열려 있을 때 (PD 플레이 중 반복 수정)

unity status --project-path .                 # ready 확인(포트·PID)
unity recompile --project-path .              # 수정 후 재컴파일 · 컴파일 오류 0 이어야 통과
#  ※ 2026-11-13 실측(CLI 1.0.0-beta.8): `unity recompile` 은 「unknown command」 → `unity command --project-path . script recompile` 뒤 `script recompile_status` 를 completed|up_to_date 까지 폴링
#  ※ `unity status` 가 빈 표여도 에디터가 떠 있을 수 있다(같은 날 실측) → `unity command --project-path . editor status` 또는 Unity.exe 프로세스로 확인한 뒤 Assets 를 쓴다 · C# 이 긴 eval 은 `script eval --file <.cs>`
unity command --project-path .                # 등록된 명령 목록(콘솔 읽기 · 메뉴 실행 등)
unity command --project-path . <명령> [인자]  # 명령 실행 · --result-only 로 JSON 만
unity command --project-path . test run --mode playmode --async-tests --timeout 600 --result-only   # 열린 에디터 안에서 테스트 시작(비동기 필수 · Play 진입의 도메인 리로드가 동기 요청을 끊음)
unity command --project-path . test status --result-only                                            # 끝날 때까지 10초마다 폴링 · test list / cancel 도 있음
#  ※ `unity test <proj> --mode PlayMode` 는 자체 배치 인스턴스를 띄우므로 에디터가 열려 있으면 거부된다(2026-11-04 실측 「이미 열려 있습니다」)
unity close . [--force]                       # 에디터 종료(저장 없이 종료 · PD 가 연 에디터는 닫지 않는다)
  • 작업 전에 unity command --project-path . editor status --result-only 로 playMode 를 본다. PD 가 Play 중(playing·paused)이어도 기다리지 말고 unity command --project-path . editor.playmode stop 으로 Play 를 중단 → stopped 확인 → 바로 작업한다(PD 지시 2026-11-04 · 2026-11-09 재확인 「내 PC 가 플레이 중이더라도 중단하고 작업해」 · 에디터 자체는 닫지 않음). 수정을 모두 끝낸 뒤 리컴파일 1회(편집 중 자동 새로고침으로 잠깐 컴파일 오류가 보일 수 있음). 열린 에디터가 있으면 배치 실행은 Temp/UnityLockfile 로 막히고, PD 가 연 에디터는 닫지 않는다 → 검증이 급하면 Assets·Packages·ProjectSettings 만 복사한 사본 폴더(예 E:\Nerdnavis\_tks_verify)에서 배치 실행(2026-11-04 실측 · 새 Library 임포트 포함 수 분).
  • 수치 자산에 새 필드를 넣었으면(예 art · archerRangeRatio) 기존 BalanceConfig.asset 에는 비어 있다 → 자산이 git 에서 미수정이면 메뉴 TKS/Reset Balance Defaults(= BuildFresh)로 재시드 · PD 가 Inspector 로 손본 흔적(git diff)이 있으면 재시드 금지 · 필드만 보충.
  • 판정 = 컴파일 오류 0 + 콘솔 error 0(Unity 자체 SearchDatabase 인덱싱 예외는 무해).

에디터가 닫혀 있을 때 (배치 · 재현 가능한 실측)

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)