菜单
Implement 2D and 3D physics in Godot including collision detection, physics bodies, raycasting, and area detection. Use this skill when setting up CharacterBody, RigidBody, StaticBody, configuring collision layers and masks, casting rays, or building physics-driven gameplay.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | physics |
| description | Implement 2D and 3D physics in Godot including collision detection, physics bodies, raycasting, and area detection. Use this skill when setting up CharacterBody, RigidBody, StaticBody, configuring collision layers and masks, casting rays, or building physics-driven gameplay. |
| metadata | {"author":"godot-dev","version":"1.0"} |
For player-controlled characters with manual physics handling.
extends CharacterBody2D
@export var speed: float = 300.0
@export var jump_velocity: float = -500.0
var gravity = ProjectSettings.get_setting("physics/2d/default_gravity")
func _physics_process(delta):
if not is_on_floor():
velocity.y += gravity * delta
if Input.is_action_just_pressed("jump") and is_on_floor():
velocity.y = jump_velocity
var direction = Input.get_axis("left", "right")
velocity.x = direction * speed
move_and_slide()
for i in get_slide_collision_count():
var collision = get_slide_collision(i)
if collision.get_collider().is_in_group("enemies"):
take_damage()
For physics-driven objects (balls, ragdolls, projectiles).
extends RigidBody2D
@export var launch_force: float = 500.0
func launch(direction: Vector2):
apply_central_impulse(direction * launch_force)
func _ready():
apply_central_impulse(Vector2(100, -200))
gravity_scale = 1.5
physics_material_override = PhysicsMaterial.new()
physics_material_override.bounce = 0.8
For static environment colliders (walls, floors, platforms).
# Moving platform with AnimatableBody2D
extends AnimatableBody2D
@export var move_distance: Vector2 = Vector2(0, -100)
@export var move_speed: float = 2.0
var start_position: Vector2
var target_position: Vector2
func _ready():
start_position = global_position
target_position = start_position + move_distance
func _physics_process(delta):
global_position = global_position.lerp(target_position, move_speed * delta)
if global_position.distance_to(target_position) < 1:
var temp = target_position
target_position = start_position
start_position = temp
For trigger zones (pickups, damage zones, detection areas).
extends Area2D
signal collected()
func _ready():
body_entered.connect(_on_body_entered)
area_entered.connect(_on_area_entered)
func _on_body_entered(body: Node2D):
if body.is_in_group("player"):
collected.emit()
queue_free()
func _on_area_entered(area: Area2D):
if area.is_in_group("damage_zone"):
take_damage()
Example setup:
collision_layer = 1 # Player layer
collision_mask = 5 # Interact with layers 1 and 3 (1 + 4 = 5)
Required for physics bodies. Common shapes:
extends Node2D
@onready var ray_cast = $RayCast2D
func _physics_process(delta):
ray_cast.target_position = Vector2(100, 0)
if ray_cast.is_colliding():
var collider = ray_cast.get_collider()
var point = ray_cast.get_collision_point()
var normal = ray_cast.get_collision_normal()
if collider.is_in_group("enemy"):
attack(collider)
extends Node3D
@onready var ray_cast = $RayCast3D
func _physics_process(delta):
ray_cast.target_position = Vector3(0, 0, -10)
if ray_cast.is_colliding():
var collider = ray_cast.get_collider()
if collider.has_method("take_damage"):
collider.take_damage(10)
func raycast_from_mouse():
var space_state = get_world_2d().direct_space_state
var mouse_pos = get_global_mouse_position()
var query = PhysicsRayQueryParameters2D.create(global_position, mouse_pos)
query.collision_mask = 2
var result = space_state.intersect_ray(query)
if result:
print("Hit: ", result.collider.name)
_physics_process() for all physics calculations — fixed timestep ensures consistent behaviorfreeze on RigidBody when not neededDevelop 2D games in Godot including sprites, tilemaps, cameras, lighting, and parallax backgrounds. Use this skill when building 2D platformers, top-down games, implementing tilemap-based levels, 2D camera systems, day/night cycles, or any 2D-specific game feature.
Develop 3D games in Godot including meshes, lighting, cameras, environments, and 3D model importing. Use this skill when building 3D scenes, setting up lighting rigs, configuring cameras, importing glTF/FBX models, implementing 3D character controllers, or working with the 3D rendering pipeline.
Create and manage animations in Godot using AnimationPlayer, AnimationTree, Tween, and AnimatedSprite2D. Use this skill when building character animations, UI transitions, sprite frame animations, tween-based effects, or animation state machines.
Implement audio in Godot including sound effects, music playback, audio buses, and 3D spatial audio. Use this skill when setting up audio players, managing audio buses, creating music systems with crossfade, pooling audio sources, or adding positional audio to 2D/3D scenes.
Export and deploy Godot projects to Windows, Linux, macOS, Android, iOS, and Web platforms. Use this skill when configuring export presets, setting up CI/CD pipelines, preparing release builds, optimizing for target platforms, or distributing games to Steam, itch.io, or mobile stores.
Write, debug, and optimize GDScript code for Godot Engine 4.x. Use this skill when creating scripts, fixing GDScript errors, connecting signals, configuring export variables, setting up node references, or implementing character movement and game logic in GDScript.