Unity 2D キャラクター 素材｜2Dキャラ制御スクリプト一式（移動・二段ジャンプ・被弾無敵・体力バー・トゲ判定・カメラ追従）Unity 2021.3以降

C#スクリプト6本・Inspectorで触れる公開調整値54項目。コードを1行も開かずに、移動の重さ・ジャンプ高さ・無敵時間・ノックバックを数値だけで詰められる。マテリアルとシェーダーを含まないので Built-in / URP / HDRP のどれでもピンク化しない。

インポート

1. Unity 2021.3+ : Assets > Import Package > Custom Package
2. Assets/Unity2DCharacterKit

収録内容 (7)

インスペクターで変更する値

無料スクリプト — Runtime/Character2DController.cs

このファイルをそのままプロジェクトにコピーしてください。パック収録の1本です。

using UnityEngine;

// Side-scrolling 2D character movement. Put this on the character root (needs a Rigidbody2D).
// Everything a designer touches is a public field, so the code never has to be opened.
[RequireComponent(typeof(Rigidbody2D))]
[DisallowMultipleComponent]
public class Character2DController : MonoBehaviour
{
    [Header("Input (legacy Input Manager)")]
    [Tooltip("Axis name from Project Settings > Input Manager.")]
    public string horizontalAxis = "Horizontal";
    [Tooltip("Button name from Project Settings > Input Manager.")]
    public string jumpButton = "Jump";

    [Header("Move")]
    [Tooltip("Top horizontal speed in world units per second.")]
    [Min(0)] public float moveSpeed = 6f;
    [Tooltip("How fast the character reaches Move Speed. Higher feels lighter.")]
    [Min(0)] public float acceleration = 60f;
    [Tooltip("How fast the character stops when there is no input. Higher feels stickier.")]
    [Min(0)] public float deceleration = 70f;
    [Tooltip("0 = no steering while airborne, 1 = full ground control while airborne.")]
    [Range(0f, 1f)] public float airControl = 0.65f;

    [Header("Jump")]
    [Tooltip("Peak jump height in world units. Gravity is solved for this height, so the height stays true even after Rigidbody2D Gravity Scale changes.")]
    [Min(0)] public float jumpHeight = 3.2f;
    [Tooltip("Jumps available before touching ground again. 1 = single jump, 2 = double jump.")]
    [Min(0)] public int maxJumps = 1;
    [Tooltip("Seconds after leaving a ledge during which a jump press is still accepted.")]
    [Min(0)] public float coyoteTime = 0.12f;
    [Tooltip("Seconds before landing during which a jump press is remembered.")]
    [Min(0)] public float jumpBufferTime = 0.12f;
    [Tooltip("Extra gravity while falling. Above 1 makes the fall snappier than the rise.")]
    [Min(0)] public float fallGravityMultiplier = 2.2f;
    [Tooltip("Extra gravity while rising with the jump button released. Gives a short hop.")]
    [Min(0)] public float lowJumpMultiplier = 2.6f;
    [Tooltip("Maximum downward speed. Stops the character tunnelling through thin colliders. 0 = no limit.")]
    [Min(0)] public float maxFallSpeed = 22f;

    [Header("Ground check")]
    [Tooltip("Empty child object placed at the feet. Leave empty and the character origin is used instead.")]
    public Transform groundCheck;
    [Tooltip("Radius of the ground probe, in world units.")]
    [Min(0)] public float groundCheckRadius = 0.16f;
    [Tooltip("Layers that count as ground.")]
    public LayerMask groundLayers = 1;
    [Tooltip("Flip localScale.x so the sprite faces the direction of movement.")]
    public bool flipSpriteWithMovement = true;

    public bool IsGrounded { get; private set; }
    public float HorizontalInput { get; private set; }
    public int Facing { get; private set; }
    public bool ControlEnabled { get; set; }

    Rigidbody2D _rb;
    float _coyoteTimer;
    float _bufferTimer;
    int _jumpsLeft;
    bool _jumpHeld;
    bool _missingGroundCheckWarned;

    void Awake()
    {
        _rb = GetComponent<Rigidbody2D>();
        _rb.freezeRotation = true;
        Facing = 1;
        ControlEnabled = true;
        _jumpsLeft = Mathf.Max(1, maxJumps);
    }

    void Update()
    {
        if (ControlEnabled)
        {
            HorizontalInput = Input.GetAxisRaw(horizontalAxis);
            if (Input.GetButtonDown(jumpButton)) _bufferTimer = jumpBufferTime;
            _jumpHeld = Input.GetButton(jumpButton);
        }
        else
        {
            // Death or a cutscene: drop input instead of freezing the physics body.
            HorizontalInput = 0f;
            _jumpHeld = false;
            _bufferTimer = 0f;
        }

        if (_bufferTimer > 0f) _bufferTimer -= Time.deltaTime;

        if (flipSpriteWithMovement && Mathf.Abs(HorizontalInput) > 0.01f)
        {
            int want = HorizontalInput > 0f ? 1 : -1;
            if (want != Facing)
            {
                Facing = want;
                Vector3 s = transform.localScale;
                s.x = Mathf.Abs(s.x) * want;
                transform.localScale = s;
            }
        }
    }

    void FixedUpdate()
    {
        IsGrounded = CheckGround();

        if (IsGrounded && _rb.velocity.y <= 0.01f)
        {
            _coyoteTimer = coyoteTime;
            _jumpsLeft = Mathf.Max(1, maxJumps);
        }
        else if (_coyoteTimer > 0f)
        {
            _coyoteTimer -= Time.fixedDeltaTime;
        }

        Vector2 v = _rb.velocity;

        float target = HorizontalInput * moveSpeed;
        float rate = (Mathf.Abs(target) > 0.01f ? acceleration : deceleration) * (IsGrounded ? 1f : airControl);
        v.x = Mathf.MoveTowards(v.x, target, rate * Time.fixedDeltaTime);

        if (_bufferTimer > 0f && (_coyoteTimer > 0f || _jumpsLeft > 0))
        {
            // Consume both the buffer and the coyote window, so one press can never fire twice.
            _bufferTimer = 0f;
            _coyoteTimer = 0f;
            _jumpsLeft = Mathf.Max(0, _jumpsLeft - 1);
            v.y = JumpVelocity();
        }

        float g = Physics2D.gravity.y * _rb.gravityScale;
        if (v.y < 0f) v.y += g * (fallGravityMultiplier - 1f) * Time.fixedDeltaTime;
        else if (v.y > 0f && !_jumpHeld) v.y += g * (lowJumpMultiplier - 1f) * Time.fixedDeltaTime;

        if (maxFallSpeed > 0f && v.y < -maxFallSpeed) v.y = -maxFallSpeed;

        _rb.velocity = v;
    }

    float JumpVelocity()
    {
        float g = Mathf.Abs(Physics2D.gravity.y) * Mathf.Max(0.0001f, _rb.gravityScale);
        return Mathf.Sqrt(2f * g * Mathf.Max(0f, jumpHeight));
    }

    bool CheckGround()
    {
        Vector2 point;
        if (groundCheck != null)
        {
            point = groundCheck.position;
        }
        else
        {
            // Warn once, not every physics step, and keep the game running.
            if (!_missingGroundCheckWarned)
            {
                _missingGroundCheckWarned = true;
                Debug.LogWarning("[Character2DController] Ground Check is empty. Using the character origin. Create an empty child at the feet and assign it.", this);
            }
            point = transform.position;
        }
        return Physics2D.OverlapCircle(point, Mathf.Max(0.01f, groundCheckRadius), groundLayers) != null;
    }

    void OnDrawGizmosSelected()
    {
        Vector3 p = groundCheck != null ? groundCheck.position : transform.position;
        Gizmos.color = Color.green;
        Gizmos.DrawWireSphere(p, Mathf.Max(0.01f, groundCheckRadius));
    }
}