unity-editor-tools
Unity 6 editor scripting and custom tools guide. Use when creating custom inspectors, EditorWindows, PropertyDrawers, Gizmos, Handles, menu items, or editor extensions. Covers SerializedObject/SerializedProperty pattern, AssetDatabase, and editor-only code with #if UNITY_EDITOR. Based on Unity 6.3 LTS documentation.
Nice-Wolf-Studio · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Nice-Wolf-Studio/unity-claude-skills --skill unity-editor-tools技能说明
name: unity-editor-tools description: > Unity 6 editor scripting and custom tools guide. Use when creating custom inspectors, EditorWindows, PropertyDrawers, Gizmos, Handles, menu items, or editor extensions. Covers SerializedObject/SerializedProperty pattern, AssetDatabase, and editor-only code with #if UNITY_EDITOR. Based on Unity 6.3 LTS documentation.
Unity Editor Tools
Editor Scripting Overview
Editor scripts extend the Unity Editor with custom inspectors, windows, tools, and workflows. All editor code must either live in an Editor/ folder or be wrapped in #if UNITY_EDITOR / #endif -- this ensures editor code is stripped from runtime builds.
Unity 6.3 supports two GUI frameworks for editor extensions:
| Framework | Status | Entry Point |
|---|---|---|
| UI Toolkit | Recommended | CreateInspectorGUI() / CreateGUI() returning VisualElement |
| IMGUI | Legacy, fully functional | OnInspectorGUI() / OnGUI() |
Key base classes: Editor, EditorWindow, PropertyDrawer, DecoratorDrawer, ScriptableWizard.
Custom Inspector (Editor)
Derive from Editor, apply [CustomEditor(typeof(TargetType))]. See references/custom-inspectors.md for full guide.
UI Toolkit (Recommended)
[CustomEditor(typeof(MyPlayer))]
public class MyPlayerEditor : Editor
{
public override VisualElement CreateInspectorGUI()
{
VisualElement root = new VisualElement();
var visualTree = Resources.Load("MyPlayerEditor") as VisualTreeAsset;
visualTree.CloneTree(root);
return root;
}
}
When CreateInspectorGUI() is overridden, OnInspectorGUI() is ignored.
IMGUI with SerializedObject Pattern
[CustomEditor(typeof(LookAtPoint))]
[CanEditMultipleObjects]
public class LookAtPointEditor : Editor
{
SerializedProperty lookAtPoint;
void OnEnable() { lookAtPoint = serializedObject.FindProperty("lookAtPoint"); }
public override void OnInspectorGUI()
{
serializedObject.Update();
EditorGUILayout.PropertyField(lookAtPoint);
serializedObject.ApplyModifiedProperties();
}
}
Key Members
| Member | Description |
|---|---|
target / targets | Inspected object(s) |
serializedObject | SerializedObject for the target(s) |
DrawDefaultInspector() | Renders built-in default inspector |
OnSceneGUI() | Draw interactive Handles in Scene View |
Scene View Integration
public void OnSceneGUI()
{
var t = (LookAtPoint)target;
EditorGUI.BeginChangeCheck();
Vector3 pos = Handles.PositionHandle(t.lookAtPoint, Quaternion.identity);
if (EditorGUI.EndChangeCheck())
{
Undo.RecordObject(target, "Move look-at point");
t.lookAtPoint = pos;
}
}
PropertyDrawer and PropertyAttribute
Customize how serialized fields appear in the Inspector. See references/property-drawers.md for full guide.
1. Define attribute (runtime code, outside Editor folder):
public class MyRangeAttribute : PropertyAttribute
{
public readonly float min, max;
public MyRangeAttribute(float min, float max) { this.min = min; this.max = max; }
}
2. Implement drawer (Editor folder):
[CustomPropertyDrawer(typeof(MyRangeAttribute))]
public class MyRangeDrawer : PropertyDrawer
{
public override void OnGUI(Rect position, SerializedProperty property, GUIContent label)
{
MyRangeAttribute range = (MyRangeAttribute)attribute;
if (property.propertyType == SerializedPropertyType.Float)
EditorGUI.Slider(position, property, range.min, range.max, label);
else if (property.propertyType == SerializedPropertyType.Integer)
EditorGUI.IntSlider(position, property, (int)range.min, (int)range.max, label);
}
}
Critical rules: Must be in Editor/ folder. Use EditorGUI (not EditorGUILayout). Use EditorGUI.BeginProperty()/EndProperty() for prefab overrides. Cannot mix UI Toolkit and IMGUI in one drawer.
EditorWindow
Custom dockable editor windows. See references/editor-windows.md for full guide.
Lifecycle: OnEnable -> CreateGUI -> Update -> OnGUI -> OnDisable
public class MyToolWindow : EditorWindow
{
[MenuItem("Tools/My Tool Window")]
public static void ShowWindow()
{
var window = GetWindow<MyToolWindow>();
window.titleContent = new GUIContent("My Tool");
window.minSize = new Vector2(300, 200);
}
public void CreateGUI()
{
rootVisualElement.Add(new Label("Hello from UI Toolkit!"));
rootVisualElement.Add(new Button(() => Debug.Log("Clicked!")) { text = "Click Me" });
}
}
| Static Method | Description |
|---|---|
GetWindow<T>() | Get existing or create new |
CreateWindow<T>() | Always create new instance |
HasOpenInstances<T>() | Check if open |
| Display Mode | Behavior |
|---|---|
Show() | Standard dockable |
ShowUtility() | Floating, not dockable |
ShowModal() | Modal dialog |
ShowAsDropDown() | Dropdown popup |
MenuItem
The [MenuItem] attribute converts static methods into menu commands.
[MenuItem("Menu/Path/Item Name", isValidateFunction, priority)]
| Prefix | Placement |
|---|---|
"Tools/..." | Custom tools menu |
"Assets/..." | Assets menu + Project context menu |
"GameObject/..." | GameObject menu + Hierarchy context menu |
"CONTEXT/ComponentType/..." | Component context menu |
Shortcut modifiers: % = Cmd/Ctrl, # = Shift, & = Alt, ^ = Ctrl (all), _ = no modifier.
// Validation function controls when menu item is enabled
[MenuItem("Tools/Reset Position", true)]
static bool ValidateResetPosition() => Selection.activeTransform != null;
[MenuItem("Tools/Reset Position", false)]
static void ResetPosition()
{
Undo.RecordObject(Selection.a
阅读完整来源 ↗