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
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.
| Gõ vào chat | Điều xảy ra |
|---|---|
/kick Name | Đuổi người chơi đó khỏi server. |
/tp Name | Dị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 Name | Hồi đầy máu cho họ. |
/kill Name | Hạ 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
- Đả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.
- Chèn một Script vào ServerScriptService với tên
AdminCommandsvà dán code bên dưới. - Thay
123456trongADMINSbằng user ID của bạn.
-- 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
speedvà đổi tên thànhjump. - Bên trong, đặt
humanoid.UseJumpPower = truevà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
- 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. - Sau khi ngã, gõ
/heal međể kiểm tra máu được hồi lại. - 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.
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.
- 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
- Roblox Creator Docs: TextChatCommand (tiếng Anh). alias, AutocompleteVisible và Triggered
- Roblox Creator Docs: Custom text chat commands (tiếng Anh). Script server xử lý lệnh
- Roblox Creator Docs: Player:Kick (tiếng Anh). đuổi người chơi kèm thông báo
- Roblox Creator Docs: Text filtering (tiếng Anh). khi nào văn bản được gõ cần lọc
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.