PlayerGui

PlayerGui : Instance

Overview

PlayerGui는 플레이어가 게임에 접속할 때 자동으로 생성되는 클라이언트 전용 컨테이너로, Players 서비스 내 각 Player 인스턴스의 하위에 위치하며, 이 컨테이너는 UI를 플레이어의 화면에 표시하고 클라이언트 측 스크립트를 실행하기 위한 공간으로 사용됩니다.

플레이어가 게임에 접속하면, StarterGui 서비스의 모든 UI 요소가 PlayerGui로 한번만 복사됩니다.

이 컨테이너에 포함된 LocalScript는 해당 플레이어의 클라이언트에서 실행됩니다.

플레이어의 화면에 표시되는 StarterGui가 아닌 PlayerGui에 복제되어 표시되므로, 게임 중에 UI를 제어하려면 다음과 같이 StarterGui가 아닌 PlayerGui를 통해 접근해야 합니다:

local Players = game:GetService("Players")

local LocalPlayer = Players.LocalPlayer
local PlayerGui = LocalPlayer.PlayerGui

local ScreenGui = PlayerGui:WaitForChild("ScreenGui")
local TextLabel = ScreenGui:WaitForChild("TextLabel")

TextLabel.TextColor3 = Color3.fromRGB(255, 0, 0)

Properties

Methods

Events