콘텐츠로 이동

API 사용하기

HD Admin의 내부 구조는 계속 바뀌기 때문에, 게임 코드에서 MainModule 안의 내용을 직접 건드리면 안 돼요. 이럴 때 API를 쓰면 편해요. API는 유용한 동작을 함수로 감싸 두었고 이 함수들은 그대로 유지되기 때문에, 나중에 업데이트가 있어도 코드가 깨지지 않아요.

API 가져오기

서버 Script에서는 이렇게 해요.

local hd = game:GetService("ReplicatedStorage"):WaitForChild("HD Admin")
local ServerAPI = require(hd.Core.ServerAPI)

클라이언트 LocalScript에서는 이렇게 해요.

local hd = game:GetService("ReplicatedStorage"):WaitForChild("HD Admin")
local ClientAPI = require(hd.Core.ClientAPI)

명령어 모듈(ConfigCommands)에서는 이렇게 해요.

local CommandAPI = require(script:FindFirstAncestor("HD Admin").Core.CommandAPI)

모델이 어디에 있든 이 방법은 잘 작동해요. 게임이 시작되면 HD Admin이 공유 파일을 ReplicatedStorage로 옮기기 때문이에요.

Tip

API를 쓸 때 타입 검사와 자동 완성을 사용하고 싶다면, HD Admin 모델을 ReplicatedStorage로 옮겨 주세요.


참고 페이지

Task API 명령어가 받는 작업 객체예요
Command API 명령어 모듈에서 안전하게 참조할 수 있는 모든 것이에요
Server API 서버 Script에서 쓰는 명령어, 역할, 관리, 이모트, 프롬프트, 설정이에요
Client API LocalScript에서 쓰는 패널, 프롬프트, 설정이에요

Info

추가하고 싶은 API 함수나 이벤트가 있다면 제안 게시판에서 알려 주세요.