Hướng dẫn · Gameplay

Cách làm lệnh admin trong Roblox Studio

Lệnh admin cho phép bạn điều khiển game của mình ngay từ khung chat: đuổi người vi phạm, dịch chuyển tới chỗ bạn bè, thử tốc độ. Trong hệ thống chat hiện tại của Roblox, TextChatService, lệnh được tích hợp sẵn qua TextChatCommand. Trong hướng dẫn này, bạn sẽ dựa vào nó để thêm một bộ lệnh admin, và mỗi lệnh được kiểm tra trên server theo danh sách user ID, nên không ai khác dùng được.

Cập nhật ngày 20 tháng 11, 20265 phút đọcTác giả:

Tóm tắt

Trong một Script ở ServerScriptService, tạo một TextChatCommand cho mỗi lệnh, đặt PrimaryAlias cho nó (ví dụ "/kick") và đặt nó vào TextChatService. Sự kiện Triggered của nó truyền TextSource của người gửi và toàn bộ nội dung tin nhắn. Tìm người chơi qua Players:GetPlayerByUserId(textSource.UserId), kiểm tra user ID của họ có trong danh sách admin của bạn, rồi tách tin nhắn thành từng từ và thực hiện hành động.

  • Kiểm tra danh sách admin trên server. Kẻ dùng exploit có thể vượt qua bước kiểm tra trong LocalScript.
  • Kiểm tra user ID, không phải tên: người chơi có thể đổi tên, còn ID thì không bao giờ đổi.
  • Tin nhắn khớp với một lệnh sẽ không hiện trong chat, nên lệnh không làm rối khung chat của người chơi khác.
Trong trang này
  1. Cách hoạt động
  2. 1. Script
  3. 2. Lệnh riêng
  4. Common errors
  5. With RoCode
  6. Câu hỏi thường gặp
  7. Nguồn và tài liệu đọc thêm

Lệnh chat hoạt động thế nào

TextChatCommand bên trong TextChatService theo dõi các tin nhắn trong chat. Khi một tin nhắn bắt đầu bằng PrimaryAlias hoặc SecondaryAlias của nó, theo sau là dấu cách hoặc không có gì, Roblox không gửi tin nhắn tới người chơi khác mà gọi Triggered. Việc so khớp với alias không phân biệt chữ hoa chữ thường. Ví dụ lệnh tùy chỉnh của Roblox kết nối với Triggered trong một Script server, và đó chính là chỗ đặt bước kiểm tra admin.

Các lệnh trong hướng dẫn này
Gõ vào chatĐiều xảy ra
/kick NameĐuổi người chơi đó khỏi server.
/tp NameDịch chuyển bạn tới chỗ họ. /tp Name1 Name2 đưa Name1 tới chỗ Name2.
/speed Name 50Đặt WalkSpeed của họ (từ 0 tới 200). Không có số thì trả về 16.
/heal NameHồi đầy máu cho họ.
/kill NameHạ gục nhân vật của họ.

Thay cho tên, bạn có thể viết me, all hoặc others, và chỉ cần phần đầu của tên: /heal ro hồi máu cho mọi người chơi có tên hoặc tên hiển thị bắt đầu bằng "ro".

Bước 1: thêm các lệnh

  1. Đảm bảo game dùng TextChatService: chọn TextChatService trong Explorer và xem ChatVersion trong cửa sổ Properties. Nếu trong place cũ mục này vẫn là LegacyChatService, trang của Roblox về chat văn bản trong game có phần hướng dẫn chuyển đổi.
  2. Chèn một Script vào ServerScriptService với tên AdminCommands và dán code bên dưới.
  3. Thay 123456 trong ADMINS bằng user ID của bạn.
Script trong ServerScriptService tên là AdminCommands
-- Script trong ServerScriptService, tên là AdminCommands.
-- Lệnh chat cho các user ID trong ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")

-- User ID của bạn là con số trong đường link trang cá nhân: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
	[123456] = true,
}

local function isAdmin(userId: number): boolean
	-- Khi playtest trong Studio ở place bạn sở hữu cá nhân, bạn cũng được tính là admin
	local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
	return ADMINS[userId] == true or ownerInStudio
end

-- Tìm người chơi theo phần đầu của tên hoặc tên hiển thị, hoặc "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: tới chỗ họ. /tp name1 name2: đưa name1 tới chỗ 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,
}

-- Tạo một TextChatCommand cho mỗi lệnh. Chỉ admin mới nhận được kết quả; với người khác
-- lệnh không làm gì, và tin nhắn cũng không hiện trong chat.
for name, handler in commands do
	local command = Instance.new("TextChatCommand")
	command.Name = "Admin_" .. name
	command.PrimaryAlias = "/" .. name
	command.AutocompleteVisible = false -- lệnh không xuất hiện trong gợi ý của người chơi khác
	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

Bảng commands gắn mỗi tên với một hàm. Vòng lặp ở cuối biến mỗi mục thành một TextChatCommand, nên thêm lệnh mới chỉ là thêm một mục vào bảng. string.split(unfilteredText, " ") tách tin nhắn thành từng từ: args[1] là lệnh, args[2] là mục tiêu, args[3] là số hoặc mục tiêu thứ hai.

AutocompleteVisible = false ẩn các lệnh khỏi phần gợi ý mà mọi người chơi thấy khi gõ dấu gạch chéo. Nếu admin gõ đầy đủ lệnh, nó vẫn chạy.

Bước 2: thêm lệnh của riêng bạn

Thêm một mục vào bảng commands. Ví dụ, lệnh /jump Name 100 để đặt lực nhảy:

  • Sao chép mục speed và đổi tên thành jump.
  • Bên trong, đặt humanoid.UseJumpPower = true và humanoid.JumpPower = math.clamp(power, 0, 300).

Với tin nhắn gửi cho mọi người, ví dụ thông báo, hãy gửi qua một RemoteEvent mà mỗi client hiện lên màn hình. Mọi thứ người chơi đọc được mà đến từ văn bản được gõ đều phải qua bộ lọc văn bản của Roblox trước, nên hãy dùng tin nhắn cố định cho thông báo hoặc lọc chúng qua TextService:FilterStringAsync.

Kiểm tra

  1. Bấm Play trong một place bạn sở hữu. Gõ vào chat /speed me 60: bạn chạy nhanh hơn, còn tin nhắn không hiện trong chat.
  2. Sau khi ngã, gõ /heal me để kiểm tra máu được hồi lại.
  3. Chạy bài test 2 người chơi (tab Test, Clients and Servers). Từ Player1, gõ /tp Player2. Từ Player2, người không phải admin, gõ /kill Player1: sẽ không có gì xảy ra.

Lỗi thường gặp và cách sửa

Nếu lệnh không làm gì, hãy xem cửa sổ Output trước và kiểm tra các mục này.

Lệnh hiện trong chat và không có gì xảy ra

TextChatCommand thuộc về TextChatService. Kiểm tra thuộc tính ChatVersion của TextChatService, đồng thời chắc chắn script là Script trong ServerScriptService và Output không có lỗi màu đỏ.

Trong game thật, lệnh của tôi không làm gì

User ID của bạn không có trong ADMINS. Ngoại lệ cho Studio chỉ áp dụng trong Studio và chỉ cho place thuộc tài khoản cá nhân của bạn, không phải của group.

/tp không làm gì

Cả hai người chơi phải có nhân vật trong thế giới. Kiểm tra tên mục tiêu: chỉ cần phần đầu của tên hoặc tên hiển thị, nhưng gõ sai thì sẽ không tìm thấy ai.

Tôi muốn có cấp bậc, ví dụ moderator và owner

Sửa ADMINS để mỗi user ID ứng với một số cấp bậc, và đặt cho mỗi lệnh cấp bậc tối thiểu được phép chạy nó.

Làm bằng RoCode

Nếu bạn không muốn tự thiết lập, RoCode có thể làm việc này trong place bạn đang mở. RoCode là AI agent độc lập cho Roblox Studio, không phải của Roblox: bạn mô tả thay đổi trong web chat, còn plugin cho Studio của nó tạo script trong Explorer của bạn.

Bạn gõ

Thêm lệnh admin cho tôi và bạn tôi (user ID 111 và 222): /kick, /tp, /speed, /heal, /kill và /fly, có kiểm tra trên server.

RoCode làm
  • Viết script lệnh với ID admin của bạn và mọi lệnh bổ sung bạn mô tả
  • Có thể đọc place của bạn trước để dùng những gì đã có, ví dụ phần thiết lập chat hiện tại
  • Nó được dặn kiểm tra biên dịch mọi script bằng Check Script, và đặt điểm hoàn tác quanh mỗi nhóm thay đổi

Bạn vẫn cần tự kiểm tra các lệnh trong playtest, và để kiểm tra phần admin thì cần người chơi thứ hai. RoCode kết nối với Studio thế nào.

Câu hỏi thường gặp

Làm sao thêm lệnh admin vào game Roblox của mình?

Tạo TextChatCommand trong một Script server, và trong mỗi handler Triggered, kiểm tra user ID của người gửi theo danh sách admin của bạn trước khi làm bất cứ gì. Script đầy đủ có ở bước 1.

Có cần HD Admin hay Adonis không?

Không. Các hệ thống admin trên Creator Store có thêm nhiều lệnh và một bảng điều khiển, nhưng đó là một lượng code lớn mà không phải bạn viết. Một script ngắn của riêng bạn làm đúng những gì bạn cần và không hơn.

Làm sao biết user ID Roblox của mình?

Mở trang cá nhân của bạn trên roblox.com: con số trong đường link nằm giữa /users/ và /profile chính là user ID của bạn.

Người chơi có thấy lệnh admin trong chat không?

Không. Tin nhắn khớp với một TextChatCommand không được gửi tới người chơi khác.

Nguồn và tài liệu đọc thêm

Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.

Thử RoCode trong chính game của bạn.

Mỗi ngày có credit miễn phí, không cần thẻ. Cài plugin, mô tả tính năng và xem kết quả xuất hiện trong Studio.