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 11

HistoryMember
731Enabled: bool
731MaxIndicatorsVisible: int
731MaxPromptsVisible: int
685IndicatorHidden(prompt: ProximityPrompt)
685IndicatorShown(prompt: ProximityPrompt)
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
731Archivable: bool
731Capabilities: SecurityCapabilities
731IsInSandbox: bool
731Name: string
731Parent: Instance
731PredictionMode: PredictionMode
731Sandboxed: bool
731UniqueId: 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
707GetDescendants(): Instances
486GetFullName(): string
706GetStyled(name: string, selector: string?): Variant
657GetStyledPropertyChangedSignal(property: string): RBXScriptSignal
576GetTags(): Array
576HasTag(tag: string): bool
486IsAncestorOf(descendant: Instance): bool
486IsDescendantOf(ancestor: Instance): bool
664IsPropertyModified(property: string): bool
698QueryDescendants(selector: string): Instances
573Remove(): null
576RemoveTag(tag: string): null
664ResetPropertyToDefault(property: string): null
573SetAttribute(attribute: string, value: Variant): null
462WaitForChild(childName: string, timeOut: double): Instance
731children(): Instances
731clone(): Instance
731destroy(): null
731findFirstChild(name: string, recursive: bool = false): Instance
731getChildren(): Instances
731isDescendantOf(ancestor: Instance): bool
731remove(): null
462AncestryChanged(child: Instance, parent: Instance)
462AttributeChanged(attribute: string)
462ChildAdded(child: Instance)
462ChildRemoved(child: Instance)
462DescendantAdded(descendant: Instance)
462DescendantRemoving(descendant: Instance)
500Destroying()
657StyledPropertiesChanged()
731childAdded(child: Instance)
inherited from Object
731ClassName: string
731className: string
647GetPropertyChangedSignal(property: string): RBXScriptSignal
647IsA(className: string): bool
731isA(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 38

Members 11

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:

History 6

IndicatorHidden

Parameters (1)
promptProximityPrompt

This event triggers client-side in connected local scripts when the indicator for a ProximityPrompt is no longer visible, such as when the player moves outside the prompt's MaxIndicatorDistance or the prompt is disabled. It is the counterpart to IndicatorShown and is convenient for tearing down custom indicator UI globally rather than connecting to each individual ProximityPrompt.

History 1

IndicatorShown

Parameters (1)
promptProximityPrompt

This event triggers client-side in connected local scripts when the indicator for a ProximityPrompt becomes visible, which happens when the player moves within the prompt's MaxIndicatorDistance but remains outside its MaxActivationDistance. Indicators are opt-in: a prompt only shows one when its MaxIndicatorDistance is set greater than 0 (the default of 0 disables the indicator). Listening on the service rather than on each ProximityPrompt is convenient when implementing custom indicator UI globally.

History 1

MaxIndicatorsVisible

TypeDefault
int16

This property sets the maximum number of prompt indicators that can be visible at the same time. Indicators are lightweight distance hints shown for ProximityPrompts when the player is within the prompt's MaxIndicatorDistance but still outside its MaxActivationDistance.

This property defaults to 16 and is clamped to the range [0, 64]. Because indicators are opt-in per prompt — a prompt's MaxIndicatorDistance defaults to 0, which disables its indicator — this property has no visible effect unless at least one prompt sets a non-zero MaxIndicatorDistance.

History 3

MaxPromptsVisible

TypeDefault
int16

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

History 6

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