[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBBDXMT3359A3FJXFBPWDA":3,"skill-same:01M6CBBDXMT3359A3FJXFBPWDA":64},{"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},"01M6CBBDXMT3359A3FJXFBPWDA","15-common-effect-manager",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\u002F15-common-effect-manager\u002FSKILL.md",[],[18,19,20],"common","effect","15 common effect manager","2026-11-10 10:12:30",false,"# 15-common-effect-manager\n\nStatus: ACTIVE\nAppliesTo: v10\nType: Component Specification\n\n## 1. 목적\n\nUnity에서 사용할 Common Effect 시스템을 정의한다.\n\n- 스폰\u002F디스폰은 `BundlePool` 기반 (Addressables 캐시에서 prefab 조회)\n- 효과 구현은 prefab 내부 컴포넌트(ICommonEffectPlayer)로 확장\n- CommonEffectObject는 상태(Play\u002FPause\u002FResume\u002FStop\u002FRemove) 및 자동 반환을 관리\n\n---\n\n## 2. 네임스페이스\n\n모든 코드는 `namespace Devian` 고정.\n\n---\n\n## 3. 생성 대상 패키지\n\n- `com.devian.foundation` (CommonPackage sample)\n\n## 3.1 UPM 종속성\n\n- `com.devian.foundation`의 CommonPackage 샘플은 foundation Runtime에 의존한다.\n- 이유: `BundlePool`, `AssetManager`, `AutoSingleton` 등 foundation Unity runtime에 의존한다.\n\n---\n\n## 4. 파일 위치 (정본)\n\n```\ncom.devian.foundation\u002FSamples~\u002FCommonPackage\u002FRuntime\u002FCommonEffect\u002F\n├── COMMON_EFFECT_ID.cs\n├── CommonEffectManager.cs\n├── CommonEffectObject.cs\n├── ICommonEffectPlayer.cs\n└── Players\u002F\n    ├── ParticleEffectPlayer.cs\n    └── AnimEffectPlayer.cs\n```\n\nEditor:\n\n```\ncom.devian.foundation\u002FSamples~\u002FCommonPackage\u002FEditor\u002FGenerated\u002F\n└── COMMON_EFFECT_ID.Editor.cs\n```\n\n---\n\n## 5. COMMON_EFFECT_ID 규약\n\n- string wrapper 타입\n- `Value` 필드 + `IsValid` 제공\n- implicit operator string \u002F COMMON_EFFECT_ID 제공\n- GroupKey = `COMMON_EFFECT`\n\n---\n\n## 6. CommonEffectManager 규약\n\n- Singleton은 `AutoSingleton\u003CCommonEffectManager>` 사용 (script-created only)\n- 외부 API는 `CreateEffect(..., attachType, parent = null)` \u002F `Remove(...)` 제공\n- Pooling은 내부적으로 `BundlePool.Spawn\u003CCommonEffectObject>(effectId.Value, ...)` \u002F `BundlePool.Despawn(effectObject)` 사용\n\nAttach 타입:\n\n```csharp\npublic enum COMMON_EFFECT_ATTACH_TYPE\n{\n    World,\n    Ground,\n    Child,\n}\n```\n\nGround 규칙:\n\n- effect.position + (0,100,0)에서 아래로 SphereCast(radius=0.01)로 지면을 찾으면 hit.point로 이동\n- parent는 전달된 `parent`를 그대로 사용\n- `parent == null`이면 unparented 상태 유지\n\nWorld 규칙:\n\n- parent는 전달된 `parent`를 그대로 사용\n- `parent == null`이면 unparented 상태 유지\n\nChild 규칙:\n\n- `parent`가 명시되면 그 값을 사용\n- `parent == null`이면 attachTr를 parent로 사용\n\n---\n\n## 7. CommonEffectObject 규약\n\n- MonoBehaviour, IPoolable\u003CCommonEffectObject> 구현\n- 상태 머신: Playing \u002F Paused \u002F Stopped \u002F Removed\n- 공통 API: Init(), Play(), Pause(), Resume(), Stop(), Remove(), Clear()\n- SetSortingOrder(int) \u002F SetDirection(bool) 제공\n\nRemove 규칙:\n\n- `BundlePool.Despawn(this)`로 반환\n\n---\n\n## 8. ICommonEffectPlayer 규약\n\nCommonEffectObject 내부에서만 호출하는 public API이므로 메서드명은 `_` prefix를 사용한다.\n\n필수 메서드:\n\n- `_OnEffectAwake(CommonEffectObject owner)`\n- `_OnEffectPlay()`\n- `_OnEffectPause()`\n- `_OnEffectResume()`\n- `_OnEffectStop()`\n- `_OnEffectLateUpdate()`\n- `_OnEffectClear()`\n- `_SetSortingOrder(int order)` (optional 구현 가능)\n\n---\n\n## 9. 제공 Player 2종\n\n### ParticleEffectPlayer\n\n- 자식 ParticleSystem 전부를 관리\n- playTime > 0이면 시간 종료 후 Stop\n- playTime == 0이면 모든 파티클이 죽으면 Stop\n- Stop 시 StopEmitting 후 fadeOutTime 대기 후 Remove\n\n### AnimEffectPlayer\n\n- `[RequireComponent(typeof(AnimSequencePlayer))]` 로 AnimSequencePlayer 의존성 강제\n- Player 자체는 AnimSequenceData나 AnimationClip을 보유하지 않음\n- AnimSequencePlayer.PlayDefault()만 호출하여 재생\n- playSpeed 필드: PlayDefault(playSpeed, callback)으로 전달\n- ComputedPlayTime 제공 (초 단위):\n  - AnimSequencePlayer._GetDefaultPlayTime(playSpeed) 호출\n  - 무한이면 -1\n  - clip\u002Fsequence가 없으면 0\n  - clip\u002Fsequence가 있으면 계산값\n- 자동 제거 정책:\n  - ComputedPlayTime == -1이면 자동 Remove 하지 않음\n  - 그 외에는 시퀀스 완료 콜백으로 Remove\n- Stop은 즉시 Remove\n\n---\n\n## 10. Hard Rules\n\n- Spawn\u002FDespawn은 BundlePool로만 한다.\n- ID는 prefab.name 그대로 사용한다.\n- 네임스페이스\u002F폴더 규약 위반 금지.\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F20-common-package\u002F15-common-effect-manager","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 15-common-effect-manager",{"tool":38,"command":39},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 15-common-effect-manager",{"tool":41,"command":42},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 15-common-effect-manager","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F20-common-package\u002F15-common-effect-manager\u002FSKILL.md",true,[46,52,56,60],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"evals\u002Fevals.json","REFERENCE","参考文档",2767,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fchains\u002Fmystenlabs-move\u002Fevals\u002Fevals.json",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"README.md",1177,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fchains\u002Fmystenlabs-move\u002FREADME.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"SOURCE.md",336,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fchains\u002Fmystenlabs-move\u002FSOURCE.md",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"TRUST.auto.yaml",2146,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fchains\u002Fmystenlabs-move\u002FTRUST.auto.yaml",[65,71,79,87,96,103],{"skillNo":66,"name":67,"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":68,"categories":69,"keywords":70,"publishedAt":21},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[67],{"skillNo":72,"name":73,"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":74,"categories":75,"keywords":76,"publishedAt":21},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[77,78],"archive","90 project archive",{"skillNo":80,"name":81,"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":82,"categories":83,"keywords":84,"publishedAt":21},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[85,86],"management","30 env management",{"skillNo":88,"name":89,"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":90,"categories":91,"keywords":92,"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",[],[93,94,95],"push","page","19 page push send",{"skillNo":97,"name":98,"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":99,"categories":100,"keywords":101,"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",[],[94,102],"18 page savedata",{"skillNo":104,"name":105,"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":106,"categories":107,"keywords":108,"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",[],[94,109],"17 page deobfuscate"]