AGENT SKILL
24-material-effect-id
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
03 SKILL.md 正文
24-material-effect-id
Status: ACTIVE AppliesTo: v10 Type: Component Specification
목적
MaterialEffectAsset을 참조하기 위한 string wrapper ID 타입
파일 위치 (SSOT)
- Runtime:
com.devian.foundation/Samples~/CommonPackage/Runtime/MaterialEffect/MATERIAL_EFFECT_ID.cs - Editor Base:
com.devian.foundation/Editor/AssetId/BaseEditorScriptableAssetIdSelector.cs - Editor Selector:
com.devian.foundation/Samples~/CommonPackage/Editor/Generated/MATERIAL_EFFECT_ID.Editor.cs
String Wrapper 패턴
COMMON_EFFECT_ID와 동일한 구조:
[Serializable]
public sealed class MATERIAL_EFFECT_ID
{
public string Value;
public bool IsValid => !string.IsNullOrEmpty(Value);
// implicit operators for string 호환
}
Selector/Drawer 규약 (12-asset-id 준수)
필수 규칙
- Apply/Create 버튼 금지
- ShowUtility() 필수
- Selector 캐싱 금지
- 클릭 즉시 적용 + 창 자동 닫기
SearchDir 공급
- BundleSettings.GetEntry(
"MATERIAL_EFFECT_ID")로 조회 - 실패/폴더 없음이면
"Assets"fallback
스캔 대상
- MaterialEffectAsset(ScriptableObject) 목록을 SearchDir에서 스캔
asset.name을 ID 값으로 사용@prefix 이름 제외- case-insensitive 중복 name은 에러 로그 후 스킵
BundleSettings 등록
entries[MATERIAL_EFFECT_ID] = "Assets/Bundles/MaterialEffects"
Editor 구현
Selector 클래스
public sealed class MaterialEffectIdSelector : BaseEditorScriptableAssetIdSelector<MaterialEffectAsset>
{
protected override string GroupKey => "MATERIAL_EFFECT";
protected override string DisplayTypeName => "MATERIAL_EFFECT_ID";
}
Drawer 클래스
[CustomPropertyDrawer(typeof(MATERIAL_EFFECT_ID))]
public sealed class MATERIAL_EFFECT_ID_Drawer : BaseEditorID_Drawer<MaterialEffectIdSelector>
{
// ShowUtility()로 창 표시
// title: "Select MATERIAL_EFFECT_ID"
}
금지 사항
- Selector 캐싱 금지 (항상 CreateInstance)
- Apply 버튼 금지 (SelectionGrid 클릭 즉시 적용/닫기)
- 런타임에서 AssetDatabase/Resources.Load 금지 (AssetManager 캐시만)
Reference
- Parent:
skills/devian-unity/20-common-package/00-overview/SKILL.md - AssetId Base:
skills/devian-unity/20-common-package/12-asset-id/SKILL.md - MaterialEffect:
skills/devian-unity/20-common-package/23-material-effect-controller/SKILL.md