Seat

Afficher les obsolètes

A type of BasePart that a player character can 'sit' in. When a character touches an enabled Seat object, it will be attached to the part by a Weld and the default character scripts will play a sitting animation.

How do Seats work?

When a model containing a Humanoid and a BasePart called 'HumanoidRootPart' (generally a player character) touches a seat, a Weld is created between the seat and the part. The C0 and C1 properties are configured so that the character is welded 2 studs above the seat. This weld is named 'SeatWeld' and parented to the seat.

When sitting the Seat.Occupant property is set to the Humanoid that is 'sitting' in the seat. Furthermore the Humanoid.SeatPart property of the humanoid is set to the seat.

A character can also be forced to sit in a seat using the Seat:Sit() function.

There are two ways for a character to get out of a seat. When a player jumps, they are removed from the seat. However this can also be done manually by destroying the seat weld, for example:


seat:FindFirstChild("SeatWeld"):Destroy()

Note seats have a cooldown (currently 3 seconds) that is on a per-character per-seat basis. This means once a character has gotten out of a seat they cannot sit back on the same seat for 3 seconds. This cooldown behavior may change and should not be relied upon by developers.

What can Seats be used for?

Seats have a diverse range of uses, ranging from the obvious to the more unconventional.

Creating chairs or benches without the need for any programming
Allowing characters to 'sit' in moving objects such as vehicles without getting flung around
Creating interfaces that are controlled by the character in the seat using the Seat.Occupant property

Échantillons de code

Detecting Seat Occupant

local Players = game:GetService("Players")

local seat = Instance.new("Seat")
seat.Anchored = true
seat.Position = Vector3.new(0, 1, 0)
seat.Parent = workspace

local currentPlayer = nil

local function onOccupantChanged()
	local humanoid = seat.Occupant
	if humanoid then
		local character = humanoid.Parent
		local player = Players:GetPlayerFromCharacter(character)
		if player then
			print(player.Name .. " has sat down")
			currentPlayer = player
			return
		end
	end
	if currentPlayer then
		print(currentPlayer.Name .. " has got up")
		currentPlayer = nil
	end
end

seat:GetPropertyChangedSignal("Occupant"):Connect(onOccupantChanged)

Résumé

Propriétés

Disabled:bool
lecture parallèle
Whether or not the seat is usable. If set to true, the seat will act as a normal part.
Occupant:Humanoid
lecture uniquement
non répliqué
lecture parallèle
The humanoid that is sitting in the seat.

Propriétés hérités de Part

Shape:Enum.PartType
non répliqué
lecture parallèle
Sets the overall shape of the object.

Propriétés hérités de BasePart

Anchored:bool
lecture parallèle
Determines whether a part is immovable by physics.
AssemblyAngularVelocity:Vector3
non répliqué
lecture parallèle
The angular velocity of the part's assembly.
AssemblyCenterOfMass:Vector3
lecture uniquement
non répliqué
lecture parallèle
The center of mass of the part's assembly in world space.
AssemblyLinearVelocity:Vector3
non répliqué
lecture parallèle
The linear velocity of the part's assembly.
AssemblyMass:number
lecture uniquement
non répliqué
lecture parallèle
The total mass of the part's assembly.
AssemblyRootPart:BasePart
lecture uniquement
non répliqué
lecture parallèle
A reference to the root part of the assembly.
BackSurface:Enum.SurfaceType
lecture parallèle
Determines the type of surface for the Back face of a part (+Z direction).
BottomSurface:Enum.SurfaceType
lecture parallèle
Determines the type of surface for the Bottom face of a part (-Y direction).
BrickColor:BrickColor
non répliqué
lecture parallèle
Determines the color of a part.
CFrame:CFrame
lecture parallèle
Determines the position and orientation of the BasePart in the world.
CanCollide:bool
lecture parallèle
Determines whether a part may collide with other parts.
CanQuery:bool
lecture parallèle
Determines whether the part is considered during spatial query operations.
CanTouch:bool
lecture parallèle
Determines if Touched and TouchEnded events fire on the part.
CastShadow:bool
lecture parallèle
Determines whether or not a part casts a shadow.
CenterOfMass:Vector3
lecture uniquement
non répliqué
lecture parallèle
Describes the world position in which a part's center of mass is located.
CollisionGroup:string
non répliqué
lecture parallèle
Describes the name of a part's collision group.
Color:Color3
non répliqué
lecture parallèle
Determines the color of a part.
CurrentPhysicalProperties:PhysicalProperties
lecture uniquement
non répliqué
lecture parallèle
Indicates the current physical properties of the part.
CustomPhysicalProperties:PhysicalProperties
lecture parallèle
Determines several physical properties of a part.
EnableFluidForces:bool
lecture parallèle
Used to enable or disable aerodynamic forces on parts and assemblies.
ExtentsCFrame:CFrame
lecture uniquement
non répliqué
lecture parallèle
The CFrame of the physical extents of the BasePart.
ExtentsSize:Vector3
lecture uniquement
non répliqué
lecture parallèle
The actual physical size of the BasePart as regarded by the physics engine.
FrontSurface:Enum.SurfaceType
lecture parallèle
Determines the type of surface for the Front face of a part (-Z direction).
LeftSurface:Enum.SurfaceType
lecture parallèle
Determines the type of surface for the Left face of a part (-X direction).
LocalTransparencyModifier:number
caché
non répliqué
lecture parallèle
Determines a multiplier for BasePart.Transparency that is only visible to the local client.
Locked:bool
lecture parallèle
Determines whether a part is selectable in Studio.
Mass:number
lecture uniquement
non répliqué
lecture parallèle
Describes the mass of the part, the product of its density and volume.
Massless:bool
lecture parallèle
Determines whether the part contributes to the total mass or inertia of its rigid body.
Material:Enum.Material
lecture parallèle
Determines the texture and default physical properties of a part.
MaterialVariant:string
non répliqué
lecture parallèle
The name of MaterialVariant.
Orientation:Vector3
caché
non répliqué
lecture parallèle
Describes the rotation of the part in the world.
PivotOffset:CFrame
lecture parallèle
Specifies the offset of the part's pivot from its CFrame.
Position:Vector3
caché
non répliqué
lecture parallèle
Describes the position of the part in the world.
ReceiveAge:number
caché
lecture uniquement
non répliqué
lecture parallèle
Time since last recorded physics update.
Reflectance:number
lecture parallèle
Determines how much a part reflects the skybox.
ResizeIncrement:number
lecture uniquement
non répliqué
lecture parallèle
Describes the smallest change in size allowable by the Resize method.
ResizeableFaces:Faces
lecture uniquement
non répliqué
lecture parallèle
Describes the faces on which a part may be resized.
RightSurface:Enum.SurfaceType
lecture parallèle
Determines the type of surface for the Right face of a part (+X direction).
RootPriority:number
lecture parallèle
The main rule in determining the root part of an assembly.
Rotation:Vector3
non répliqué
lecture parallèle
The rotation of the part in degrees for the three axes.
Size:Vector3
non répliqué
lecture parallèle
Determines the dimensions of a part (length, width, height).
TopSurface:Enum.SurfaceType
lecture parallèle
Determines the type of surface for the Top face of a part (+Y direction).
Transparency:number
lecture parallèle
Determines how much a part can be seen through (the inverse of part opacity).

Propriétés hérités de PVInstance

Origin:CFrame
non répliqué
non scriptable
lecture parallèle
Pivot Offset:CFrame
non répliqué
non scriptable
lecture parallèle

Afficher tous les hérités de Instance

Méthodes

Sit(humanoid : Instance):void
Forces the character with the specified Humanoid to sit in the Seat.

Méthodes hérités de BasePart

AngularAccelerationToTorque(angAcceleration : Vector3,angVelocity : Vector3):Vector3
ApplyAngularImpulse(impulse : Vector3):void
Apply an angular impulse to the assembly.
ApplyImpulse(impulse : Vector3):void
Apply an impulse to the assembly at the assembly's center of mass.
ApplyImpulseAtPosition(impulse : Vector3,position : Vector3):void
Apply an impulse to the assembly at specified position.
CanCollideWith(part : BasePart):bool
écrire en parallèle
Returns whether the parts can collide with each other.
CanSetNetworkOwnership():Tuple
Checks whether you can set a part's network ownership.
GetClosestPointOnSurface(position : Vector3):Vector3
GetConnectedParts(recursive : bool):Objects
écrire en parallèle
Returns a table of parts connected to the object by any kind of rigid joint.
GetJoints():Objects
écrire en parallèle
Return all Joints or Constraints that is connected to this Part.
GetMass():number
écrire en parallèle
Returns the value of the Mass property.
GetNetworkOwner():Instance
écrire en parallèle
Returns the current player who is the network owner of this part, or nil in case of the server.
GetNetworkOwnershipAuto():bool
écrire en parallèle
Returns true if the game engine automatically decides the network owner for this part.
GetNoCollisionConstraints():Objects
GetRootPart():Instance
écrire en parallèle
Returns the base part of an assembly of parts.
GetTouchingParts():Objects
Returns a table of all BasePart.CanCollide true parts that intersect with this part.
GetVelocityAtPosition(position : Vector3):Vector3
écrire en parallèle
Returns the linear velocity of the part's assembly at the given position relative to this part.
IsGrounded():bool
écrire en parallèle
Returns true if the object is connected to a part that will hold it in place (eg an BasePart.Anchored part), otherwise returns false.
Resize(normalId : Enum.NormalId,deltaAmount : number):bool
Changes the size of an object just like using the Studio resize tool.
SetNetworkOwner(playerInstance : Player):void
Sets the given player as network owner for this and all connected parts.
SetNetworkOwnershipAuto():void
Lets the game engine dynamically decide who will handle the part's physics (one of the clients or the server).
TorqueToAngularAcceleration(torque : Vector3,angVelocity : Vector3):Vector3
IntersectAsync(parts : Objects,collisionfidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):Instance
rendement
Creates a new IntersectOperation from the overlapping geometry of the part and the other parts in the given array.
SubtractAsync(parts : Objects,collisionfidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):Instance
rendement
Creates a new UnionOperation from the part, minus the geometry occupied by the parts in the given array.
UnionAsync(parts : Objects,collisionfidelity : Enum.CollisionFidelity,renderFidelity : Enum.RenderFidelity):Instance
rendement
Creates a new UnionOperation from the part, plus the geometry occupied by the parts in the given array.

Méthodes hérités de PVInstance

GetPivot():CFrame
écrire en parallèle
Gets the pivot of a PVInstance.
PivotTo(targetCFrame : CFrame):void
Transforms the PVInstance along with all of its descendant PVInstances such that the pivot is now located at the specified CFrame.

Afficher tous les hérités de Instance

Évènements

Évènements hérités de BasePart

TouchEnded(otherPart : BasePart):RBXScriptSignal
Fires when a part stops touching another part as a result of physical movement.
Touched(otherPart : BasePart):RBXScriptSignal
Fires when a part touches another part as a result of physical movement.