Windowsカーソルの変更(OSネイティブ方式)【Unity6】

Unity技術

Gameアプリ内のカーソルをWindowsカーソルから任意の画像カーソルに変更する方法です。

Unity6 (URP) 環境において、Windowsウィンドウモード時の描画残存や遅延を解消し、
堅牢かつ軽快に動く OSネイティブ方式(Cursor.SetCursor)を採用しています 。

簡易版

  1. カーソル画像のインポート設定
  2. スクリプト作成・CustomCursorManager.cs
  3. スクリプト作成・UICursorTrigger.cs(ホバー・クリック時にも変更したい場合)
  4. 配置設定・CustomCursorManager.csをオブジェクトにアタッチ。
  5. 配置設定・UICursorTrigger.csをオブジェクトにアタッチ。(ホバー・クリック時にも変更したい場合)

OSネイティブ方式

システムの全体像(アーキテクチャ)

[ Game Start (最初のScene) ]
       ↓
┌──────────────────────────────────────┐
│ CustomCursorManager (Singleton)│ ─── (DontDestroyOnLoadで全Scene維持) │
└──────────────┬───────────────────────┘
               ↓ 上書き指示 / 解除
┌───────────────────────────────────┐
│       UICursorTrigger         │ ─── 各Sceneのボタン等にアタッチ │
└───────────────────────────────────┘
  • CustomCursorManager.cs:
    • ゲーム全体のカーソル画像と状態(デフォルト状態 / ホバー状態 / クリック状態)を一元管理。
      最初のシーンに1つだけ配置。
  • UICursorTrigger.cs:
    • カーソル変化を起こしたいUI(ボタンなど)に配置し、
      マウスイベント(Enter/Exit/Down/Up)を検知してManagerに指示を送る。

CustomCursorManager.cs

using UnityEngine;

public class CustomCursorManager : MonoBehaviour
{
    public static CustomCursorManager Instance { get; private set; }

    [Header("Default Cursor Settings")]
    [SerializeField] private Texture2D defaultCursorTexture;
    
    // カーソルのクリック判定(先端)の位置 offset。左上先端なら (0,0)
    [SerializeField] private Vector2 defaultHotspot = Vector2.zero;

    private void Awake()
    {
        // シングルトン&シーン非破壊の設定
        if (Instance == null)
        {
            Instance = this;
            DontDestroyOnLoad(gameObject);
        }
        else
        {
            Destroy(gameObject);
            return;
        }

        ResetToDefault();
    }

    /// <summary>
    /// カーソルを指定したテクスチャ・ホットスポットに一時上書きする
    /// </summary>
    public void SetOverrideCursor(Texture2D texture, Vector2 hotspot)
    {
        if (texture == null) return;
        Cursor.SetCursor(texture, hotspot, CursorMode.Auto);
    }

    /// <summary>
    /// デフォルトのカーソルに戻す
    /// </summary>
    public void ClearOverrideCursor()
    {
        ResetToDefault();
    }

    private void ResetToDefault()
    {
        if (defaultCursorTexture != null)
        {
            Cursor.SetCursor(defaultCursorTexture, defaultHotspot, CursorMode.Auto);
        }
        else
        {
            Cursor.SetCursor(null, Vector2.zero, CursorMode.Auto);
        }
    }
}

UICursorTrigger.cs

using UnityEngine;
using UnityEngine.EventSystems;

public class UICursorTrigger : MonoBehaviour, 
    IPointerEnterHandler, 
    IPointerExitHandler, 
    IPointerDownHandler, 
    IPointerUpHandler
{
    [Header("Hover Settings")]
    [SerializeField] private Texture2D hoverTexture;
    [SerializeField] private Vector2 hoverHotspot = Vector2.zero;

    [Header("Click (Press) Settings")]
    [SerializeField] private Texture2D clickTexture;
    [SerializeField] private Vector2 clickHotspot = Vector2.zero;

    private bool isHovering = false;
    private bool isPressed = false;

    public void OnPointerEnter(PointerEventData eventData)
    {
        isHovering = true;
        UpdateCursorState();
    }

    public void OnPointerExit(PointerEventData eventData)
    {
        isHovering = false;
        isPressed = false;
        UpdateCursorState();
    }

    public void OnPointerDown(PointerEventData eventData)
    {
        if (eventData.button != PointerEventData.InputButton.Left) return;

        isPressed = true;
        UpdateCursorState();
    }

    public void OnPointerUp(PointerEventData eventData)
    {
        if (eventData.button != PointerEventData.InputButton.Left) return;

        isPressed = false;
        UpdateCursorState();
    }

    private void UpdateCursorState()
    {
        if (CustomCursorManager.Instance == null) return;

        if (isPressed && clickTexture != null)
        {
            CustomCursorManager.Instance.SetOverrideCursor(clickTexture, clickHotspot);
        }
        else if (isHovering && hoverTexture != null)
        {
            CustomCursorManager.Instance.SetOverrideCursor(hoverTexture, hoverHotspot);
        }
        else
        {
            CustomCursorManager.Instance.ClearOverrideCursor();
        }
    }

    private void OnDisable()
    {
        // UIが非アクティブ化(閉じた時など)された際の安全対策
        if (isHovering || isPressed)
        {
            isHovering = false;
            isPressed = false;
            if (CustomCursorManager.Instance != null)
            {
                CustomCursorManager.Instance.ClearOverrideCursor();
            }
        }
    }
}

アセット(画像)のインポート設定

カーソルとして使用するすべての画像(.png 等)に対して、以下のインポート設定を適用します。

設定項目設定値理由
Texture TypeCursorOSネイティブカーソルとして認識させるため
Read/WriteON (チェックあり)必須。メモリ上のピクセルデータへのアクセスを許可するため
Alpha SourceInput Texture Alpha透明部分を正しく切り抜くため
Max Size任意(128 / 256 等)元画像のサイズに合わせて設定

スクリプト設定の手順

1. CustomCursorManager.cs を
最初(タイトルやローディング等)のシーンにある空のGameObject(名前: CursorManager)にアタッチします。

2. 用意したカーソル画像を「Default Cursor Texture」にアサインします。
通常カーソルの変更は以上となります。

3. 任意のオブジェクトにホバーした時などに、カーソルを変更する機能追加は、
UICursorTrigger.cs をホバー・クリック時にカーソルを変えたいUIボタン等にアタッチします。

4. 用意したカーソル画像を「Hover Texture」「Click Texture」にそれぞれアサインします。
変化カーソルの設定は以上となります。

今後の運用・拡張時の注意点

  1. 2つ目以降のSceneへの配置
    • 2つ目以降のシーンには CursorManager を配置しないでください。
      (配置しても自動破壊されますが、不要な処理を避けるため)
    • UICursorTrigger はシーンを問わずどのUIボタンにアタッチしても、
      自動的にシングルトン(Instance)を参照して動作します。
  2. ホットスポット(Hotspot)の調整
    • 矢印カーソル:(0, 0)(画像の左上)
    • ターゲット・照準マーク:(画像幅/2, 画像高さ/2)(画像の中央)
  3. 3Dオブジェクト(NPCや宝箱)への横展開
    • 将来的に3Dオブジェクトにカーソルを合わせた際も変えたい場合、
      3Dオブジェクトに Collider を付けて OnMouseEnter / OnMouseExit / OnMouseDown から CustomCursorManager.Instance.SetOverrideCursor() を呼ぶだけで、全く同じロジックで展開可能です。

コメント