ProximityPromptService

ProximityPromptService : Instance

Overview

월드 내 모든 ProximityPrompt를 전역으로 관리하는 서비스입니다.

game:GetService("ProximityPromptService")를 통해 획득할 수 있습니다.

개별 ProximityPrompt 인스턴스 대신 이 서비스를 통해 이벤트를 수신하면, 월드 전체의 프롬프트 상호작용을 한 곳에서 처리할 수 있습니다.

Properties

Enabled

boolean

서비스 전체의 ProximityPrompt 기능을 활성화 또는 비활성화합니다.

false로 설정하면 월드의 모든 프롬프트가 표시되지 않습니다.

Code Samples

local ProximityPromptService = game:GetService("ProximityPromptService")
ProximityPromptService.Enabled = false

MaxPromptsVisible

number

동시에 화면에 표시할 수 있는 프롬프트의 최대 개수입니다.

Code Samples

local ProximityPromptService = game:GetService("ProximityPromptService")
ProximityPromptService.MaxPromptsVisible = 3

Methods

Events

PromptButtonHoldBegan

월드 내 어떤 ProximityPrompt의 버튼 홀드가 시작되었을 때 발생하는 이벤트입니다.

Parameters

ProximityPrompt prompt	해당 ProximityPrompt 인스턴스입니다.
Player player	버튼을 누르기 시작한 플레이어입니다.

Code Samples

local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptButtonHoldBegan:Connect(function(prompt, player)
    print(player.Name .. " started holding.")
end)

PromptButtonHoldEnded

월드 내 어떤 ProximityPrompt의 버튼 홀드가 종료되었을 때 발생하는 이벤트입니다.

Parameters

ProximityPrompt prompt	해당 ProximityPrompt 인스턴스입니다.
Player player	버튼에서 손을 뗀 플레이어입니다.

Code Samples

local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptButtonHoldEnded:Connect(function(prompt, player)
    print(player.Name .. " stopped holding.")
end)

PromptHidden

월드 내 어떤 ProximityPrompt가 화면에서 숨겨질 때 발생하는 이벤트입니다.

이 이벤트는 클라이언트 환경에서만 동작합니다.

Parameters

ProximityPrompt prompt	숨겨진 ProximityPrompt 인스턴스입니다.

Code Samples

local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptHidden:Connect(function(prompt)
    print(prompt.ObjectText .. " prompt is now hidden.")
end)

PromptShown

월드 내 어떤 ProximityPrompt가 화면에 표시될 때 발생하는 이벤트입니다.

이 이벤트는 클라이언트 환경에서만 동작합니다.

Parameters

ProximityPrompt prompt	표시된 ProximityPrompt 인스턴스입니다.

Code Samples

local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptShown:Connect(function(prompt)
    print(prompt.ObjectText .. " prompt is now visible.")
end)

PromptTriggered

월드 내 어떤 ProximityPrompt가 활성화되었을 때 발생하는 이벤트입니다.

Parameters

ProximityPrompt prompt	활성화된 ProximityPrompt 인스턴스입니다.
Player player	프롬프트를 활성화한 플레이어입니다.

Code Samples

local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptTriggered:Connect(function(prompt, player)
    print(player.Name .. " interacted with " .. prompt.ObjectText)
end)

PromptTriggerEnded

활성화 중이던 ProximityPrompt의 트리거가 완료되거나 취소되었을 때 발생하는 이벤트입니다.

Parameters

ProximityPrompt prompt	해당 ProximityPrompt 인스턴스입니다.
Player player	관련 플레이어입니다.

Code Samples

local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptTriggerEnded:Connect(function(prompt, player)
    print(player.Name .. "'s trigger has ended.")
end)