Reference API Roblox

Engine API

Website

Related

Reference API Roblox

ProximityPromptService

Allows developers to interact with ProximityPrompt objects in a global way.

This class is a service. It is a singleton that may be acquired with GetService.
This class is not browsable. It is not visible in Studio's object browser.
Tags: [Service, NotBrowsable]

Member index 8

HistoryMember
553Enabled: bool
553MaxPromptsVisible: int
483PromptButtonHoldBegan(prompt: ProximityPrompt, playerWhoTriggered: Player)
483PromptButtonHoldEnded(prompt: ProximityPrompt, playerWhoTriggered: Player)
483PromptHidden(prompt: ProximityPrompt)
483PromptShown(prompt: ProximityPrompt, inputType: ProximityPromptInputType)
483PromptTriggerEnded(prompt: ProximityPrompt, playerWhoTriggered: Player)
483PromptTriggered(prompt: ProximityPrompt, playerWhoTriggered: Player)
inherited from Instance
553Archivable: bool
635Capabilities: SecurityCapabilities
553Name: string
553Parent: Instance
635Sandboxed: bool
616UniqueId: UniqueId
576AddTag(tag: string): null
573ClearAllChildren(): null
462Clone(): Instance
573Destroy(): null
486FindFirstAncestor(name: string): Instance
486FindFirstAncestorOfClass(className: string): Instance
486FindFirstAncestorWhichIsA(className: string): Instance
486FindFirstChild(name: string, recursive: bool = false): Instance
486FindFirstChildOfClass(className: string): Instance
486FindFirstChildWhichIsA(className: string, recursive: bool = false): Instance
486FindFirstDescendant(name: string): Instance
563GetActor(): Actor
486GetAttribute(attribute: string): Variant
462GetAttributeChangedSignal(attribute: string): RBXScriptSignal
631GetAttributes(): Dictionary
648GetChildren(): Instances
462GetDebugId(scopeLength: int = 4): string
486GetDescendants(): Array
486GetFullName(): string
641GetStyled(name: string): Variant
576GetTags(): Array
576HasTag(tag: string): bool
486IsAncestorOf(descendant: Instance): bool
486IsDescendantOf(ancestor: Instance): bool
580IsPropertyModified(name: string): bool
573Remove(): null
576RemoveTag(tag: string): null
580ResetPropertyToDefault(name: string): null
573SetAttribute(attribute: string, value: Variant): null
462WaitForChild(childName: string, timeOut: double): Instance
648children(): Instances
553clone(): Instance
573destroy(): null
553findFirstChild(name: string, recursive: bool = false): Instance
648getChildren(): Instances
553isDescendantOf(ancestor: Instance): bool
573remove(): null
462AncestryChanged(child: Instance, parent: Instance)
462AttributeChanged(attribute: string)
462ChildAdded(child: Instance)
462ChildRemoved(child: Instance)
462DescendantAdded(descendant: Instance)
462DescendantRemoving(descendant: Instance)
500Destroying()
553childAdded(child: Instance)
inherited from Object
647ClassName: string
647className: string
647GetPropertyChangedSignal(property: string): RBXScriptSignal
647IsA(className: string): bool
650isA(className: string): bool
647Changed(property: string)

Description

ProximityPromptService allows developers to interact with ProximityPrompt objects in a global way. It may be more convenient to listen to events through this service rather than on individual ProximityPrompt objects.

History 29

Members 8

Enabled

TypeDefault
booltrue

This property determines whether ProximityPrompts are enabled, and therefore shown, in-experience. When false, no prompts will be shown.

For example, in a round-based system, you can disable prompts at certain points in the experience to disable proximity-based interactions:

1
2
3
4
5
6
7
8
9
local ProximityPromptService = game:GetService("ProximityPromptService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local enablePrompts = ReplicatedStorage:FindFirstChild("EnablePrompts") -- BindableEvent

-- Connect to the BindableEvent and fire from another script controlling experience logic
enablePrompts.OnServerEvent:Connect(function(enabled)
	ProximityPromptService.Enabled = enabled
end)

History 4

MaxPromptsVisible

TypeDefault
int16

This property indicates the maximum number of ProximityPrompts that will be shown to the player.

History 4

PromptButtonHoldBegan

Parameters (2)
promptProximityPrompt
playerWhoTriggeredPlayer

This event triggers when the player begins holding down the KeyboardKeyCode key/button on a prompt with a non-zero HoldDuration.

History 4

PromptButtonHoldEnded

Parameters (2)
promptProximityPrompt
playerWhoTriggeredPlayer

This event triggers when the player stops holding down the KeyboardKeyCode key/button on a prompt with a non-zero HoldDuration.

History 4

PromptHidden

Parameters (1)
promptProximityPrompt

This event triggers client-side in connected local scripts when a prompt becomes hidden.

History 3

PromptShown

Parameters (2)
promptProximityPrompt
inputTypeProximityPromptInputType

This event triggers client-side in connected local scripts when a prompt becomes visible.

History 3

PromptTriggerEnded

Parameters (2)
promptProximityPrompt
playerWhoTriggeredPlayer

This event triggers when the player stops holding down the KeyboardKeyCode key/button while triggering a prompt. This is intended to allow interactions which require the player to hold a key/button while something happens in-experience.

History 3

PromptTriggered

Parameters (2)
promptProximityPrompt
playerWhoTriggeredPlayer

This event triggers when the player completes interaction with a prompt, either when the KeyboardKeyCode key/button is pressed, or after a specified amount of time holding the key/button if the prompt's HoldDuration is non-zero.

History 3

Settings