エディター拡張を作成する方法 [Unity]

using UnityEditor;

public static class MyTools
{
    [MenuItem("MyTools/Message %#m")]
    public static void Message()
    {
        EditorUtility.DisplayDialog("Message", "Hello, World!", "OK");
    }
}
Code language: C# (cs)

修飾キー

%：Ctrl キー / Command キー
#：Shift キー
&：Alt キー / Option キー

参考：

MenuItem でショートカットキーを登録 | コガネブログ

MenuItem にショートカットキーを設定する | LIGHT11

Unity の Editor を拡張して自前のメニュー項目を表示する | かめくめ

独自のショートカットキーを作成する | kan のメモ帳

MenuItem で指定したショートカットキーを無効化する – Qiita

Editor 拡張でショートカットキーをカスタマイズ – Qiita

MenuItem | Unity Scripting API [Official]

ダイアログを表示する

参考：

簡単なメッセージボックスをつくる | プログラムは、用いる言葉の選択で決まる

エディタ拡張で確認するためのウィンドウである EditorUtility.DisplayDialog と DisplayDialogComplex | kan のメモ帳

Unity Editor で確認ダイアログを表示する | うにてぃブログ

EditorUtility.DisplayDialog | Unity スクリプトリファレンス [公式]

EditorUtility.DisplayDialogComplex | Unity スクリプトリファレンス [公式]

How to Show a Confirmation Dialog | Kindacode

ポップアップウィンドウを表示する

参考：

Tooltip のようなポップアップを表示する | LIGHT11

テキスト入力用ポップアップを実装する | LIGHT11

UnityEditor.PopupWindow | Unity スクリプトリファレンス [公式]

Property Drawer

参考：

自分だけの Property Drawer を作ろう！ – Qiita

Property Drawer | Unity マニュアル [公式]

カスタムエディター

CustomEditor 属性 (→ CustomEditor )
Editor クラス (→ UnityEditor.Editor )

こちらのページを参照

インスペクターをカスタマイズする方法 (Custom Editor)

参考：

Unity の Editor 拡張をしてインスペクタをカスタマイズする | かめくめ

Unity の Inspector を拡張する – Qiita

カスタムエディター | Unity 2018.4 マニュアル [公式]

カスタムエディター | Unity マニュアル [公式]

UnityEditor.Editor | Unity スクリプトリファレンス [公式]

UnityEditor.CustomEditor | Unity スクリプトリファレンス [公式]

CreateAssetMenu 属性

参考：

UnityEngine.CreateAssetMenuAttribute | Unity スクリプトリファレンス [公式]

UI Toolkit

参考：

UI Toolkit をランタイム UI として使ってみる – Qiita

Unity の UI Toolkit のランタイムサンプルを試す | Mitsuhiro Koga

Unity 新UIシステム UI Toolkit 触ってみた | CyberAgent

UI Toolkit に触れてみた | ファブテラスいわて

Unity の UI Toolkit 試してみる | しっぽを追いかけて

UI Toolkit で多人数開発は可能なのか？シンプルな画面遷移を作って検証してみる | Sumzap Engineering Blog

UI Toolkit メモ | フレームシンセシス

UI Toolkit | Unity 2020.3 マニュアル [公式]

UI ツールキット | Unity [公式]

UI Toolkit: First Steps | Unity Learn [Official]

要素にスタイルを適用する

GUI.skin からスタイルを複製して使用する。

GUIStyle style = new GUIStyle(GUI.skin.button);
Code language: C# (cs)

または、文字列で要素の種類を指定してインスタンスを生成する。

GUIStyle style = new GUIStyle("button");
Code language: C# (cs)

参考：

Label に色をつける | ざきのメモ

Label の装飾 | gologius の巣

GUIStyle でエディタの色を変えてみたよ | 徳島ゲーム開発ごっこ

EditorWindow で GUIStyle を使う際の注意 | うにてぃブログ

EditorStyles で使えるスキン一覧 | うにてぃブログ

GUIStyle で使用できる文字列の一覧を表示するエディタ拡張 | コガネブログ

Unity の GUIStyle でデフォルトで指定できるスタイル一覧 | A-Liaison BLOG

UnityEngine.GUIStyle | おなかすいたWiki！

GUI Style (IMGUI) | Unity マニュアル [公式]

GUI スキン (IMGUI) | Unity マニュアル [公式]

UnityEngine.GUIStyle | Unity スクリプトリファレンス [公式]

UnityEngine.GUISkin | Unity スクリプトリファレンス [公式]

GUI.skin | Unity スクリプトリファレンス [公式]

UnityEditor.EditorStyles | Unity スクリプトリファレンス [公式]

USS

参考：

Unity 2019.3 で UIElements を使用してエディタの色を変更してみる | コガネブログ

Unity 2019.3 で UIElements を使用して Inspector の余白を減らす | コガネブログ

エディタの UI の色や形をスタイルシートで変えられる (2020.2b 新機能) | コガネブログ

Style UI with USS | Unity Manual [Official]

USS Custom Properties (Variables) | Unity Manual [Official]

Built-in Unity Variables | Unity Manual [Official]

Editor skinning thread – Unity Forum

why have you made your entire gui look like garbage now? – Unity Forum

Scripts for using Sass and Slim for UIElements layouts – Unity Forum

スクロールビュー

参考：

描画範囲が足りなければスクロールを実装するたった3行のコード | kan のメモ帳

Unity の Scroll View で一覧表示を作成する | TECH Projin

Scroll View の使い方、スクリプトからテキスト一覧表示の設定をする | 中堅プログラマーの備忘録

スクロールビューの基本と軽量なスクロールリストビューの作り方 – Qiita

スクロールビューでアイテム一覧を作成する | りつかのゲーム開発雑記ブログ

難解な Scroll View の基礎をわかりやすく解説 | hirokuma.blog

Scroll View を理解したい | 怠惰な日々にさよならを

意外と簡単！ Unity でスクロールバーを実装する方法 | workpress

Scroll View – 範囲内に自動的にスクロールバーを出す | ケットシーウェア

Unity の Scroll View の使い方 | なんとかするから、なんとかなる

Scroll View の中身にサイズが一致せずスクロールしないときの対処 | JoyPlot

EditorGUILayout.BeginScrollView | Unity スクリプトリファレンス [公式]

EditorGUILayout.EndScrollView | Unity スクリプトリファレンス [公式]

Scroll Rect | Unity マニュアル [公式]

uGUI のスクロールがうまく表示できません – teratail

Custom inspector too tall causes horizontal scrollbar? – Unity Forum

Why the BeginScrollView is working fine in the inspector editor script but it’s not working in the editor window script? – Stack Overflow

プレビュー

参考：

プレビューなどに使う一時的なレンダリング用シーン (Preview Scene) の作り方 | LIGHT11

UnityEditor.AssetPreview | Unity スクリプトリファレンス [公式]

Editor.DrawPreview | Unity スクリプトリファレンス [公式]

Editor.HasPreviewGUI | Unity スクリプトリファレンス [公式]

Editor.OnPreviewGUI | Unity スクリプトリファレンス [公式]

Editor.OnInteractivePreviewGUI | Unity スクリプトリファレンス [公式]

UnityCsReference/Editor/Mono/Inspector/PreviewRenderUtility.cs – GitHub

Modifying asset preview in Project – Unity Forum

Display a preview image in the GUI editor – Unity Forum

How to handle AssetPreview.GetAssetPreview() – Unity Forum

Changing the preview image? – Unity Forum

プロジェクトウィンドウ (Project Window)

参考：

EditorApplication.projectWindowItemOnGUI | Unity スクリプトリファレンス [公式]

EditorApplication.RepaintProjectWindow | Unity スクリプトリファレンス [公式]

UnityEditor.EditorApplication | Unity スクリプトリファレンス [公式]

エディターツール (Editor Tools)

EditorTool

動画：

Editor Tools という機能について

参考：

エディタの左上に独自の機能を追加出来る EditorTool | kan のメモ帳

Unity 2019.1 から導入された EditorTool の紹介 | Yucchiy’s Note

EditorTools.EditorTool | Unity スクリプトリファレンス [公式]

Tools API – Unity Forum

ツールバーにボタンを追加する

参考：

Unity のツールバーに特定シーン再生ボタンを追加する方法 – Qiita

エディタのツールバーの部分にボタンを追加してみる | コガネブログ

Toolbar Extender – エディタ上部の再生ボタンの両サイドにボタンを配置できるエディタ拡張 | コガネブログ

シーンビューにボタンを追加する

参考：

UIElements で Scene ビューにツールバーを追加するエディタ拡張のサンプル | コガネブログ

ゲームビューにボタンを追加する

参考：

UIElements で Game ビューにテキストやボタンを追加するエディタ拡張のサンプル | コガネブログ

ExecuteAlways

[ExecuteAlways]：プレイモード／編集モード／プレハブモードの全てでスクリプトが実行される。
[ExecuteInEditMode]：※廃止
Application.IsPlaying：ゲームオブジェクトがプレイモードに存在しているか判定する。

参考：

ExecuteAlways について | albatrus のブログ

Unity 2018.3 以降 ExecuteInEditMode アトリビュートは廃止に向かっていく | LIGHT11

ExecuteInEditMode を使うと編集中も処理を実行可能 | 強火で進め

スクリプトを Editor 上で動作させる | うにてぃブログ

スクリプトを Edit モードで実行 – Qiita

ExecuteInEditMode と関連コンポーネントの破棄対応について | ケットシーウェア

UnityEngine.ExecuteAlways | Unity スクリプトリファレンス [公式]

UnityEngine.ExecuteInEditMode | Unity 2019.4 スクリプトリファレンス [公式]

Application.IsPlaying | Unity スクリプトリファレンス [公式]

ExecuteInEditMode 終了の方法 – teratail

特定のシーンを再生する

参考：

Unity のツールバーに特定シーン再生ボタンを追加する方法 – Qiita

エディタ上でも Scenes in Build の一番上に登録されているシーンから再生を開始する | kan のメモ帳

ボタンを無効化する

参考：

エディタ拡張で押せないボタンを作る | はなちるのマイノート

EditorGUI.BeginDisabledGroup | Unity スクリプトリファレンス [公式]

EditorGUI.EndDisabledGroup | Unity スクリプトリファレンス [公式]

UnityEditor.DisabledScope | Unity スクリプトリファレンス [公式]

再生モードを判定する

EditorApplication.isPlaying

参考：

EditorApplication.isPlaying | Unity スクリプトリファレンス [公式]

#if UNITY_EDITOR stuff getting called at runtime as well? – Unity Answers

エディター環境のみでコードを実行する

エディター環境でのみコードをコンパイルして実行させるには、該当する範囲を UNITY_EDITOR マクロを使用して #ifdef / #endif ディレクティブで囲う。

#idef UNITY_EDITOR
// code here only for editor
#endif
Code language: C# (cs)

参考：

UNITY_EDITOR | Unity 2018.4 マニュアル [公式]

Update() only in Edit mode – Unity Answers

シリアル化／値を保持する

SerializeField

こちらのページを参照

シリアライズドオブジェクトの扱い (SeriazliedObject)

参考：

Unity を閉じても Editor Window の状態を保つ方法 | LIGHT11

スクリプトのシリアル化 | Unity 2020.3 マニュアル [公式]

ビルトインのシリアル化 | Unity マニュアル [公式]

UnityEngine.SerializeField | Unity スクリプトリファレンス [公式]

Serialization | Unity Blog [Official]

Serialize fields only in Editor – Unity Forum

Store editor values between editor sessions – Stack Overflow

非同期処理

参考：

Editor でコルーチンが使える Editor Coroutines の使い方まとめ | LIGHT11

Editor Coroutines – Editor で Coroutineを使う方法！ | dasuko の技術ブログ

Unity の Editor Coroutine Utility を使い、何か重要なバッチを走らせている風なダイアログを作る – Qiita

Editor Coroutine Utility – エディタ拡張でUnityを再生していない時でもコルーチンを使い非同期処理が行える | kan のメモ帳

エディタ拡張でコルーチンを使用できるパッケージが Package Manager からインストールできるようになった | コガネブログ

Editor Coroutines | Unity Manual [Official]

プログレスバー

参考：

Progress – Unity のエディタ拡張時に非同期タスクの進捗状況を表示する | kan のメモ帳

エディタ拡張で進捗状況を表示する | kan のメモ帳

EditorUtility.DisplayCancelableProgressBar で途中でキャンセルも出来る進捗状況の表示 | kan のメモ帳

UnityEditor.Progress | Unity スクリプトリファレンス [公式]

EditorUtility.DisplayCancelableProgressBar | Unity スクリプトリファレンス [公式]

EditorUtility.DisplayProgressBar | Unity スクリプトリファレンス [公式]

EditorGUILayout

こちらのページを参照

EditorGUILayout の使い方

参考：

いろいろな GUI ～ EditorGUILayout 編 | ケットシーウェア

UnityEditor.EditorGUILayout | Unity スクリプトリファレンス [公式]

EditorGUI

ドキュメント：

UnityEditor.EditorGUI | Unity スクリプトリファレンス [公式]

コード：

EditorGUI.cs – GitHub

まとめ／Tips

こちらのページを参照

エディター拡張作成 Tips

参考：

Editor 拡張メモ – Qiita

知っておくと少し幸せになる最低限のエディタ拡張 | テラシュールブログ

エディタ拡張チートシート | LIGHT11

エディター拡張チートシート | Unity でコードから GUI を作る (kumaS)

エディタ拡張の際によく使用する、基本的なクラスや関数まとめメモ | Bard は楽して暮らしたい

GUI / GUILayout / EditorGUI / EditorGUILayout の違い | うにてぃブログ

スクリプト集

自作したエディタ拡張 46個まとめ | コガネブログ

知っておくと便利！エディタ拡張まとめ 9選 | CGメソッド

UI 制作に便利！エディタ拡張まとめ 13選 (uGUI) | CGメソッド

インスペクタウィンドウからメソッドを呼ぶ方法色々 | 12px.com

教材

入手：

Unity エディター拡張入門 | 安藤圭吾

チュートリアル

Editor Tools という機能について

Annotation Utility

コード：

AnnotationUtility.bindings.cs at 6f47be358c · Unity-Technologies/UnityCsReference – GitHub

参考：

特定のギズモをオン／オフするエディタ拡張 | MEBIUSTOS のブログ

Scene ビューのすべてのギズモの表示をオフにするエディタ拡張 | コガネブログ

MRDesignLabs_Unity のアイコンの表示／非表示を行うエディタ拡張 | Hiromu ブログ

SceneView のアイコンを表示／非表示するエディタ拡張 – GitHub Gist

How to hide Gizmos by script – Unity Answers

“Uncheck all” in Gizmos menu in Scene view? – Unity Answers

visible / hidden gizmos – Stack Overflow

Game View Size Helper

リポジトリ：

anchan828/unity-GameViewSizeHelper: Script から GameViewSize を作成、また設定するヘルパークラス – GitHub

参考：

Game View Size Helper で Game ビューの解像度を変更した後に UI の描画位置を更新する方法 | コガネブログ

Hierarchy Pro

入手：

Hierarchy Pro 2021 | Unity Asset Store [Official]

Hierarchy Pro 2021 – Extended | Unity Asset Store [Official]

Persistent Among Play Mode

リポジトリ：

tsubaki/SerializedParameter_Unity – GitHub

参考：

エディタでゲーム再生中に変更した値を停止しても消さないその２ | テラシュールブログ

Property Drawer Collection

リポジトリ：

anchan828/property-drawer-collection: カスタムプロパティの作品集 – GitHub

UIElements-Sass

リポジトリ：

eidetic-av/UIElements-Sass: Create Unity UIElements USS Stylesheets using the Sass language – GitHub

Unity Utils (uranuno)

Tag and Layer Attribute
Min Max
PlayerPrefs Data

リポジトリ：

uranuno/UnityUtils: My Unity Utils – GitHub

参考：

値の最小値と最大値をいい感じに入力する Property Drawer | uranuno

記事をシェアする：