AGENT SKILL

24-material-effect-id

暂无简介

License 许可
MIT
所属仓库
devwinsoft/devian
最近更新
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

04 同仓库更多 Skills