Physics2D

Description

Provides utilities and global settings to manage and simulate 2D physics interactions, such as collision detection and raycasting.

The Physics2D class provides tools and global settings for simulating 2D physics interactions, such as collision detection and raycasting. It is crucial for integrating realistic physics behaviors in 2D games, such as platformers and puzzle games.

To use Physics2D, set up your GameObjects with Collider2D-based, and Rigidbody2D components if required, and ensure proper configuration of layers and tags for collision detection and raycasting. Be mindful of potential performance impacts when using physics in complex scenes. Common issues may arise from incorrect setup of Collider2D-based or Rigidbody2D components, so understanding the order of physics updates and force application is important for troubleshooting.

This example illustrates how to set up a basic player controller for a 2D platformer game using the Physics2D utilities and settings:

using UnityEngine;

public class PlayerController2DExample : MonoBehaviour
{
    public float moveSpeed = 5f;
    public float jumpForce = 10f;
    public LayerMask groundLayer;
    private Rigidbody2D rb;
    private bool isGrounded;

    void Start()
    {
        // Set a custom gravity for the 2D physics world
        Physics2D.gravity = new Vector2(0f, -9.8f);

        // Get the Rigidbody2D component attached to the player
        rb = GetComponent<Rigidbody2D>();
    }

    void Update()
    {
        // Check if player is touching the ground
        isGrounded = Physics2D.OverlapCircle(transform.position, 0.1f, groundLayer);

        // Get horizontal input for player movement
        float moveInput = Input.GetAxis("Horizontal");
        rb.linearVelocity = new Vector2(moveInput * moveSpeed, rb.linearVelocity.y);

        // Check for jump input and apply force if grounded
        if (Input.GetButtonDown("Jump") && isGrounded)
        {
            rb.AddForce(Vector2.up * jumpForce, ForceMode2D.Impulse);
        }
    }
}

Additional resources: BoxCollider2D, CapsuleCollider2D, CircleCollider2D, CompositeCollider2D, CustomCollider2D, EdgeCollider2D, PolygonCollider2D, TilemapCollider2D & Rigidbody2D.

Static Properties

Static Methods