Singkatnya
Di sebuah Script di ServerScriptService, buat TextChatCommand untuk setiap command, atur PrimaryAlias-nya (misalnya "/kick") dan jadikan parent-nya TextChatService. Event Triggered-nya memberimu TextSource milik pengirim dan pesan lengkapnya. Cari pemainnya dengan Players:GetPlayerByUserId(textSource.UserId), cek bahwa user ID-nya ada di daftar admin kamu, lalu pecah pesannya menjadi kata-kata dan jalankan perintahnya.
- Cek daftar admin di server. Cek di LocalScript bisa dilewati oleh exploiter.
- Cek user ID, bukan nama: pemain bisa mengganti nama, tapi ID tidak pernah berubah.
- Pesan yang cocok dengan command tidak ditampilkan di chat, jadi command tidak membanjiri chat pemain lain.
Di halaman ini
Cara kerja chat command
TextChatCommand di dalam TextChatService memantau pesan yang dikirim di chat. Saat sebuah pesan diawali dengan PrimaryAlias atau SecondaryAlias-nya, diikuti spasi atau tidak diikuti apa pun, Roblox tidak mengirim pesan itu ke pemain lain dan menjalankan Triggered. Pencocokan alias tidak membedakan huruf besar dan kecil. Contoh custom command milik Roblox menyambungkan Triggered di Script server, dan di situlah cek admin seharusnya berada.
| Ketik di chat | Yang terjadi |
|---|---|
/kick Name | Mengeluarkan pemain itu dari server. |
/tp Name | Men-teleport kamu ke pemain itu. /tp Name1 Name2 mengirim Name1 ke Name2. |
/speed Name 50 | Mengatur WalkSpeed-nya (0 sampai 200). Tanpa angka, nilainya kembali ke 16. |
/heal Name | Memulihkan health-nya sampai penuh. |
/kill Name | Membunuh karakternya. |
Sebagai ganti nama, kamu bisa menulis me, all atau others, dan awal nama saja sudah cukup: /heal ro memulihkan setiap pemain yang nama atau display name-nya diawali "ro".
Langkah 1: Tambahkan command-nya
- Cek bahwa game kamu memakai TextChatService: pilih TextChatService di Explorer dan lihat ChatVersion di jendela Properties. Kalau place lama masih bertuliskan LegacyChatService, halaman in-experience text chat milik Roblox punya bagian tentang cara pindah.
- Sisipkan Script di ServerScriptService bernama
AdminCommandsdan tempel kode di bawah. - Ganti
123456diADMINSdengan user ID kamu.
-- Script di ServerScriptService bernama AdminCommands.
-- Chat command untuk user ID di ADMINS: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")
-- User ID kamu adalah angka di link profilmu: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
[123456] = true,
}
local function isAdmin(userId: number): boolean
-- Di playtest Studio pada place milikmu sendiri, kamu juga dihitung 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 dari awal nama atau display name-nya, 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 ke pemain itu. /tp name1 name2: kirim name1 ke 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,
}
-- Membuat satu TextChatCommand per command. Hanya admin yang mendapat hasil; untuk semua
-- orang lain command-nya tidak berbuat apa-apa, dan pesannya juga tidak tampil di chat.
for name, handler in commands do
local command = Instance.new("TextChatCommand")
command.Name = "Admin_" .. name
command.PrimaryAlias = "/" .. name
command.AutocompleteVisible = false -- sembunyikan command dari saran yang dilihat semua orang
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
Table commands memetakan setiap nama ke sebuah function. Loop di bagian bawah mengubah setiap entri menjadi TextChatCommand, jadi menambah command cukup dengan satu entri lagi di table itu. string.split(unfilteredText, " ") memecah pesan menjadi kata-kata: args[1] adalah command-nya, args[2] targetnya, args[3] sebuah angka atau target kedua.
AutocompleteVisible = false menyembunyikan command dari saran yang dilihat setiap pemain saat mengetik garis miring. Command tetap berjalan saat admin mengetiknya secara lengkap.
Langkah 2: Tambahkan command buatanmu sendiri
Tambahkan entri ke table commands. Misalnya, command /jump Name 100 yang mengatur jump power:
- Salin entri
speeddan ganti namanya jadijump. - Di dalamnya, atur
humanoid.UseJumpPower = truedanhumanoid.JumpPower = math.clamp(power, 0, 300).
Untuk pesan ke semua orang, seperti pengumuman, kirim lewat RemoteEvent (panduan dalam bahasa Inggris) yang ditampilkan setiap client di layar. Apa pun yang bisa dibaca pemain dan berasal dari teks yang diketik harus melewati filter teks Roblox dulu, jadi batasi pengumuman ke pesan yang sudah ditentukan, atau filter dengan TextService:FilterStringAsync.
Tes
- Tekan Play di place milikmu. Ketik
/speed me 60di chat: kamu berlari lebih cepat, dan pesannya tidak muncul di chat. - Ketik
/heal mesetelah jatuh untuk mengecek health-nya pulih. - Mulai tes 2 pemain (tab Test, Clients and Servers). Dari Player1 ketik
/tp Player2. Dari Player2, yang bukan admin, ketik/kill Player1: tidak terjadi apa-apa.
Error umum dan cara memperbaikinya
Kalau sebuah command tidak berbuat apa-apa, cek jendela Output dan hal-hal ini dulu.
Command yang diketik muncul di chat dan tidak terjadi apa-apa
TextChatCommand adalah bagian dari TextChatService. Cek properti ChatVersion milik TextChatService, dan pastikan script-nya adalah Script di ServerScriptService tanpa error merah di Output.
Command tidak berbuat apa-apa untukku di game live
User ID kamu tidak ada di ADMINS. Pengecualian Studio hanya berlaku di Studio dan hanya untuk place milik akunmu sendiri, bukan milik grup.
/tp tidak berbuat apa-apa
Kedua pemain harus punya karakter di dunia game. Cek nama targetnya: awal nama atau display name sudah cukup, tapi salah ketik tidak cocok dengan siapa pun.
Aku mau pangkat seperti moderator dan owner
Ubah ADMINS supaya memetakan user ID ke angka pangkat, dan beri setiap command pangkat terendah yang boleh menjalankannya.
Buat dengan RoCode
Kalau kamu tidak mau menyiapkan ini secara manual, RoCode bisa membuatnya di place yang sedang kamu buka. RoCode adalah agen AI independen untuk Roblox Studio, bukan buatan Roblox: kamu menjelaskan perubahannya di web chat, dan plugin Studio-nya membuat script di Explorer kamu.
Tambahkan admin command untukku dan temanku (user ID 111 dan 222): /kick, /tp, /speed, /heal, /kill dan /fly, dicek di server.
- Menulis script command dengan ID admin kamu dan command tambahan apa pun yang kamu jelaskan
- Bisa membaca place kamu dulu untuk memakai ulang yang sudah ada, seperti setup chat yang sudah ada
- Diperintahkan untuk mengecek compile setiap script dengan Check Script, dan memasang titik undo di sekitar setiap batch
Kamu tetap mengetes command-nya di playtest, dan dengan pemain kedua untuk cek admin. Cara RoCode tersambung ke Studio.
Pertanyaan umum
Bagaimana cara menambahkan admin command ke game Roblox?
Buat TextChatCommand di Script server, dan di setiap handler Triggered cek user ID pengirim terhadap daftar admin kamu sebelum menjalankan apa pun. Langkah 1 berisi script lengkapnya.
Apakah aku butuh HD Admin atau Adonis?
Tidak. Sistem admin dari Creator Store menambah banyak command dan sebuah panel, tapi isinya kode besar yang tidak kamu tulis sendiri. Script pendek buatanmu sendiri melakukan persis yang kamu butuhkan dan tidak lebih.
Bagaimana cara mencari user ID Roblox-ku?
Buka profilmu di roblox.com: angka di link-nya, di antara /users/ dan /profile, adalah user ID kamu.
Apakah pemain bisa melihat admin command di chat?
Tidak. Pesan yang cocok dengan TextChatCommand tidak dikirim ke pemain lain.
Sumber dan bacaan lanjutan
- Roblox Creator Docs: TextChatCommand (dalam bahasa Inggris). alias, AutocompleteVisible dan Triggered
- Roblox Creator Docs: Custom text chat commands (dalam bahasa Inggris). Script server yang menangani sebuah command
- Roblox Creator Docs: Player:Kick (dalam bahasa Inggris). mengeluarkan pemain dengan sebuah pesan
- Roblox Creator Docs: Text filtering (dalam bahasa Inggris). kapan teks yang diketik harus difilter
Cara kode ini dicek: setiap skrip di halaman ini lolos pemeriksa tipe strict Luau dengan definisi API Roblox (luau-lsp, 12 November 2026). Pemeriksaan tipe menangkap nama API yang salah ketik dan tipe yang keliru, bukan logika game, jadi uji dulu di Studio sebelum dipublikasikan.