演出スクリプト一元管理システム★【URP】

Unity技術

採用しているコマンド式で各演出スクリプト(点滅・シェイクや移動など)を行うと、
複数適用したい場合に競合やバグの温床になりかねないので、演出スクリプト管理システムを導入しました。
※演出スクリプトにはDOTWeenは採用していません。

システムの概要と設計目的

本システムは、Unity(Unity 6000.3.10.URP)を用いたゲーム開発において、オブジェクトの視覚演出(点滅、フェード、移動、回転、揺れなど)の管理方法を標準化し、「シンプル・堅牢・拡張性」を維持することを目的としています。

  • 司令塔の設置:すべての演出は Sys_ObjectEffectController を介して一元管理する。
  • 共通規格の徹底:IObjectEffect インターフェースによるポリモーフィズム設計の採用。
  • 命名規則の統一:個別演出スクリプトはすべて OE_(ObjectEffect) 接頭辞に統一し、自律的な単体動作を廃してコントローラーによる完全制御へ一本化。
  • 競合の根本解消(新設計)★:個別スクリプトによる transform や RectTransform の直接上書きを廃し、コントローラーによる「ベース移動量」と「揺れオフセット」の一括合算適用型へ刷新。
    これにより、移動中にシェイクが停止する不具合を構造的に解消。

コア設計・運用ルール

  • コントローラー一元化の原則
    • 演出の数や種類(1つであっても、複数組み合わせる場合でも)に関わらず、演出を持つオブジェクトには必ず Sys_ObjectEffectController をアタッチする。
    • 個別演出スクリプト自体には自動再生フラグを持たせず、すべてコントローラーからの指令(Play())に依存する「純粋なパーツ」として設計する。
  • インスペクター管理の簡素化
    コントローラー側のリスト(Effect Modules)の型を MonoBehaviour にし、対象オブジェクトにアタッチされている個別の演出コンポーネントを直接ドラッグ&ドロップして登録する。
  • ロースペックPCおよびパフォーマンスへの配慮
    DOTween依存の処理を廃止し、Update による軽量な線形補間(Mathf.Lerp, Mathf.PingPong, PerlinNoise 等)へリファクタリング。GC(ガベージコレクション)の発生を抑え、堅牢な動作を担保。
  • 新規追加・実装時の鉄則★:個別スクリプト内で transform.position や anchoredPosition などの位置・回転・スケールを直接書き換えてはならない。
    位置の移動・変形は変化量を計算して GetPositionDelta() 等で返し、揺れは GetPositionOffset() で返し、最終的な transform / RectTransform への適用はコントローラー側で1フレームに1回まとめて行う。
    この責務分離のパイプラインを絶対に崩さないこと。
    ※なお、アルファ値(フェードや点滅)を操作する系は位置情報と競合しないため、
    従来通り SpriteRenderer や CanvasGroup を直接操作する形で問題ない。

実装済みコンポーネント一覧と仕様

司令塔コントローラー

  • Sys_ObjectEffectController
  • リスト形式(List<MonoBehaviour>)で複数の演出モジュールを管理。
  • 指令を受け取ると、登録されたコンポーネントの Play() を一括または順次実行。
using System.Collections.Generic;
using UnityEngine;

public class Sys_ObjectEffectController : MonoBehaviour, ILoadableComponent
{
    [Header("実行設定")]
    [Tooltip("有効なモジュールをOnEnable時に一括で再生するか")]
    public bool playOnEnable = true;

    [Header("アタッチされている演出リスト")]
    [SerializeField] private List<MonoBehaviour> effectModules = new List<MonoBehaviour>();

    private Vector3 _initialLocalPosition;
    private Quaternion _initialLocalRotation;
    private Vector3 _initialLocalScale;
    private List<IObjectEffect> _effects = new List<IObjectEffect>();

    void Awake()
    {
        _initialLocalPosition = transform.localPosition;
        _initialLocalRotation = transform.localRotation;
        _initialLocalScale = transform.localScale;

        _effects.Clear();
        foreach (var module in effectModules)
        {
            if (module is IObjectEffect effect)
            {
                _effects.Add(effect);
            }
        }
    }

    void OnEnable()
    {
        Sys_LoadableRegistry.Register(this);

        if (Sys_SaveManager.IsLoading) return;

        if (playOnEnable)
        {
            PlayAllEffects();
        }
    }

    void OnDisable()
    {
        Sys_LoadableRegistry.Unregister(this);
    }

    public void OnLoadCompleted()
    {
        if (playOnEnable && gameObject.activeInHierarchy)
        {
            PlayAllEffects();
        }
    }

    public void PlayAllEffects()
    {
        foreach (var effect in _effects)
        {
            if (effect is MonoBehaviour mb && mb.enabled)
            {
                effect.Play();
            }
        }
    }

    void Update()
    {
        Vector3 posDelta = Vector3.zero;
        Vector3 posOffset = Vector3.zero;
        Vector3 rotDelta = Vector3.zero;
        Vector3 scaleDelta = Vector3.one;

        foreach (var effect in _effects)
        {
            if (effect is MonoBehaviour mb && !mb.enabled) continue;

            posDelta += effect.GetPositionDelta();
            posOffset += effect.GetPositionOffset();
            rotDelta += effect.GetRotationDelta();
            scaleDelta = Vector3.Scale(scaleDelta, effect.GetScaleDelta());
        }

        transform.localPosition = _initialLocalPosition + posDelta + posOffset;
        transform.localScale = Vector3.Scale(_initialLocalScale, scaleDelta);

        // クォータニオンを用いたローカル回転の加算(360度超え・ループ対応、ロースペック負荷軽減)
        if (rotDelta != Vector3.zero)
        {
            transform.localRotation *= Quaternion.Euler(rotDelta);
        }
    }
}

共通インターフェース

  • IObjectEffect
  • すべての個別演出スクリプトが実装する共通規格。
    最低限 Play() や Stop() などの共通メソッドを保証。
using UnityEngine;

public interface IObjectEffect
{
    void Play();
    void Stop();

    // 位置・回転・スケールの影響をそれぞれ返す(デフォルトは無効な値)
    Vector3 GetPositionDelta() => Vector3.zero;
    Vector3 GetPositionOffset() => Vector3.zero;
    Vector3 GetRotationDelta() => Vector3.zero;
    Vector3 GetScaleDelta() => Vector3.one;
}

個別演出スクリプト群(すべて OE_ プレフィックスに統一)

点滅

  • OE_Blink_Object
  • SpriteRenderer を対象に、指定したサイクルと回数で点滅(透明度変化)を行うスクリプト。
    完了時の非アクティブ化(deactivateOnComplete)に対応。
using UnityEngine;

[RequireComponent(typeof(SpriteRenderer))]
public class OE_Blink_Object : MonoBehaviour, IObjectEffect
{
    [Header("点滅の設定")]
    [Tooltip("1往復にかかる時間(秒)")]
    public float cycleDuration = 0.5f;

    [Tooltip("点滅させる回数(loopがfalseの場合に有効)")]
    public int blinkCount = 3;

    [Tooltip("無限にループさせるか")]
    public bool loop = false;

    [Tooltip("最小の透明度")]
    [Range(0f, 1f)]
    public float minAlpha = 0f;

    [Tooltip("最大の透明度")]
    [Range(0f, 1f)]
    public float maxAlpha = 1f;

    [Header("完了時の処理")]
    [Tooltip("点滅(指定回数)が完了した時に、オブジェクトを非アクティブにするか")]
    public bool deactivateOnComplete = false;

    [Tooltip("開始までの遅延時間")]
    public float startDelay = 0f;

    private SpriteRenderer _spriteRenderer;
    private bool _isBlinking = false;
    private float _delayTimer = 0f;
    private float _elapsedTime = 0f;
    private int _currentBlinkCount = 0;

    void Awake() => _spriteRenderer = GetComponent<SpriteRenderer>();

    void OnEnable()
    {
        if (_spriteRenderer == null) _spriteRenderer = GetComponent<SpriteRenderer>();
        if (Sys_SaveManager.IsLoading) SetAlpha(maxAlpha);
    }

    public void Play()
    {
        if (_spriteRenderer == null) _spriteRenderer = GetComponent<SpriteRenderer>();
        SetAlpha(maxAlpha);
        _delayTimer = startDelay;
        _elapsedTime = 0f;
        _currentBlinkCount = 0;
        _isBlinking = true;
    }

    public void Stop() { _isBlinking = false; SetAlpha(maxAlpha); }

    void Update()
    {
        if (!_isBlinking || _spriteRenderer == null) return;
        if (_delayTimer > 0f) { _delayTimer -= Time.deltaTime; return; }
        if (cycleDuration <= 0f) return;

        _elapsedTime += Time.deltaTime;
        float t = Mathf.PingPong(_elapsedTime, cycleDuration) / cycleDuration;
        SetAlpha(Mathf.Lerp(minAlpha, maxAlpha, t));

        if (_elapsedTime >= cycleDuration)
        {
            _elapsedTime -= cycleDuration;
            _currentBlinkCount++;
            if (!loop && _currentBlinkCount >= blinkCount)
            {
                SetAlpha(maxAlpha);
                _isBlinking = false;
                if (deactivateOnComplete) gameObject.SetActive(false);
            }
        }
    }

    private void SetAlpha(float alpha)
    {
        if (_spriteRenderer != null)
        {
            Color c = _spriteRenderer.color;
            c.a = alpha;
            _spriteRenderer.color = c;
        }
    }

    void OnDisable() { _isBlinking = false; SetAlpha(maxAlpha); }
}

シェイク

  • OE_Shake_Object
  • パーリンノイズを用いて、位置ズレのない滑らかな揺れ(シェイク)を演出するスクリプト。
    完了時の非アクティブ化(deactivateOnComplete)に対応。
using UnityEngine;

public class OE_Shake_Object : MonoBehaviour, IObjectEffect
{
    [Header("揺れの設定")]
    [Tooltip("揺れの強さ(X, Yの振れ幅)")]
    public Vector3 shakePower = new Vector3(10f, 10f, 0f);

    [Tooltip("揺れの速さ(周波数)")]
    public float frequency = 25f;

    [Tooltip("継続時間(秒)。0以下にすると無限(ループ)になります")]
    public float duration = 0f;

    [Tooltip("ループを有効にするか(durationに関わらず揺れ続ける場合などに使用)")]
    public bool loop = false;

    [Tooltip("開始までの遅延時間")]
    public float startDelay = 0f;

    [Header("終了時の処理")]
    [Tooltip("揺れ(指定時間)が終了した際に、オブジェクトを非アクティブにするか")]
    public bool deactivateOnComplete = false;

    private bool _isShaking = false;
    private float _delayTimer = 0f;
    private float _durationTimer = 0f;

    // サイン波の位相ズレ用シード
    private float _offsetX;
    private float _offsetY;
    private float _offsetZ;

    private Vector3 _currentOffset = Vector3.zero;

    public void Play()
    {
        // 個体ごとの位相差をつけて複数インスタンス時の同期を防ぐ
        _offsetX = Random.value * 50f;
        _offsetY = Random.value * 50f + 10f;
        _offsetZ = Random.value * 50f + 20f;

        _delayTimer = startDelay;
        _durationTimer = duration;
        _isShaking = true;
        _currentOffset = Vector3.zero;
    }

    public void Stop()
    {
        StopShake();
    }

    void Update()
    {
        if (!_isShaking) return;

        if (_delayTimer > 0f)
        {
            _delayTimer -= Time.deltaTime;
            return;
        }

        if (!loop && duration > 0f)
        {
            _durationTimer -= Time.deltaTime;
            if (_durationTimer <= 0f)
            {
                StopShake();

                if (deactivateOnComplete)
                {
                    gameObject.SetActive(false);
                }
                return;
            }
        }

        // Time.time をベースに、複数の異なる周波数を足し合わせる(サイン波合成)
        // これにより、値が同時に「0(停止)」になる瞬間をなくし、滑らかな動きを維持する
        float t = Time.time * frequency;

        // X軸: メイン波形 + 1.3倍の周波数のサブ波形(位相をずらす)
        float x1 = Mathf.Sin(t + _offsetX);
        float x2 = Mathf.Sin((t * 1.3f) + _offsetX * 2f) * 0.5f;
        float offsetX = (x1 + x2) / 1.5f * shakePower.x;

        // Y軸: 異なる周波数比率で同様に合成
        float y1 = Mathf.Sin(t * 1.15f + _offsetY);
        float y2 = Mathf.Sin((t * 0.85f) + _offsetY * 2f) * 0.5f;
        float offsetY = (y1 + y2) / 1.5f * shakePower.y;

        // Z軸
        float z1 = Mathf.Sin(t * 0.9f + _offsetZ);
        float z2 = Mathf.Sin((t * 1.4f) + _offsetZ * 2f) * 0.5f;
        float offsetZ = (z1 + z2) / 1.5f * shakePower.z;

        _currentOffset = new Vector3(offsetX, offsetY, offsetZ);
    }

    public void StopShake()
    {
        _isShaking = false;
        _currentOffset = Vector3.zero;
    }

    public Vector3 GetPositionOffset()
    {
        return _isShaking ? _currentOffset : Vector3.zero;
    }

    void OnDisable()
    {
        StopShake();
    }
}

フェードイン

  • OE_FadeIn_Object
  • SpriteRenderer のアルファ値を 0 から 1 へ補間してフェードインさせるスクリプト。
    完了時の非アクティブ化に対応。
 using UnityEngine;

[RequireComponent(typeof(SpriteRenderer))]
public class OE_FadeIn_Object : MonoBehaviour, IObjectEffect
{
    public float duration = 0.5f;
    public float startDelay = 0f;

    [Header("完了時の処理")]
    [Tooltip("フェードイン完了時にオブジェクトを非アクティブにするか")]
    public bool deactivateOnComplete = false;

    private SpriteRenderer _spriteRenderer;
    private bool _isFading = false;
    private float _delayTimer = 0f;
    private float _elapsedTime = 0f;

    void Awake() => _spriteRenderer = GetComponent<SpriteRenderer>();

    void OnEnable()
    {
        if (_spriteRenderer == null) _spriteRenderer = GetComponent<SpriteRenderer>();
        if (Sys_SaveManager.IsLoading) SetAlpha(1f);
    }

    public void Play()
    {
        if (_spriteRenderer == null) _spriteRenderer = GetComponent<SpriteRenderer>();
        SetAlpha(0f);
        _delayTimer = startDelay;
        _elapsedTime = 0f;
        _isFading = true;
    }

    public void Stop() { _isFading = false; SetAlpha(1f); }

    void Update()
    {
        if (!_isFading) return;
        if (_delayTimer > 0f) { _delayTimer -= Time.deltaTime; return; }

        _elapsedTime += Time.deltaTime;
        float rate = duration > 0f ? Mathf.Clamp01(_elapsedTime / duration) : 1f;
        SetAlpha(rate);

        if (rate >= 1f)
        {
            _isFading = false;
            if (deactivateOnComplete) gameObject.SetActive(false);
        }
    }

    private void SetAlpha(float alpha)
    {
        if (_spriteRenderer != null)
        {
            Color c = _spriteRenderer.color;
            c.a = alpha;
            _spriteRenderer.color = c;
        }
    }

    void OnDisable() { _isFading = false; SetAlpha(1f); }
}

フェードアウト

  • OE_FadeOut_Object
  • SpriteRenderer のアルファ値を 1 から 0 へ補間してフェードアウトさせ、デフォルトで完了時にオブジェクトを非アクティブ化するスクリプト。
using UnityEngine;

[RequireComponent(typeof(SpriteRenderer))]
public class OE_FadeOut_Object : MonoBehaviour, IObjectEffect
{
    public float duration = 0.5f;
    public float startDelay = 0f;

    [Tooltip("フェードアウト完了時にオブジェクトを非アクティブにするか")]
    public bool deactivateOnComplete = false;

    private SpriteRenderer _spriteRenderer;
    private bool _isFading = false;
    private float _delayTimer = 0f;
    private float _elapsedTime = 0f;

    void Awake() => _spriteRenderer = GetComponent<SpriteRenderer>();

    void OnEnable()
    {
        if (_spriteRenderer == null) _spriteRenderer = GetComponent<SpriteRenderer>();
        if (Sys_SaveManager.IsLoading)
        {
            SetAlpha(0f);
            if (deactivateOnComplete) gameObject.SetActive(false);
        }
    }

    public void Play()
    {
        if (_spriteRenderer == null) _spriteRenderer = GetComponent<SpriteRenderer>();
        SetAlpha(1f);
        _delayTimer = startDelay;
        _elapsedTime = 0f;
        _isFading = true;
    }

    public void Stop() => _isFading = false;

    void Update()
    {
        if (!_isFading) return;
        if (_delayTimer > 0f) { _delayTimer -= Time.deltaTime; return; }

        _elapsedTime += Time.deltaTime;
        float rate = duration > 0f ? Mathf.Clamp01(_elapsedTime / duration) : 1f;
        SetAlpha(1f - rate);

        if (rate >= 1f)
        {
            _isFading = false;
            if (deactivateOnComplete) gameObject.SetActive(false);
        }
    }

    private void SetAlpha(float alpha)
    {
        if (_spriteRenderer != null)
        {
            Color c = _spriteRenderer.color;
            c.a = alpha;
            _spriteRenderer.color = c;
        }
    }

    void OnDisable() => _isFading = false;
}

移動

  • OE_Move_xyz
  • 指定したターゲットの位置(Position)・回転(Rotation)・スケール(Scale)へ Update で滑らかに移動・変形させるスクリプト。
using UnityEngine;

public class OE_Move_xyz : MonoBehaviour, IObjectEffect
{
    public Vector3 targetPosition;

    [Header("回転設定")]
    [Tooltip("チェックが入っている場合、ターゲット回転へ向かって回転します。外すと、アタッチ元の回転を完全に維持します(意図しない回転を防ぎます)。")]
    public bool useRotation = true;
    public Vector3 targetRotation;

    public Vector3 targetScale = Vector3.one;
    public float duration = 1f;
    public float startDelay = 0f;
    public bool callEndCutOnComplete = false;

    [Header("終了後の挙動設定")]
    [Tooltip("チェックが入っている場合、移動完了後もターゲット位置に留まります。チェックを外すと、移動が完了した瞬間に元の位置・回転・スケールにパッとワープ(スナップ)して戻ります。")]
    public bool stayAtTarget = true;

    [Header("イージング設定")]
    [Tooltip("チェックが入っている場合、滑らかな加速・減速(SmoothStep)を行います。外すと等速(Linear)になります。")]
    public bool useSmoothStep = true;

    private bool _isMoving = false;
    private bool _isCompleted = false;
    private float _delayTimer = 0f;
    private float _elapsedTime = 0f;

    private Vector3 _startLocalPos;
    private Vector3 _currentMoveDelta = Vector3.zero;

    private Vector3 _startLocalRot;
    private Vector3 _targetRotEulerDiff;
    private Vector3 _currentRotDelta = Vector3.zero;

    private Vector3 _startScale;
    private Vector3 _currentScaleDelta = Vector3.one;

    public void Play()
    {
        _startLocalPos = transform.localPosition;
        _startLocalRot = transform.localEulerAngles;
        _startScale = transform.localScale;

        _delayTimer = startDelay;
        _elapsedTime = 0f;
        _isMoving = true;
        _isCompleted = false;
        _currentMoveDelta = Vector3.zero;
        _currentScaleDelta = Vector3.one;

        if (useRotation)
        {
            // Quaternionを経由して安全に差分オイラー角を計算する
            Quaternion startQ = Quaternion.Euler(_startLocalRot);
            Quaternion targetQ = Quaternion.Euler(targetRotation);
            Quaternion rotDiff = targetQ * Quaternion.Inverse(startQ);
            _targetRotEulerDiff = NormalizeEuler(rotDiff.eulerAngles);
        }
        else
        {
            _targetRotEulerDiff = Vector3.zero;
        }

        _currentRotDelta = Vector3.zero;
    }

    public void Stop()
    {
        _isMoving = false;
    }

    void Update()
    {
        if (!_isMoving) return;

        if (_delayTimer > 0f)
        {
            _delayTimer -= Time.deltaTime;
            return;
        }

        _elapsedTime += Time.deltaTime;
        float rate = duration > 0f ? Mathf.Clamp01(_elapsedTime / duration) : 1f;

        // イージングの適用
        float t = rate;
        if (useSmoothStep)
        {
            // SmoothStep: 3t^2 - 2t^3(三角関数を使わないためロースペック機でも軽量)
            t = rate * rate * (3f - 2f * rate);
        }

        // 移動中の差分計算
        _currentMoveDelta = Vector3.Lerp(Vector3.zero, targetPosition - _startLocalPos, t);

        if (useRotation)
        {
            _currentRotDelta = Vector3.Lerp(Vector3.zero, _targetRotEulerDiff, t);
        }
        else
        {
            _currentRotDelta = Vector3.zero;
        }

        _currentScaleDelta = Vector3.Lerp(Vector3.one, targetScale, t);

        if (rate >= 1f)
        {
            _isMoving = false;
            _isCompleted = true;

            if (!stayAtTarget)
            {
                _currentMoveDelta = Vector3.zero;
                _currentRotDelta = Vector3.zero;
                _currentScaleDelta = Vector3.one;
            }

            if (callEndCutOnComplete)
            {
                var controller = GetComponentInParent<Sys_CutController>();
                if (controller != null)
                    controller.EndCut();
            }
        }
    }

    // eulerAnglesを -180 〜 180 の範囲に正規化するヘルパー
    private Vector3 NormalizeEuler(Vector3 angles)
    {
        angles.x = NormalizeAngle(angles.x);
        angles.y = NormalizeAngle(angles.y);
        angles.z = NormalizeAngle(angles.z);
        return angles;
    }

    private float NormalizeAngle(float angle)
    {
        angle = angle % 360f;
        if (angle > 180f) angle -= 360f;
        else if (angle < -180f) angle += 360f;
        return angle;
    }

    public Vector3 GetPositionDelta()
    {
        if (_isMoving) return _currentMoveDelta;
        if (_isCompleted)
        {
            return stayAtTarget ? (targetPosition - _startLocalPos) : Vector3.zero;
        }
        return _elapsedTime > 0 ? (targetPosition - _startLocalPos) : Vector3.zero;
    }

    public Vector3 GetRotationDelta()
    {
        if (!useRotation) return Vector3.zero;

        if (_isMoving || _elapsedTime > 0)
        {
            if (!_isMoving && _isCompleted && !stayAtTarget) return Vector3.zero;
            return _currentRotDelta;
        }
        return Vector3.zero;
    }

    public Vector3 GetScaleDelta()
    {
        if (_isMoving || _elapsedTime > 0)
        {
            if (!_isMoving && _isCompleted && !stayAtTarget) return Vector3.one;
            return _currentScaleDelta;
        }
        return Vector3.one;
    }

    void OnDisable()
    {
        _isMoving = false;
        _isCompleted = false;
    }
}

回転

  • OE_Rotate_Update
  • パーリンノイズを用いて、位置ズレのない滑らかな揺れ(シェイク)を演出するスクリプト。
    完了時の非アクティブ化(deactivateOnComplete)に対応。
using UnityEngine;

public class OE_Rotate_Update : MonoBehaviour, IObjectEffect
{
    public float startDelay = 0f;

    public enum RotationAxis { Horizontal, Vertical }
    public RotationAxis rotationAxis = RotationAxis.Horizontal;

    public enum RotationDirection { Clockwise, CounterClockwise }
    public RotationDirection rotationDirection = RotationDirection.Clockwise;

    public float rotationsCount = 1f;
    public bool loop = false;
    public float speed = 90f;

    private bool _isRotating = false;
    private float _delayTimer = 0f;
    private float _currentRotationAmount = 0f;
    private float _targetRotationAmount = 0f;
    private Vector3 _frameRotDelta = Vector3.zero;

    public void Play()
    {
        _delayTimer = startDelay;
        _currentRotationAmount = 0f;
        _targetRotationAmount = rotationsCount * 360f;
        _isRotating = true;
        _frameRotDelta = Vector3.zero;
    }

    public void Stop()
    {
        _isRotating = false;
        _frameRotDelta = Vector3.zero;
    }

    void Update()
    {
        _frameRotDelta = Vector3.zero;

        if (!_isRotating) return;

        if (_delayTimer > 0f)
        {
            _delayTimer -= Time.deltaTime;
            return;
        }

        float step = speed * Time.deltaTime;

        if (!loop)
        {
            if (_currentRotationAmount + step >= _targetRotationAmount)
            {
                step = _targetRotationAmount - _currentRotationAmount;
                _isRotating = false;
            }
        }

        float directionSign = (rotationDirection == RotationDirection.Clockwise) ? 1f : -1f;
        float angleChange = step * directionSign;

        if (rotationAxis == RotationAxis.Horizontal)
        {
            _frameRotDelta = new Vector3(0f, angleChange, 0f);
        }
        else
        {
            _frameRotDelta = new Vector3(angleChange, 0f, 0f);
        }

        if (!loop)
        {
            _currentRotationAmount += step;
        }
    }

    public Vector3 GetRotationDelta()
    {
        return _frameRotDelta;
    }

    void OnDisable()
    {
        _isRotating = false;
        _frameRotDelta = Vector3.zero;
    }
}

詳しい実装・運用手順

ステップ1:演出オブジェクトの準備

  1. シーン上に演出を適用したいオブジェクトを配置する。
  2. 必要な個別演出コンポーネント(例: OE_FadeIn_Object, OE_Shake_Object など)をアタッチし、それぞれのパラメータ(持続時間や遅延など)を調整する。

ステップ2:コントローラーのアタッチと登録

  1. 同じオブジェクトに Sys_ObjectEffectController をアタッチする。
  2. コントローラーのインスペクターにある「Effect Modules」のリストに、アタッチされている各演出スクリプトのコンポーネントヘッダーをドラッグ&ドロップして登録する。
    ※演出スクリプト1つの場合も、コントローラーのアタッチとスクリプトのアサインは必要になります。

オブジェクトそのものではなく、各スクリプトのコンポーネントを個別に登録する点がポイント

ステップ3:セーブ/ロード(遡り)時の考慮

各スクリプトには Sys_SaveManager.IsLoading を考慮した分岐が組み込まれており、ロード復元時にはアニメーションをバイパスして即座に最終状態(あるいは初期状態)に収束するよう安全に配慮されている。
※ロードの仕組みに対しての処置であり、採用していない場合は必要ありません。

今後新しい演出スクリプトを作成する際のチェックリスト

将来的に新しい演出パターン(例: カラーフラッシュ、スケールバウンス等)を追加する場合は、必ず以下の仕様に準拠して実装してください。

  • 命名規則の遵守:クラス名およびファイル名を必ず OE_〜(例: OE_ColorFlash_Object など)にする。
  • インターフェースの実装:クラスに IObjectEffect を継承させる。
  • 【最重要】直接書き換えない設計の徹底★:個別スクリプト内で transform や RectTransform を毎フレーム直接変更しないこと。
    位置変化は GetPositionDelta()、揺れは GetPositionOffset()、回転は GetRotationDelta()、スケールは GetScaleDelta() を経由してコントローラーに値を渡す仕組みを必ず守る。
  • パフォーマンス(軽量化)の徹底:DOTweenは使用せず、Unity 6環境・ロースペックPCを考慮して Update による軽量な線形補間(Mathf.Lerp や PerlinNoise など)で実装する。
  • セーブ・ロード対応:Sys_SaveManager.IsLoading が有効な場合の即時収束・状態復元処理を忘れずに組み込む。

運用時の注意点

個別スクリプト単体での自動再生は行われません:
コントローラー経由での一元管理に完全移行しているため、スクリプト単体をオブジェクトに置くだけでは Play() は呼ばれません。
必ず Sys_ObjectEffectController とセットで運用してください。

オブジェクト用とUI用の違い

  • 司令塔コントローラー:
    • オブジェクト用:Sys_ObjectEffectController
    • UI用:UI_ObjectEffectController
  • 操作対象(コンポーネント):
    • オブジェクト用:SpriteRenderer や Transform
    • UI用:CanvasGroup(アルファ制御)や RectTransform(アンカー位置・スケール・回転制御)

コメント