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
553Enabled: bool
685MaxIndicatorsVisible: int
553MaxPromptsVisible: 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
553Archivable: bool
670Capabilities: SecurityCapabilities
553Name: string
553Parent: Instance
670Sandboxed: bool
680UniqueId: 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
657GetStyledPropertyChangedSignal(property: string): RBXScriptSignal
576GetTags(): Array
576HasTag(tag: string): bool
486IsAncestorOf(descendant: Instance): bool
486IsDescendantOf(ancestor: Instance): bool
664IsPropertyModified(property: string): bool
573Remove(): null
576RemoveTag(tag: string): null
664ResetPropertyToDefault(property: 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()
657StyledPropertiesChanged()
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 32

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:

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

IndicatorHidden

Parameters (1)
promptProximityPrompt

History 1

IndicatorShown

Parameters (1)
promptProximityPrompt

History 1

MaxIndicatorsVisible

TypeDefault
int16

History 1

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