LocalScript

LocalScript : BaseScript

Overview

클라이언트 측 코드를 실행하는 스크립트 인스턴스입니다.

클라이언트 측 스크립트는 Enabled 속성이 true이고, StarterPlayerScripts, StarterCharacterScripts, StarterGui에 위치할 경우, 새로운 스레드에서 실행됩니다.

실행 중인 스크립트는 스크립트는 명시적으로 종료되거나 에러가 발생하지 않는 한 계속 실행되며, 이벤트에 연결된 함수 내부에서 발생한 오류는 실행을 중단시키지 않습니다.

만약 스크립트 자체나 상위 객체가 Destroy() 호출로 완전히 제거될 경우 실행이 중단됩니다. 단, Parent 속성이 nil로 변경되더라도 객체가 메모리에 남아 있다면 실행은 계속 유지됩니다.

이 스크립트는 서버가 아닌 각 플레이어의 장치(로컬 환경)에서 작동하므로, Camera, UserInputService, PlayerGui 등 클라이언트 전용 기능을 제어하거나 UI를 조작하는 용도로 사용됩니다.

또한, game.Players.LocalPlayer 속성을 통해 해당 클라이언트를 실행 중인 플레이어 객체에 직접 접근할 수 있습니다. 이를 통해 플레이어의 화면 상태나 입력에 따른 동작을 구현할 수 있습니다.