[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBBKKTSJR6GZD8YEEJPM6V":3,"skill-same:01M6CBBKKTSJR6GZD8YEEJPM6V":46},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":21,"linkOnly":22,"markdownContent":23,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":13,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M6CBBKKTSJR6GZD8YEEJPM6V","23-material-effect-controller",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F20-common-package\u002F23-material-effect-controller\u002FSKILL.md",[],[18,19,20],"controller","effect","23 material effect controller","2026-11-10 10:12:30",false,"# 23-material-effect-controller\n\nStatus: ACTIVE\nAppliesTo: v10\nType: Component Specification\n\n## 목적\n\n단일 Renderer의 Material[] 배열(sharedMaterials) 스위치 전용 컴포넌트.\n\n## 핵심 정책 (v2)\n\n- **1:1 매칭**: Controller ↔ Driver(Renderer) 1개\n- **default = baseline**: effect 0개일 때는 baseline(초기 Material 상태)이 적용됨\n- **slot mismatch 허용**: 검증\u002F차단 없이 그대로 설정\n- **PropertyBlock\u002FCommon 제거**: Material[] 스위치만 지원\n\n## 생성 대상 패키지\n\n- `com.devian.foundation` (CommonPackage sample)\n\n## UPM 종속성\n\n- `com.devian.foundation`의 CommonPackage 샘플은 foundation Runtime에 의존한다.\n- 이유: `AssetManager`와 공용 Unity 런타임 유틸리티를 foundation에서 제공한다.\n\n## 파일 위치 (SSOT)\n\n- Runtime: `com.devian.foundation\u002FSamples~\u002FCommonPackage\u002FRuntime\u002FMaterialEffect\u002F`\n- Editor: `com.devian.foundation\u002FSamples~\u002FCommonPackage\u002FEditor\u002F`\n- Editor Selector: `com.devian.foundation\u002FSamples~\u002FCommonPackage\u002FEditor\u002FGenerated\u002FMATERIAL_EFFECT_ID.Editor.cs`\n\n## 클래스 선언\n\n```csharp\nMaterialEffectController : MonoBehaviour\n```\n\n## 핵심 구성요소\n\n### BaseMaterialEffectDriver (v2)\n\n단일 Renderer를 위한 Material 교체 abstract base class.\n\n| 메서드 | 설명 |\n|--------|------|\n| `bool IsValid { get; }` | Driver 유효성 (Renderer 존재 여부) |\n| `void CaptureBaseline()` | 현재 sharedMaterials를 clone하여 baseline 저장 |\n| `void RestoreBaseline()` | baseline으로 복원 + apply-clone 정리 |\n| `void DisposeBaseline()` | baseline clone들 Destroy (OnDestroy용) |\n| `void SetSharedMaterials(Material[] materials)` | Material[] 교체 (slot mismatch 허용) |\n| `void SetVisible(bool visible)` | Renderer.enabled 설정 |\n\n**삭제된 API (v1 → v2):**\n- `RendererCount`, `GetMaterialSlotCount`\n- `SetSharedMaterial(int rendererIndex, ...)`, `SetSharedMaterials(int rendererIndex, ...)`\n- `SetPropertyBlock`, `ClearPropertyBlock`, `SetFloat\u002FInt\u002FColor`, `ApplyPropertyBlocks`\n- `ApplyCommon`\n\n### IMaterialEffect\n\n런타임 인스턴스 인터페이스.\n\n| 멤버 | 설명 |\n|------|------|\n| `int Priority { get; }` | 우선순위 값 |\n| `void Apply(BaseMaterialEffectDriver driver)` | 효과 적용 |\n| `void Reset()` | 풀링 반환 시 초기화 |\n\n### MaterialEffectAsset (ScriptableObject)\n\n- 프로토타입 역할\n- 내부 풀 관리: `Stack\u003CIMaterialEffect>`\n- `Rent()`: 인스턴스 획득. **내부 인스턴스 생성 실패(null) 시 즉시 예외(throw)**\n- `Return(IMaterialEffect)`: 인스턴스 반환\n- `CreateInstanceInternal()`: 추상 팩토리\n\n### MaterialEffectController\n\n| 필드 | 타입 | 설명 |\n|------|------|------|\n| `_driverComponent` | BaseMaterialEffectDriver | Driver 지정 (선택) |\n\n## 우선순위 규칙 (하드)\n\n1. **priority 큰 것이 우선**\n2. **priority가 같으면 나중에 추가된 effect가 승리**\n3. **effect가 0개일 때 baseline이 적용됨** (handle 0)\n\n## 적용 순서 (하드)\n\neffect 변경\u002F갱신 시마다:\n```\ndriver.RestoreBaseline()\nif (selectedEffect != null) selectedEffect.Apply(driver)\n```\n\n## Awake 순서\n\n1. driver resolve (driverComponent 우선, 없으면 자동 탐색)\n3. `driver.CaptureBaseline()`\n4. effect 0개 상태이므로 baseline(handle 0) 적용\n\n## 외부 API\n\n| 메서드 | 설명 |\n|--------|------|\n| `int AddEffect(MaterialEffectAsset asset)` | effect 추가, handle 반환 |\n| `bool RemoveEffect(int handle)` | effect 제거 |\n| `void _ClearEffects()` | 모든 effect 제거 |\n| `int AddEffect(MATERIAL_EFFECT_ID id)` | ID로 effect 추가 |\n| `int _GetCurrentAppliedHandle()` | 현재 적용 중인 effect handle (0=baseline, -1=none) |\n| `string _GetCurrentAppliedEffectName()` | 현재 적용 중인 effect 이름 |\n\n## Effect Asset 종류 (v2)\n\n### MaterialSetMaterialEffectAsset (권장)\n\nMaterial[] 배열을 그대로 적용.\n\n```csharp\n[CreateAssetMenu(menuName = \"Devian\u002FMaterial Effects\u002FMaterial Set\")]\npublic sealed class MaterialSetMaterialEffectAsset : MaterialEffectAsset\n{\n    [SerializeField] private Material[] _materials;\n}\n```\n\n### NoOpMaterialEffectAsset\n\n아무 효과도 적용하지 않음 (baseline 상태 유지).\n\n## MaterialEffectDriverCommon (v2)\n\n단일 Renderer 전용 구현체.\n\n| 필드 | 타입 | 설명 |\n|------|------|------|\n| `_renderer` | Renderer | 대상 Renderer (null이면 같은 GO에서 자동 획득) |\n| `_cloneOnApply` | bool | clone-on-apply 활성화 (기본 true) |\n\n### clone-on-apply 정책\n\n- 에셋 머티리얼을 그대로 꽂지 않고 clone해서 적용\n- 이미 Devian clone이면 재-clone 금지\n- effect 전환(RestoreBaseline) 시 apply-clone 전부 Dispose\n\n## 금지 사항\n\n- BaseMaterialEffectDriver에 animation 관련 API 추가 금지\n- 런타임 ID resolve에서 AssetDatabase\u002FResources.Load 직접 호출 금지 (AssetManager 캐시만)\n- slot mismatch 검증\u002F차단\u002F자동 보정 금지\n\n---\n\n## Edit Mode Preview\u002FSave (Editor 전용)\n\n### 핵심 정책\n\n- **Edit Mode 전용**: Play Mode에서 Preview\u002FSave 기능 금지\n- **Play Bake 금지**: Play 중 Snapshot Save 불가\n- **baseline 오염 방지**: Play 진입 시 자동으로 모든 Preview OFF\n\n### Editor API (UNITY_EDITOR only)\n\n| 메서드 | 설명 |\n|--------|------|\n| `bool EditorPreviewIsActive` | Preview 활성화 여부 |\n| `void EditorPreviewOn(MaterialEffectAsset effect)` | Preview 켜기 (Edit Mode only) |\n| `void EditorPreviewOff()` | Preview 끄고 baseline 복원 |\n| `void EditorSaveSnapshotTo(MaterialSetMaterialEffectAsset target)` | Renderer의 현재 materials를 asset에 저장 |\n\n### Preview 동작 규칙\n\n1. **Edit Mode에서만 동작** - `Application.isPlaying == true`면 무시\n2. **baseline 저장** - Preview ON 시 현재 sharedMaterials를 NonSerialized 필드에 저장\n3. **직접 교체** - Driver를 거치지 않고 `Renderer.sharedMaterials` 직접 설정\n4. **PropertyBlock clear** - Preview ON\u002FOFF 시 `renderer.SetPropertyBlock(null)` 호출\n\n### Snapshot Save 검증 규칙 (Hard)\n\n저장 전 모든 material slot에 대해 다음 검증 통과 필수:\n\n| 검증 | 실패 시 |\n|------|---------|\n| `material != null` | 저장 거부 |\n| `AssetDatabase.Contains(material) == true` | 저장 거부 (runtime instance 금지) |\n| `hideFlags`에 DontSave 계열 없음 | 저장 거부 |\n| `name`이 `__DevianClone__`으로 시작하지 않음 | 저장 거부 (clone 저장 금지) |\n\n### Play Mode 진입 시 자동 클린업\n\n`MaterialEffectEditorHooks`가 `EditorApplication.playModeStateChanged` 구독:\n- `ExitingEditMode` 시 모든 `MaterialEffectController`의 `EditorPreviewOff()` 호출\n- baseline 오염 방지 (Preview 상태가 Play 시작 baseline으로 캡처되는 사고 방지)\n\n### Custom Inspector (MaterialEffectControllerEditor)\n\n파일: `Editor\u002FMaterialEffectControllerEditor.cs`\n\nUI 구성:\n- **Preview 섹션**: Effect 선택 + Preview On\u002FOff 버튼 + 상태 표시\n- **Snapshot 섹션**: Target Asset 선택 + Save 버튼\n\nUndo\u002FDirty 처리:\n- Preview 전 `Undo.RecordObject(renderer, ...)` 호출\n- 변경 후 `EditorUtility.SetDirty(renderer)` 호출\n\n---\n\n## MaterialEffectManager\n\nMaterialEffectAsset을 AssetManager 캐시에 적재하는 **CompoSingleton 기반** 매니저.\n\n### 파일 위치\n\n- `com.devian.foundation\u002FSamples~\u002FCommonPackage\u002FRuntime\u002FMaterialEffect\u002FMaterialEffectManager.cs`\n\n### 선언\n\n```csharp\npublic sealed class MaterialEffectManager : CompoSingleton\u003CMaterialEffectManager>\n```\n\n### 인스펙터 필드\n\n| 필드 | 타입 | 설명 |\n|------|------|------|\n| `_addressablesKey` | `string` | MaterialEffectAsset 번들의 Addressables key\u002Flabel |\n\n### 동작\n\n- `Start()`에서 `_addressablesKey`가 설정되어 있으면 `AssetManager.LoadBundleAssets\u003CMaterialEffectAsset>(key)` 호출\n- key가 비어있으면 경고 로그 후 스킵\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F20-common-package\u002F23-material-effect-controller","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add devwinsoft\u002Fdevian --skill 23-material-effect-controller",{"tool":38,"command":39},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 23-material-effect-controller",{"tool":41,"command":42},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 23-material-effect-controller","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F20-common-package\u002F23-material-effect-controller\u002FSKILL.md",true,[],[47,53,61,69,78,85],{"skillNo":48,"name":49,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":21},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[49],{"skillNo":54,"name":55,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":21},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[59,60],"archive","90 project archive",{"skillNo":62,"name":63,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":21},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[67,68],"management","30 env management",{"skillNo":70,"name":71,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":21},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[75,76,77],"push","page","19 page push send",{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":21},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[76,84],"18 page savedata",{"skillNo":86,"name":87,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":21},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[76,91],"17 page deobfuscate"]