Gameアプリ内のカーソルをWindowsカーソルから任意の画像カーソルに変更する方法です。
Unity6 (URP) 環境において、Windowsウィンドウモード時の描画残存や遅延を解消し、
堅牢かつ軽快に動く OSネイティブ方式(Cursor.SetCursor)を採用しています 。
簡易版
- カーソル画像のインポート設定
- スクリプト作成・CustomCursorManager.cs
- スクリプト作成・UICursorTrigger.cs(ホバー・クリック時にも変更したい場合)
- 配置設定・CustomCursorManager.csをオブジェクトにアタッチ。
- 配置設定・UICursorTrigger.csをオブジェクトにアタッチ。(ホバー・クリック時にも変更したい場合)
OSネイティブ方式
システムの全体像(アーキテクチャ)
[ Game Start (最初のScene) ]
↓
┌──────────────────────────────────────┐
│ CustomCursorManager (Singleton)│ ─── (DontDestroyOnLoadで全Scene維持) │
└──────────────┬───────────────────────┘
↓ 上書き指示 / 解除
┌───────────────────────────────────┐
│ UICursorTrigger │ ─── 各Sceneのボタン等にアタッチ │
└───────────────────────────────────┘
- CustomCursorManager.cs:
- ゲーム全体のカーソル画像と状態(デフォルト状態 / ホバー状態 / クリック状態)を一元管理。
最初のシーンに1つだけ配置。
- ゲーム全体のカーソル画像と状態(デフォルト状態 / ホバー状態 / クリック状態)を一元管理。
- UICursorTrigger.cs:
- カーソル変化を起こしたいUI(ボタンなど)に配置し、
マウスイベント(Enter/Exit/Down/Up)を検知してManagerに指示を送る。
- カーソル変化を起こしたいUI(ボタンなど)に配置し、
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 Type | Cursor | OSネイティブカーソルとして認識させるため |
| Read/Write | ON (チェックあり) | 必須。メモリ上のピクセルデータへのアクセスを許可するため |
| Alpha Source | Input Texture Alpha | 透明部分を正しく切り抜くため |
| Max Size | 任意(128 / 256 等) | 元画像のサイズに合わせて設定 |

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

2. 用意したカーソル画像を「Default Cursor Texture」にアサインします。
通常カーソルの変更は以上となります。
3. 任意のオブジェクトにホバーした時などに、カーソルを変更する機能追加は、
UICursorTrigger.cs をホバー・クリック時にカーソルを変えたいUIボタン等にアタッチします。

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


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

コメント