122 KiB
삼국지 슬링샷 (가제) — 에이전트 작업 지침
너드나비스 조직 프로젝트 ⑤ (조직 레포
.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 CS0 · 테스트 XMLfailed="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.assetm_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.csvstart_*). 고친 뒤 메뉴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.pySKILL_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.csvC 키 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 116종 견본 평상시·상태 변화). - 지형 기믹 그림(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) · scatteredge/edge_sprite(가장자리 소품) ·obj_layer ground(물결 = 다리 아래) ·jitter/flip/obj_a· stripsprite3개 = 왼끝;가운데(반복);오른끝(녹각 목책) +shadow· 안개 = 구름 덩어리 흩뿌림 + 책사 광역 반경 덩어리만 사라짐(GimmickView.ClearPuffs). 견본 캡처 =-gimmickCatalog proto(크기 변형 · 상태 · 전투 배율 + 유닛). 3차(남은 9종 · 2026-11-11 · 16종 전부 그림 방식 · 굽기(zone) 줄 0): stripsprite_v= 세로 구간 마디(위끝;가운데;아래끝 · 폭 = 모양 폭 · 세로만 늘려 이음 없이 · 8-6 세로 성벽) · patchsprite_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/ SessionStateTKS_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 수·generalsid:병종: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/<맵>.jsonslots_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.csvgimmick 행이 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_configdrag_lock_*— 화면 아래쪽 유닛은 끝까지 당길 자리가 모자람) · 남은 턴 칩 · 안내가 가리키는 함정 보이기(1-7) · 결말 카드(첫 클리어) · 실패 카드(매번) · 편성 화면 안내before_battle= 편성 화면이 열렸을 때 다음에 깰 판 기준 · 보스 판 =BossIntro가 끝난 첫 아군 턴에boss_intro_end) ·TutorialGuideUI(루트 캔버스 정렬 460 →FxFrame(어둡게 덮개 · 테두리 · 손가락) ·InfoEvent(띠 · 카드 · 남은 턴 · 누름 막이) · 띠·카드는 대상을 덮지 않게 위·아래 자리 바꿈) ·MatchupMarks(조준 중 적 머리 위 유리 ▲ 초록 / 불리 ▼ 붉은색 ·matchup_mark_chapter·_stage부터 모든 판). 메모리 세이브(자동 테스트 · 검증 캡처)에서는 학습 판이 꺼진다(TutorialRules.ModeAuto — 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(남은 거리, 슬링 최대 ×collisionSelfBounceMinRatio0.5) ×collisionSelfBounceRatio1(2026-11-10 PD 「튕기는 거리가 너무 짧다 · IB 체크」 · 전에는 남은 거리 × 0.5 → 적 바로 앞을 겨누면 남은 거리 ≈ 0 이라 튕김 0.45 · 지금 약 2.2 실측 · IB = 이동 거리가 당김과 무관한 캐릭터 고정값 + 부딪히면 남은 거리를 전부 가진 채 반사ActiveSkillSlingShot.ResolveCollisions) · PD #1081) · 기병 = 유닛 무시 관통(적 피해 · 아군은 지나칠 거리가 안 나오면 그 아군 직전 정지StopBeforeUnclearedAllies) · 창병 = 첫 유닛을 크게 밀치고 자신은 적게 밀림(남은 거리 ×spearPushRatio1.5 · 반작용 = 그 ×spearRecoilRatio0.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.csUiRate): 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 에서도 묶임 ·EditorSettingsm_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) 규칙 = WLWLStaffEarth.Rush와 같게(2026-11-09 PD 「돌진하는 동안 이펙트가 정상적으로 안 보임」 수정):b_sustain1 = 시간당 방출 층을 반복으로(한 번 띄워 돌진 내내 유지 · 다시 띄우면 0.1~0.2 s 만에 끊김) ·b_clear1 = 행동 끝에 남은 입자까지 지움(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/DashBegin5곳). 튕김 · 밀기 · 반작용 = 반응이라 이펙트 없음. -
이중 레이어(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_fade0.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(IBGameTouchArrow동작 · 프리팹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 「당겼다 놓기 · 반대로 가는 화살표가 어렵다」 → 뒤로 당기기 폐기): 아군 유닛을 누른 채 유닛 밖으로(반지름 ×
aimStartRadiusRatio1.2) 끌면 끄는 쪽으로 화살표가 뜨고(끈 거리는 방향만 정함 · 유닛 → 손가락) 그때부터 게이지가 차오른다(순환형 = 가득 차면 0 부터 다시). 손가락을 유닛 원 안으로 되돌리면 화살표·게이지가 사라지고 놓아도 발사 없음 = 스킬 사용 가능 · 다시 끌면 게이지는 0 부터(PD 2026-11-16 5차 ·SlingshotInput.AimActive— 켜는 거리와 끄는 거리가 달라 경계에서 깜빡이지 않음). 놓으면 그 방향으로 최대 거리 × 놓는 순간의 게이지(최소minDragDistance)만큼 이동·공격 · 끌지 않거나 손가락을 유닛 위로 되돌려 놓으면 발사 없음. 수치 =BalanceConfig.unitStats[].gaugeCycleSec(한 번 차는 시간 · 보병 1 · 기병 0.8 · 궁병 0.5 · 창병 1 · 책사(= PD 표현 「승병」) 0.6) ·aimGaugeCritFrom0.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_scale0.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_width1.3(길이와 따로 · 4차 「좌우가 넓어지면」). 학습 판 = 손가락 안내가 목표 쪽으로 끔(TutorialDirector.DrawDrag) ·drag_lock_min_pull0(잠금 끌기 = 방향만 맞으면 게이지와 상관없이 정해진 세기로 발사) ·finger_pull_ratio0.5. 테스트 =BattleFlowTests.AimGauge_CycleDistanceAndGuaranteedCrit. 실제 손 조작 확인은 PD 플레이(레거시 Input 이라 자동 테스트로 누름·끌기를 못 만든다). -
이동·충돌 물리(PD 2026-11-16 「알까기·당구처럼 미는 힘에 맞춰 세게 날아가 세게 부딪히게 · 등속이면 안 됨 · 힘과 거리에 비례」): ① 부딪히는 힘 =
ActionResolver.ImpactPower(쏜 거리, 부딪히기까지 간 거리)= 쏜 거리 − 간 거리 ×impactFalloff0.4(그 전 = 남은 거리 → 멀리 있는 상대일수록 힘이 0 에 가까웠다) — 보병 밀어내기·자기 튕김 · 창병 밀치기 · 바위 굴리기 · 튕김 연쇄 · 연쇄 밀기(Push)가 같이 쓴다 · 고순 재행동 한도만 남은 거리 그대로. ② 쏘는 최대 거리 = 병종 값unitStats.launchDistance(Unit.LaunchDistance→SkillMods.SlingMax= 조준·이동·적 AI · 보·창·궁·책 7.2 · 기 10.4 — 아래 4차 · 배율meleeLaunchScale은 폐지) · 스킬 「행동 반경」·밀치기 스킬 거리는 병종 값(SlingMaxDistance) 그대로. ③ 이동 연출 = 등감속:Fx.MoveDuration= √(거리 ×moveRefDistance4.5) / 속도(멀리 갈수록 빠르게 출발해 마찰로 멈춤) · 부딪히러 가는 직진 =Fx.MoveAlong(…, launch)(가는 동안 감속 × impactFalloff → 부딪히는 순간의 속도 = 밀려나는 유닛의 출발 속도) · 수치는BattleManager.Configure가Fx.Configure로 넘긴다. ④collisionSelfBounceMinRatio0.5 → 0(힘에 비례 · 하한을 둔 이유였던 「적 바로 앞을 노리면 힘이 0」이 ①로 없어짐). 세 값 모두 제안값(PD 확인 대상). 테스트 기대식 =BattleFlowTests.Impact. 지형지물(언덕·산) 배치는 이 수치가 정해진 뒤의 레벨 작업(미착수). -
병종별 밀기·튕김(PD 2026-11-16 2차): 보병 = 미는 거리·튕기는 거리 30 % 감소(
collisionPushRatio·collisionSelfBounceRatio1 → 0.7 · 연쇄 밀기 전달과 보병·기병의 지형 튕김도 같은 값) · 창병 = 보병보다 더 밀고(spearPushRatio1.5) 보병이 튕기는 거리의 절반만 밀려남(spearRecoilRatio0.5 = 부딪히는 힘 × collisionSelfBounceRatio × 이 값 — 뜻이 바뀜: 그 전 = 상대가 밀린 거리 × 0.2) · 상대를 쓰러뜨려도 · 상대가 안 밀려도 밀려난다(그 전 = 상대가 살아서 밀릴 때만 → 처치하는 타격은 전혀 안 튕김 = PD 「전혀 튕기지 않는 것 같아」의 원인) · 지형(장애물 기믹)에 부딪히면 세 병종 모두 튕긴다: 보병·기병 = 부딪히는 힘 × collisionSelfBounceRatio · 창병 = 그 × spearRecoilRatio · 바위도 포함(보·창 = 바위를 굴리면서 튕김 · 기병 = 바위에 막혀 튕김 · 그 전 = 정지) · 기병이 지형에 부딪히는 힘도ImpactPower(CavalryRoutinegimLeft). 전장 가장자리 벽은 그대로(멈춤 · 손책 스킬만 튕김). 기병의 유닛 관통은 그대로. 학습 판 = 판별 발사 세기 키drag_lock_shot_pull_<장>_<판>(TutorialDirector.ShotPull· 1-2 = 1 · 1-8 = 0.75 · 그 밖 = 공통 0.37). 3차(같은 날 PD 「창병이 미는 거리가 현재의 30 % 정도 · 이에 맞게 보병도」):spearPushRatio1.5 → 0.45 ·collisionPushRatio0.7 → 0.21(창병 : 보병 비율 유지) · 연쇄 밀기 전달은pushChainRatio0.7 로 분리(미는 비율을 줄여도 연쇄는 그대로 ·Push안) · 튕기는 거리(collisionSelfBounceRatio0.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) ·archerRangeRatio0.2 → 0.5(다가가 쏘는 최대 사거리 = 이동 범위의 1.5배 = 10.8 — PD 문장을 이렇게 읽음 · 다른 뜻이면 이 값 하나만 바꾼다). ② 기병 관통 감쇠cavalryPassLossRatio0.25: 유닛(적·아군) 하나를 지날 때마다 그 뒤 남은 거리 × 0.75(ActionResolver.PassLossTravel·CavalryRoutine구간마다 · 대상 미리 계산도 같은 식 · 줄어든 거리로 못 지나는 밀집 대열에서는 종착점이 앞으로 되짚힌다 = 기존BackOffFromUnits). ③ 유닛에 부딪혀 잃는 힘unitHitBounceLossRatio0.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_71(늘어선 넷을 모두 지나려면 최대 세기). 값(0.25 · 0.15 · 0.6)은 제안값. 5차(같은 날 PD 「궁병이 이동과 동시에 공격하지 못하게 · 보병이 아군과 닿아 튕겨서 추가로 적을 공격 · 여러 번 공격 · 기병과 창병이 지금보다는 더 밀려야」): ① 원거리 = 제자리 사격만: 사거리 =LaunchDistance × (1 + archerRangeRatio)= 10.8(이동 범위 7.2 밖까지 제자리에서 쏜다 · 붉은 도넛 = 이동 범위 밖 ~ 사거리) · 조준 방향 사거리 안에 적이 있으면 제자리 사격, 없으면(사거리 밖 · 방향이 안 맞음) 쏘지 않고 목표점까지 이동만 · 다가가 쏘기(ArcherMoveAllow·ShotPlan.Approach·SlideBeforeShot) 삭제 · 책사도 같은 규칙(#1087 ⑤) · 백기습영 같은 스킬의 이동 후 사격은 그대로. ② 보병 튕김 연쇄 여러 번:Bounce(…, int chain)= 남은 연쇄 횟수(bounceChainMax6) · 적과 싸운 뒤 튕겨 나가다 닿은 유닛이 적 = 다시 공격 후 튕김 · 아군 = 밀어내고 그 아군에게서도 다시 튕김(그 전 = 연쇄 1회 · 아군이면 밀기만 하고 정지) · 같은 적과 다시 부딪힐 수 있다 · 다음 충돌은 앞서 밀린 유닛이 멈춘 뒤에 계산 · 아군을 처음 친 경우(밀기)는 5차까지 연쇄 없음 → 6차에서 같은 연쇄로 바꿈(아래). 밀림 가중치는 상대가 밀리는 거리에만 곱하고 보병이 튕기는 거리에는 들어가지 않는다(테스트Infantry_HitsEnemy…가 창병 상대로 확인). ③ 창병·기병pushTakenRatio0.6 → 0.8. 6차(2026-11-17 PD 「아군을 친 경우에도 연쇄로 튕겨져 공격하거나 아군을 더 미는 등의 행위가 발생되어야 · 플레이어가 기대한 패턴대로 동작하지 않으면 복잡성이 증가」): 보병이 처음 닿은 유닛이 아군이어도Bounce에bounceChainMax를 넘긴다 — 아군을 밀고 튕겨 나가다 닿은 유닛이 적 = 공격 후 다시 튕김 · 아군 = 더 밀고 다시 튕김(적을 먼저 친 경우와 같은 규칙 하나) · 테스트Infantry_FirstHitAlly_…2종. -
조준·턴 표시(PD 2026-11-16 2차): 방향 화살표 = 유닛·체력 바 위(
order_arrow10 — 같은 날 −6 으로 내렸던 것을 되돌림) · 손 조작 중에는 화살표만 보인다(SlingshotInput.ShowAim) — 맞을 유닛의 주황 강조 · 예상 궤적(노란 점선) · 화살 경로선 · 광역 원은ShowPreview(자동 플레이 캡처·테스트용)에만 남음 · 쏜 행동이 끝나면 다음에 행동할 아군을 자동 선택 + 화면 이동(FocusNext· 방금 유닛이 또 행동할 수 있으면 그 유닛 · 아니면 편성 순서로 다음 · 즉시형 스킬 연출 뒤와 학습 판 잠금 안내 중에는 안 옮김) · 전원 행동 시 자동 적 턴은 원래 구현(BattleManager.AllPlayersActed) 그대로 — 스킬로 얻은 추가 이동만 남았을 때만 빈 곳 탭으로 넘긴다. -
여포 크기(PD 2026-11-10 「왜 여포는 다른 기병보다 작지?」): 말 탄 유닛은 머리 끝 상한(BalanceConfig.mountedArtMaxTop 1.3 × 표준 키)에 맞춰 줄어드는데,
dz_boss_lvbu의 몸 높이(meta.jsonbodyHeightPx ·art_size.csvbody_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 결정 ⑱)) · 창병 = 적을 크게 밀치지만 자신은 적게 밀림(
spearPushRatio1.5 > 보병collisionPushRatio1.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_scale1) · 끝 소멸 =f_fade0.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(서황 hitFX_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= 그 스킬 효과가 남아 있는 동안 반복(예약 대기 · 시전 중 · 시한 효과 대상 = 범위 버프 받은 아군 각각 / 대상 없는 시한 효과 = 시전자 ·SkillVfxLoops0.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.1HCFX_Energy_08) · 유비 예약 기운(aura) = Vol.2HCFX_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_circle1 ·target_circle_scale1.3). 아군 선택 = 그 유닛을 제자리에 두고 부드럽게 확대(BalanceConfig.selectZoomRatio0.85 · 해제 = 원래 크기 ·CameraController.ZoomTo). 2026-11-11 PD 2차: 당기는 동안 발사 방향을 봄(SlingshotInput.OnDrag→UnitView.SetFacing) · 조준 중 속성 방울 = 유닛 아래(ib_ui.csv order_bubble−7) · 몸 둘레 모이는 빛 = 파란 조준 고리와 같은 범위(attack_ready_scale1.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_cel1 인 행의 이펙트만 전용 층(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_min0.84) · 색 있는 면 최저 밝기v_min0.68 · 검정에 가까운 칠 = 무채색으로 봄. 선 떨림(wobble_*)·안쪽 먹선(ink_inner)은 삭제. 비용 = 층마다 번짐 2번(전체 해상도) + 마스크 3번(절반 해상도)이 더 듦. 값 표를 통째로 덮어쓰면 데이터 보호 훅이 막음 → 줄 단위로 고칠 것(백업 =_backup_assets/· git 미추적). - 화살·비도(2026-11-11 PD 「투사체 크기가 비정상 · 화살이 그림 맨 위에 어색 → 입체적으로 박혀 있는 느낌」): 팩
FX_Shoot_Arrow/Dagger_projectile·hit은 3D 메시라 크기가 맞지 않고(비도 = 유닛 키의 2배) 꽂힌 화살이 머리 위에 길게 섬 → 자체 제작으로 교체(화풍 층을 거치지 않음b_cel0 · 그리는 순서 +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_follow1 ·f_fwd−0.08 ·f_dy−0.14 ·f_life1.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_cavalrytravelTKS_Fx_SpearRushDust_sand) =b_cel1(화풍 층 = 밝은 미색 구름 + 먹선). 화풍 층 보완: 새까만 칠(둘레 평균 밝기black_lo~black_hi아래 · 먹 무늬·먹 베기)은 먹색 그대로 — 2차에서 검정까지 미색으로 올려HCFX_Hit_07같은 먹 무늬가 미색 덩어리로 보였음. 촬영 도구 = 영웅 id 앞에-(예-guanyu)면 액티브 없이 일반 슬링샷. ⚠ 같은 에디터를 쓰는 다른 세션이 Play 중에 .cs 를 저장하면 재컴파일이 끼어들어FrameAnimatorNullReference 가 쏟아짐(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_face1 = f_dx 를 유닛이 바라보는 쪽 기준으로 · 돌아서면 따라감SkillVfxFacing) · 크기 이력 = 1.1 → 0.33(30%) → 0.4(+20%) → 0.95(뒤에 가리는 방식) ·b_nofall1 = 층은 그대로 두고 떨어지는 움직임만 끔(중력 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의 모양 시트 방식(_Mode1 = 흰 모양 플립북 시트 · 둘레를 읽어 테두리 → 몸 → 밝은 심 · 테 굵기보다 가는 조각은 몸 색 ·_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.2HCFX_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_radial0.45;1(반경 배수 · 중심에서 스킬 반경의 45% 부터 옅어져 반경 끝에서 투명 · 값은 렌더러마다MaterialPropertyBlock) · 화풍 층 대신 노랑 3단SHOUT_RAMP(화풍 층은 반투명을 단계로 끊음 · 검은 선도 짙은 갈색) · 유닛 아래(n_order -14 · -15) ③s_ramp여덟째 값 1 또는s_radial= 메시가 아닌 띠·판 층도 재질 교체 · 셰이더TKS/FxPackHalf는 방식별 키워드(_MODE_SHEET= Namu 모양 시트 ·_MODE_DISSOLVE= Element SplashFx_dissolve_particle_apb근사 · 없음 = HCFX apb) — 실행 중 분기(if) 안에서 그림을 여러 번 읽으면 셰이더 컴파일러가 죽어 전부 분홍으로 나옴(실측) ·editor_sync_compilation(처음 쓰는 순간 하늘색 임시 그림 방지) ④ 기절(status_stun· LanaStun_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· 재질 셰이더는 이식판_BuiltinPortsAdditiveFlow · AlphaBlendFlow 와 같은 GUID 라 그대로 동작 · 후보로 함께 옮긴FX_FireCharge·FX_Blast·FX_Blast_Ground는 미사용) · 사본TKS_Fx_Sk_FX_Blast_Lance=Tools/build_blast_lance.cs(원본 창은 팩 세계에서 150° 로 비스듬히 날고 중심이 원점에서 벗어남 → 빈 뿌리 아래에 돌려 넣어 창끝 = +X · 창 가운데 = 원점 · 표b_flat1 +b_face1 이 +X 를 돌진 방향으로) · 창 층(cannon 아래)은 travel 행(유닛 아래 n_order -13 ·b_sustain1 = 돌진 내내 · 끝나면 자연 소멸) · 터지는 층(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_lift1). 🔴 공격 이펙트는 몬스터 위가 PD 기준 — 다른 영웅의 돌진·찌르기 이펙트를 만들 때도 유닛 아래(-13 이하)에 두지 말 것. (3) PD 「모든 유닛의 슬링샷 이동 시 발생하는 흙먼지 이펙트 가장자리도 검은색 보다는 좀 더 부드러운 브라운 계열」 → 화풍 층의 먹선 색은 판 하나에 하나라 흙먼지만 따로 못 바꿈 → 새 칸s_style(화풍 층 변형 이름 ·b_cel1 인 유닛 아래 이펙트 전용) +fx_style.csv의 「키@변형」 줄(ink_color@dust#96683C·ink_tint@dust0) ·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_rate0) · 색 묶음이 행마다 하나라 네 행(바닥 빛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 곡선도 원래 초 단위로 당김. ② 「황충 스킬이 적에게 화살이 날아갈 때 발생하는 먼지 이펙트는 제거(대신 황충 이동 시 최초 이동 때와 도착할 때 먼지 연출)」 → 먼지로 보이던 것 = 발사 순간 황충 둘레에 퍼지던 미색 줄기(castFX_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_styledust). ③ 「황충의 기본 공격 화살이 백발백중 스킬에 사용한 화살과 동일한 투사체」 → 새 키hero_<장수 id>(SkillVfx.HeroKey· 스킬을 장착하지 않은 일반 행동에서basic_<병종>행에 더해짐 · 이동만 하는 행동 포함 · 장착 중에는 안 붙음 = 화살이 두 번 겹치지 않게) ·hero_huangzhong의 shot = 같은 자체 제작 화살 · 같은 크기(금빛 기운은 스킬에만) · depart·arrive 도 이 키. ④ 「황충 스킬 사용 시 Casual RPG VFX 의 두번째 첨부한 이펙트를 화살과 합쳐서 발사(화살에 강력한 힘이 담긴 연출)」 =Projectiles_light(후보Projectiles_*10종을 움직이며 그려 대조 — light = 흰 타원 머리 + 금빛 꼬리 + 반짝이 · 프리팹 앞 = +X →b_flat1 +b_face1) · 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.csvp1) · 금빛 기운 크기 4.4 ·f_fwd1.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_delay0.3 · 새 칸f_wait0.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_life0.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_zhugeliangshot 두 행 = 불꼬리(fire2겹 ·fire_real·FIRE_TAIL주황 + 노란 심 + 붉은 가장자리 · 불투명도 2.2배 · n_order 0) / 불덩이 몸(ball·FIRE_BALL노랑 + 옅은 심 + 주황 테 · 1) · 회색 연기(smoke) 끔 · 크기 0.4(기준 크기 1.2 = 몸 지름) ·f_life0.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 한 행(불꽃fire2겹 +fire_real·FIRE_TAIL)만 · 두 방법을 캡처로 비교: 같은 색으로 칠하면 납작한 노란 원판이 불꽃 위에 떠 보여 모양이 그대로 읽힘(메시 구슬은 윤곽이 딱 끊겨 번지게 할 수 없음) → 숨기는 쪽으로 · 불꽃만으로 둥근 머리가 됨 · 구슬 행은 도구에 주석으로 남김. → PD 「원본과 같이 그라데이션 색상도 적용 · 꼬리쪽으로 갈수록 짙은 색이 되도록」(불덩이 색의 최신): 원본 불꽃 그림(Fire_00002· 4x3)에 밑동 노랑 → 주황 → 끝 붉은색이 이미 그려져 있고 밑동이 머리 쪽이라 색을 입히지 않고 원본 그림 색 그대로 씀 —s_ramp의 색 칸 셋을 모두 비우면 색 입히기를 끄고(_Ramp0) 원본 그림 색 × 재질 색·밝기(_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) 규칙이 「원래 반복인 층만 남김」이라 LanaOrbs_*의 구슬 층(한 번만 터지는 층)이 꺼짐 → 그런 프리팹은b_loopall1 +f_fade③prewarm입자는 띄우는 순간 원래 색으로 이미 만들어짐 → 색을 바꾼 뒤 껐다 켬(Recolor) ④FX_Blue Rune은 재질 색이 파랑이라 금빛을 넣으면 녹색 ⑤ 실측 크기는 「가장 많이 보이는 한 순간」이라 화살·집중선처럼 길게 뻗는 것은 실제보다 작게 잡힘(설계 파일size=로 보정) ⑥ MasterStylizedProjectiles 의 hit·muzzle(어두운 얼룩) · LanaShield_*(불투명 도넛) · HCFXSign_*·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_scale0.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_MAX0.2 · 색 · 불투명도 3단계(TKS_CEL_STEPS· 불투명도 반올림 · 보강TKS_ALPHA_GAIN1.25) ·CommonMeshLoop뒷면 셸 = 같은 색 ×TKS_RIM_SHADE0.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·SkillTestBootstrapdepthTextureMode |= 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·AutoPlayDriverAssets/Scripts/Editor/—ProjectSetup(CLI 진입점·씬 생성) ·BalanceDefaults(최초 시드) ·StageImporter(스테이지 표 → 자산) ·UnitArtImporter(아트 임포트 설정) ·DataImporter(아웃게임 표 → 자산 · 화면 캡처)Assets/Scripts/OutGame/— 아웃게임(세이브·로비·영웅·편성·거래·보상 · 내정Domestic/· 보물Treasure/· 연무장Arena/· 위 「코드 규칙」)Assets/Data/Stages/— 챕터·스테이지 표 CSV 4장(위 「코드 규칙」) · 해석·배치 =Runtime/StageTableAssets/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)