요약
ServerScriptService의 Script에서 명령마다 TextChatCommand를 만들고, PrimaryAlias(예: "/kick")를 지정한 뒤 TextChatService에 넣습니다. Triggered 이벤트는 보낸 사람의 TextSource와 메시지 전체 텍스트를 넘겨줍니다. Players:GetPlayerByUserId(textSource.UserId)로 플레이어를 찾고, 그 user ID가 어드민 목록에 있는지 확인한 다음, 메시지를 단어로 나누어 동작을 실행합니다.
- 어드민 목록은 서버에서 확인하세요. LocalScript에서 하는 확인은 익스플로이터가 우회할 수 있습니다.
- 이름이 아니라 user ID로 확인하세요. 플레이어는 이름을 바꿀 수 있지만 ID는 절대 바뀌지 않습니다.
- 명령과 일치한 메시지는 채팅에 표시되지 않으므로, 명령이 다른 플레이어의 채팅을 어지럽히지 않습니다.
채팅 명령이 작동하는 방식
TextChatService 안의 TextChatCommand는 채팅 메시지를 지켜봅니다. 메시지가 PrimaryAlias 또는 SecondaryAlias로 시작하고 그 뒤에 공백이 오거나 아무것도 없으면, Roblox는 메시지를 다른 플레이어에게 보내지 않고 대신 Triggered를 호출합니다. 별칭 비교는 대소문자를 구분하지 않습니다. Roblox의 사용자 지정 명령 예제는 서버 Script에서 Triggered에 연결하며, 바로 그곳이 어드민 확인을 둘 자리입니다.
| 채팅에 입력할 내용 | 일어나는 일 |
|---|---|
/kick Name | 그 플레이어를 서버에서 내보냅니다. |
/tp Name | 나를 그 플레이어에게 텔레포트합니다. /tp Name1 Name2는 Name1을 Name2에게 보냅니다. |
/speed Name 50 | 그 플레이어의 WalkSpeed를 설정합니다(0에서 200). 숫자가 없으면 16으로 되돌립니다. |
/heal Name | 체력을 가득 회복시킵니다. |
/kill Name | 그 플레이어의 캐릭터를 처치합니다. |
이름 대신 me, all, others를 쓸 수 있고, 이름의 앞부분만 써도 됩니다. /heal ro는 이름이나 표시 이름이 "ro"로 시작하는 모든 플레이어를 회복시킵니다.
1단계: 명령 추가하기
- 게임이 TextChatService를 쓰는지 확인하세요. Explorer에서 TextChatService를 선택하고 Properties 창에서 ChatVersion을 봅니다. 오래된 플레이스라서 아직 LegacyChatService로 되어 있다면, Roblox의 인게임 텍스트 채팅 페이지에 전환 방법을 다룬 섹션이 있습니다.
- ServerScriptService에
AdminCommands라는 이름의 Script를 넣고 아래 코드를 붙여 넣으세요. ADMINS의123456을 내 user ID로 바꾸세요.
-- ServerScriptService 안의 Script, 이름은 AdminCommands.
-- ADMINS에 있는 user ID용 채팅 명령: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")
-- 내 user ID는 프로필 링크에 있는 숫자입니다: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
[123456] = true,
}
local function isAdmin(userId: number): boolean
-- 내 개인 계정이 소유한 플레이스의 Studio 플레이 테스트에서는 나도 어드민으로 취급됩니다
local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
return ADMINS[userId] == true or ownerInStudio
end
-- 이름이나 표시 이름의 앞부분, 또는 "me", "all", "others"로 플레이어를 찾습니다
local function findPlayers(text: string?, caller: Player): { Player }
local found: { Player } = {}
if not text or text == "" or text == "me" then
table.insert(found, caller)
return found
end
local lower = string.lower(text)
for _, player in Players:GetPlayers() do
local name = string.lower(player.Name)
local display = string.lower(player.DisplayName)
if lower == "all"
or (lower == "others" and player ~= caller)
or string.sub(name, 1, #lower) == lower
or string.sub(display, 1, #lower) == lower
then
table.insert(found, player)
end
end
return found
end
local function getHumanoid(player: Player): Humanoid?
local character = player.Character
return character and character:FindFirstChildOfClass("Humanoid")
end
type Handler = (caller: Player, args: { string }) -> ()
local commands: { [string]: Handler } = {
kick = function(caller, args)
for _, target in findPlayers(args[2], caller) do
if target ~= caller then
target:Kick("Kicked by an admin")
end
end
end,
tp = function(caller, args)
-- /tp name: 그 플레이어에게 이동. /tp name1 name2: name1을 name2에게 보내기.
local destination = if args[3] then findPlayers(args[3], caller)[1] else findPlayers(args[2], caller)[1]
local movers: { Player } = if args[3] then findPlayers(args[2], caller) else { caller }
local destCharacter = destination and destination.Character
if not destCharacter then
return
end
for _, mover in movers do
local character = mover.Character
if character and mover ~= destination then
character:PivotTo(destCharacter:GetPivot() * CFrame.new(0, 0, 4))
end
end
end,
speed = function(caller, args)
-- /speed name 50
local speed = tonumber(args[3]) or 16
for _, target in findPlayers(args[2], caller) do
local humanoid = getHumanoid(target)
if humanoid then
humanoid.WalkSpeed = math.clamp(speed, 0, 200)
end
end
end,
heal = function(caller, args)
for _, target in findPlayers(args[2], caller) do
local humanoid = getHumanoid(target)
if humanoid then
humanoid.Health = humanoid.MaxHealth
end
end
end,
kill = function(caller, args)
for _, target in findPlayers(args[2], caller) do
local humanoid = getHumanoid(target)
if humanoid then
humanoid.Health = 0
end
end
end,
}
-- 명령마다 TextChatCommand를 하나씩 만듭니다. 결과는 어드민만 얻고, 나머지 사람에게는
-- 명령이 아무 일도 하지 않으며 메시지도 채팅에 표시되지 않습니다.
for name, handler in commands do
local command = Instance.new("TextChatCommand")
command.Name = "Admin_" .. name
command.PrimaryAlias = "/" .. name
command.AutocompleteVisible = false -- 명령이 다른 플레이어의 자동 완성 목록에 나오지 않습니다
command.Parent = TextChatService
command.Triggered:Connect(function(textSource: TextSource, unfilteredText: string)
local caller = Players:GetPlayerByUserId(textSource.UserId)
if not caller or not isAdmin(caller.UserId) then
return
end
handler(caller, string.split(unfilteredText, " "))
end)
end
commands 테이블은 이름마다 함수를 연결합니다. 아래쪽 반복문이 각 항목을 TextChatCommand로 바꾸므로, 새 명령은 테이블 항목 하나만 추가하면 됩니다. string.split(unfilteredText, " ")는 메시지를 단어로 나눕니다. args[1]은 명령, args[2]는 대상, args[3]은 숫자 또는 두 번째 대상입니다.
AutocompleteVisible = false는 플레이어가 슬래시를 입력할 때 모두에게 보이는 자동 완성 목록에서 명령을 숨깁니다. 어드민이 명령을 끝까지 입력하면 그래도 작동합니다.
2단계: 나만의 명령 추가하기
commands 테이블에 항목을 추가하세요. 예를 들어 점프 힘을 설정하는 /jump Name 100 명령은 이렇게 만듭니다.
speed항목을 복사해 이름을jump로 바꾸세요.- 그 안에서
humanoid.UseJumpPower = true와humanoid.JumpPower = math.clamp(power, 0, 300)를 설정하세요.
공지처럼 모두에게 보내는 메시지는 모든 클라이언트가 화면에 표시하는 RemoteEvent로 보내세요. 플레이어가 읽을 수 있고 입력된 텍스트에서 나온 내용은 먼저 Roblox의 텍스트 필터링을 거쳐야 하므로, 공지에는 정해진 메시지를 쓰거나 TextService:FilterStringAsync로 필터링하세요.
테스트하기
- 내가 소유한 플레이스에서 Play를 누르세요. 채팅에
/speed me 60을 입력하면 더 빨리 달리고, 채팅에는 메시지가 나타나지 않습니다. - 떨어진 뒤
/heal me를 입력해 체력이 돌아오는지 확인하세요. - 플레이어 2명 테스트를 실행하세요(Test 탭, Clients and Servers). Player1에서
/tp Player2를 입력합니다. 어드민이 아닌 Player2에서/kill Player1을 입력하면 아무 일도 일어나지 않습니다.
자주 발생하는 오류와 해결 방법
명령이 아무것도 하지 않으면 먼저 Output 창과 아래 항목을 확인하세요.
명령이 채팅에 나타나고 아무 일도 일어나지 않음
TextChatCommand는 TextChatService에 속합니다. TextChatService의 ChatVersion 속성을 확인하고, 스크립트가 ServerScriptService 안의 Script인지, Output에 빨간 오류가 없는지도 확인하세요.
라이브 게임에서 내 명령이 아무것도 하지 않음
내 user ID가 ADMINS에 없습니다. Studio 예외는 Studio에서만, 그리고 그룹이 아닌 내 개인 계정이 소유한 플레이스에서만 적용됩니다.
/tp가 아무것도 하지 않음
두 플레이어 모두 월드에 캐릭터가 있어야 합니다. 대상 이름을 확인하세요. 이름이나 표시 이름의 앞부분만 써도 되지만 오타가 있으면 아무도 찾지 못합니다.
모더레이터와 소유자 같은 등급을 두고 싶음
ADMINS를 user ID에 등급 번호를 연결하도록 바꾸고, 명령마다 실행할 수 있는 최소 등급을 지정하세요.
RoCode로 만들어 보기
직접 설정하고 싶지 않다면 RoCode가 열려 있는 플레이스에 만들어 줄 수 있습니다. RoCode는 Roblox가 만든 것이 아닌 독립적인 Roblox Studio용 AI 에이전트입니다. 웹 채팅에서 변경 사항을 설명하면 Studio 플러그인이 내 Explorer에 스크립트를 만듭니다.
나와 내 친구(user ID 111과 222)를 위한 어드민 명령어를 추가해 줘: /kick, /tp, /speed, /heal, /kill, /fly, 서버에서 확인하도록.
- 내 어드민 ID와 내가 설명한 추가 명령을 담은 명령 스크립트를 작성합니다
- 먼저 플레이스를 읽어 기존 채팅 설정처럼 이미 있는 것을 활용할 수 있습니다
- 모든 스크립트가 컴파일되는지 Check Script로 확인하도록 지시받으며, 변경 묶음마다 실행 취소 지점을 만듭니다
명령을 플레이 테스트로 확인하는 일은 여전히 직접 해야 하며, 어드민 확인을 테스트하려면 두 번째 플레이어가 필요합니다. RoCode가 Studio에 연결되는 방식.
자주 묻는 질문
내 Roblox 게임에 어드민 명령어를 어떻게 추가하나요?
서버 Script에서 TextChatCommand를 만들고, 각 Triggered 핸들러에서 무언가를 하기 전에 보낸 사람의 user ID를 어드민 목록과 대조하세요. 전체 스크립트는 1단계에 있습니다.
HD Admin이나 Adonis가 필요한가요?
아니요. Creator Store의 어드민 시스템은 많은 명령과 패널을 추가하지만, 내가 작성하지 않은 큰 코드입니다. 짧은 나만의 스크립트는 필요한 일만 정확히 하고 그 이상은 하지 않습니다.
Roblox에서 내 user ID는 어떻게 알 수 있나요?
roblox.com에서 내 프로필을 여세요. 링크에서 /users/와 /profile 사이에 있는 숫자가 내 user ID입니다.
플레이어들이 채팅에서 어드민 명령어를 보나요?
아니요. TextChatCommand와 일치한 메시지는 다른 플레이어에게 전송되지 않습니다.
출처와 더 읽을거리
- Roblox Creator Docs: TextChatCommand (영어). 별칭, AutocompleteVisible, Triggered
- Roblox Creator Docs: Custom text chat commands (영어). 명령을 처리하는 서버 Script
- Roblox Creator Docs: Player:Kick (영어). 메시지와 함께 플레이어 내보내기
- Roblox Creator Docs: Text filtering (영어). 입력된 텍스트를 필터링해야 하는 경우
코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.