最后同步日期：2026-04-15 | Godot 官方原文 — SliderJoint3D

SliderJoint3D

节点继承关系

继承链：Node → Node3D → Joint3D → SliderJoint3D

Joint3D

类型	名称	说明
属性	NodeA	连接的第一个物体
属性	NodeB	连接的第二个物体

Node3D

类型	名称	说明
属性	Position	本地位置（X / Y / Z）
属性	GlobalPosition	全局位置
属性	Rotation	旋转角度（欧拉角，弧度）
属性	Scale	缩放比例
属性	TopLevel	是否脱离父节点的变换
方法	LookAt()	朝向目标点
方法	ToGlobal()	本地坐标转全局坐标
方法	ToLocal()	全局坐标转本地坐标
方法	RotateX/Y/Z()	绕指定轴旋转

Node

类型	名称	说明
属性	Name	节点名称
属性	ProcessMode	处理模式（始终 / 暂停时 / 仅编辑器）
属性	ProcessPriority	处理优先级，数字越小越先执行
信号	ready	节点进入场景树并准备就绪
信号	tree_entered	节点进入场景树
信号	tree_exited	节点完全离开场景树
方法	GetNode<T>()	按路径获取子节点
方法	AddChild()	添加子节点
方法	RemoveChild()	移除子节点
方法	QueueFree()	帧结束后释放节点
方法	GetParent()	获取父节点

定义

3D 版本的滑槽关节。物体沿一条轴来回滑动，不能旋转。

想象一个抽屉——抽屉只能沿着水平方向拉出和推入，不能上下移动也不能旋转。SliderJoint3D 就是那个"滑轨"，它限制物体只能沿一条轴滑动。

使用频率：★ 基本用不到——用于 3D 滑动连接。

节点用途

• 液压杆
• 滑动门
• 活塞
• 电梯
• 任何沿固定方向滑动的 3D 连接

使用场景

典型场景

• 3D 滑动门：门沿水平方向滑动
• 液压杆：沿直线方向伸缩

不适用场景

• 需要旋转 → 使用 HingeJoint3D
• 需要多方向运动 → 使用 Generic6DOFJoint3D

常用节点搭配

搭配节点	用途	必需？
RigidBody3D（NodeA）	滑轨	必需
RigidBody3D（NodeB）	滑动物体	必需

典型节点树：

SlidingDoor (Node3D)
├── Rail (StaticBody3D)
├── SliderJoint3D（连接 Rail 和 Door）
└── Door (RigidBody3D)
    ├── CollisionShape3D
    └── MeshInstance3D

生效必备素材/资源

资源	类型	说明
碰撞形状	Shape3D 资源	两个连接物体都需要

节点属性与信号

核心属性

属性	类型	默认值	继承自	说明
NodeA	NodePath	""	Joint3D	第一个物体
NodeB	NodePath	""	Joint3D	第二个物体
Params/LinearLimit/Enable	bool	true	—	是否启用滑动距离限制
Params/LinearLimit/Upper	float	1.0	—	最大滑动距离（正方向）
Params/LinearLimit/Lower	float	-1.0	—	最大滑动距离（负方向）
Params/LinearMotion/Enable	bool	false	—	是否启用线性马达
Params/LinearMotion/TargetVelocity	float	0.0	—	马达目标速度
Params/LinearMotion/MaxImpulse	float	0.1	—	马达最大冲量
DisableCollision	bool	true	Joint3D	是否禁用碰撞

信号

信号	触发时机	继承自	说明
无自有信号	—	—	—

常用方法

方法	返回值	说明
GetNodeA()	NodePath	获取第一个物体路径
GetNodeB()	NodePath	获取第二个物体路径

代码示例

C

using Godot;

/// <summary>
/// 3D 自动滑动门
/// </summary>
public partial class SlidingDoor3D : Node3D
{
    private SliderJoint3D _joint;

    public override void _Ready()
    {
        _joint = GetNode<SliderJoint3D>("SliderJoint3D");
        _joint.NodeA = GetNode<StaticBody3D>("Rail").GetPath();
        _joint.NodeB = GetNode<RigidBody3D>("Door").GetPath();

        // 设置滑动范围
        _joint.Set("params/linear_limit/lower", -2.0f);
        _joint.Set("params/linear_limit/upper", 0.0f);
    }

    public void OpenDoor()
    {
        // 用马达驱动门滑动
        _joint.Set("params/linear_motion/enable", true);
        _joint.Set("params/linear_motion/target_velocity", -2.0f);
        _joint.Set("params/linear_motion/max_impulse", 10.0f);
    }

    public void CloseDoor()
    {
        _joint.Set("params/linear_motion/target_velocity", 2.0f);
    }
}

GDScript

# 3D 自动滑动门
extends Node3D

@onready var joint: SliderJoint3D = $SliderJoint3D

func _ready() -> void:
	joint.node_a = $Rail.get_path()
	joint.node_b = $Door.get_path()

	# 设置滑动范围
	joint.set("params/linear_limit/lower", -2.0)
	joint.set("params/linear_limit/upper", 0.0)

func open_door() -> void:
	# 用马达驱动门滑动
	joint.set("params/linear_motion/enable", true)
	joint.set("params/linear_motion/target_velocity", -2.0)
	joint.set("params/linear_motion/max_impulse", 10.0)

func close_door() -> void:
	joint.set("params/linear_motion/target_velocity", 2.0)