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
726Enabled: bool
726MaxIndicatorsVisible: int
726MaxPromptsVisible: 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
726Archivable: bool
726Capabilities: SecurityCapabilities
726IsInSandbox: bool
726Name: string
726Parent: Instance
726PredictionMode: PredictionMode
726Sandboxed: bool
726UniqueId: 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
726children(): Instances
726clone(): Instance
726destroy(): null
726findFirstChild(name: string, recursive: bool = false): Instance
726getChildren(): Instances
726isDescendantOf(ancestor: Instance): bool
726remove(): null
462AncestryChanged(child: Instance, parent: Instance)
462AttributeChanged(attribute: string)
462ChildAdded(child: Instance)
462ChildRemoved(child: Instance)
462DescendantAdded(descendant: Instance)
462DescendantRemoving(descendant: Instance)
500Destroying()
657StyledPropertiesChanged()
726childAdded(child: Instance)
inherited from Object
726ClassName: string
726className: string
647GetPropertyChangedSignal(property: string): RBXScriptSignal
647IsA(className: string): bool
726isA(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 35

Members 11

Enabled

TypeDefault
bool

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 5

IndicatorHidden

Parameters (1)
promptProximityPrompt

History 1

IndicatorShown

Parameters (1)
promptProximityPrompt

History 1

MaxIndicatorsVisible

TypeDefault
int

History 2

MaxPromptsVisible

TypeDefault
int

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

History 5

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