Ringkasnya
Dalam Script di ServerScriptService, cipta TextChatCommand untuk setiap arahan, tetapkan PrimaryAlias (contohnya "/kick") dan letakkannya dalam TextChatService. Event Triggered menghantar TextSource pengirim dan teks penuh mesej. Cari pemain melalui Players:GetPlayerByUserId(textSource.UserId), semak bahawa user ID beliau ada dalam senarai admin anda, kemudian pecahkan mesej kepada perkataan dan jalankan tindakan.
- Semak senarai admin pada pelayan. Semakan dalam LocalScript boleh dipintas oleh exploiter.
- Semak user ID, bukan nama: pemain boleh menukar nama, tetapi ID tidak pernah berubah.
- Mesej yang sepadan dengan arahan tidak dipaparkan dalam chat, jadi arahan tidak menyemakkan chat pemain lain.
Di halaman ini
Cara arahan chat berfungsi
TextChatCommand di dalam TextChatService memerhati mesej dalam chat. Apabila mesej bermula dengan PrimaryAlias atau SecondaryAliasnya, diikuti ruang atau tiada apa-apa, Roblox tidak menghantar mesej itu kepada pemain lain dan sebaliknya mencetuskan Triggered. Perbandingan dengan alias tidak mengambil kira huruf besar. Contoh arahan tersuai daripada Roblox menyambung ke Triggered dalam Script pelayan, dan di situlah tempat untuk semakan admin.
| Apa yang ditaip dalam chat | Apa yang berlaku |
|---|---|
/kick Name | Membuang pemain itu daripada pelayan. |
/tp Name | Teleport anda kepadanya. /tp Name1 Name2 menghantar Name1 kepada Name2. |
/speed Name 50 | Menetapkan WalkSpeed beliau (0 hingga 200). Tanpa nombor, ia kembali kepada 16. |
/heal Name | Memulihkan kesihatan beliau sepenuhnya. |
/kill Name | Membunuh watak beliau. |
Sebagai ganti nama, anda boleh tulis me, all atau others, dan permulaan nama sudah memadai: /heal ro memulihkan semua pemain yang nama atau nama paparannya bermula dengan "ro".
Langkah 1: tambah arahan
- Pastikan game menggunakan TextChatService: pilih TextChatService dalam Explorer dan lihat ChatVersion dalam tetingkap Properties. Jika place lama masih menunjukkan LegacyChatService, halaman Roblox tentang chat teks dalam game ada bahagian tentang cara beralih.
- Masukkan Script ke dalam ServerScriptService bernama
AdminCommandsdan tampal kod di bawah. - Gantikan
123456dalamADMINSdengan user ID anda.
-- Script dalam ServerScriptService bernama AdminCommands.
-- Arahan chat untuk user ID dalam ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")
-- User ID anda ialah nombor dalam pautan profil: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
[123456] = true,
}
local function isAdmin(userId: number): boolean
-- Dalam playtest Studio pada place yang anda miliki sendiri, anda juga dikira sebagai admin
local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
return ADMINS[userId] == true or ownerInStudio
end
-- Mencari pemain mengikut permulaan nama atau nama paparan, atau "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: pergi kepadanya. /tp name1 name2: hantar name1 kepada 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,
}
-- Mencipta satu TextChatCommand bagi setiap arahan. Hanya admin mendapat hasilnya; bagi yang lain
-- arahan tidak berbuat apa-apa, dan mesejnya juga tidak dipaparkan dalam chat.
for name, handler in commands do
local command = Instance.new("TextChatCommand")
command.Name = "Admin_" .. name
command.PrimaryAlias = "/" .. name
command.AutocompleteVisible = false -- arahan tidak muncul dalam cadangan pemain lain
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
Jadual commands memadankan setiap nama dengan satu fungsi. Gelung di bawah menukar setiap entri menjadi TextChatCommand, jadi arahan baharu hanyalah satu entri dalam jadual. string.split(unfilteredText, " ") memecahkan mesej kepada perkataan: args[1] ialah arahan, args[2] sasaran, args[3] nombor atau sasaran kedua.
AutocompleteVisible = false membuang arahan daripada cadangan yang dilihat setiap pemain apabila menaip garis condong. Jika admin menaip arahan sepenuhnya, ia tetap berfungsi.
Langkah 2: tambah arahan sendiri
Tambah entri ke dalam jadual commands. Contohnya, arahan /jump Name 100 yang menetapkan kekuatan lompatan:
- Salin entri
speeddan namakan semula sebagaijump. - Di dalamnya, tetapkan
humanoid.UseJumpPower = truedanhumanoid.JumpPower = math.clamp(power, 0, 300).
Untuk mesej kepada semua orang, contohnya pengumuman, hantar melalui RemoteEvent yang dipaparkan oleh setiap client pada skrin. Apa sahaja yang boleh dibaca pemain dan berasal daripada teks yang ditaip mesti melalui penapisan teks Roblox dahulu, jadi gunakan mesej tetap untuk pengumuman atau tapis melalui TextService:FilterStringAsync.
Uji
- Tekan Play dalam place yang anda miliki. Taip
/speed me 60dalam chat: anda berlari lebih laju, dan mesej tidak muncul dalam chat. - Selepas jatuh, taip
/heal meuntuk menyemak bahawa kesihatan kembali. - Jalankan ujian 2 pemain (tab Test, Clients and Servers). Daripada Player1, taip
/tp Player2. Daripada Player2, yang bukan admin, taip/kill Player1: tiada apa yang berlaku.
Ralat biasa dan cara membaikinya
Jika arahan tidak berbuat apa-apa, semak tetingkap Output dan perkara ini dahulu.
Arahan muncul dalam chat dan tiada apa yang berlaku
TextChatCommand ialah sebahagian daripada TextChatService. Semak sifat ChatVersion pada TextChatService, dan pastikan skrip ialah Script dalam ServerScriptService serta tiada ralat merah dalam Output.
Dalam game sebenar, arahan saya tidak berbuat apa-apa
User ID anda tiada dalam ADMINS. Pengecualian Studio hanya berlaku dalam Studio dan hanya untuk place yang dimiliki oleh akaun peribadi anda, bukan kumpulan.
/tp tidak berbuat apa-apa
Kedua-dua pemain mesti ada watak dalam dunia. Semak nama sasaran: permulaan nama atau nama paparan sudah memadai, tetapi dengan salah ejaan tiada siapa akan dijumpai.
Saya mahu pangkat, contohnya moderator dan pemilik
Ubah ADMINS supaya user ID dipadankan dengan nombor pangkat, dan beri setiap arahan pangkat minimum yang dibenarkan menjalankannya.
Bina ini dengan RoCode
Jika anda tidak mahu menyediakan ini sendiri, RoCode boleh membinanya dalam place yang sedang anda buka. RoCode ialah ejen AI bebas untuk Roblox Studio, bukan daripada Roblox: anda terangkan perubahan dalam chat web, dan plugin Studionya mencipta skrip dalam Explorer anda.
Tambah arahan admin untuk saya dan rakan saya (user ID 111 dan 222): /kick, /tp, /speed, /heal, /kill dan /fly, dengan semakan pada pelayan.
- Menulis skrip arahan dengan ID admin anda dan apa-apa arahan tambahan yang anda terangkan
- Boleh membaca place anda dahulu untuk menggunakan apa yang sudah ada, contohnya tetapan chat sedia ada
- Ia diarah menyemak setiap skrip berjaya dikompil dengan Check Script, dan ia meletakkan titik undo di sekeliling setiap set perubahan
Anda masih perlu menguji arahan dalam playtest sendiri, dan untuk menyemak semakan admin anda perlukan pemain kedua. Cara RoCode bersambung dengan Studio.
Soalan lazim
Bagaimana menambah arahan admin dalam game Roblox sendiri?
Cipta TextChatCommand dalam Script pelayan dan dalam setiap pengendali Triggered, semak user ID pengirim berdasarkan senarai admin anda sebelum berbuat apa-apa. Skrip penuh ada dalam langkah 1.
Perlukah saya HD Admin atau Adonis?
Tidak. Sistem admin daripada Creator Store menambah banyak arahan dan panel, tetapi ia kod besar yang bukan anda tulis. Skrip sendiri yang pendek melakukan tepat apa yang anda perlukan dan tiada yang lain.
Bagaimana mengetahui user ID Roblox saya?
Buka profil anda di roblox.com: nombor dalam pautan antara /users/ dan /profile ialah user ID anda.
Adakah pemain nampak arahan admin dalam chat?
Tidak. Mesej yang sepadan dengan TextChatCommand tidak dihantar kepada pemain lain.
Sumber dan bacaan lanjut
- Roblox Creator Docs: TextChatCommand (dalam bahasa Inggeris). alias, AutocompleteVisible dan Triggered
- Roblox Creator Docs: Custom text chat commands (dalam bahasa Inggeris). Script pelayan yang mengendalikan arahan
- Roblox Creator Docs: Player:Kick (dalam bahasa Inggeris). membuang pemain dengan mesej
- Roblox Creator Docs: Text filtering (dalam bahasa Inggeris). bila teks yang ditaip perlu ditapis
Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.