Tutorial · Gameplay

Cara membuat admin command di Roblox Studio

Admin command membuatmu bisa mengatur game sendiri dari kotak chat: kick pemain yang bikin onar, teleport ke teman, atau tes kecepatan. Chat Roblox yang sekarang, TextChatService, sudah punya command bawaan lewat TextChatCommand. Panduan ini menambahkan satu set admin command dengannya, semuanya dicek di server terhadap daftar user ID, jadi tidak ada orang lain yang bisa memakainya.

Diperbarui 12 November 20264 menit bacaDitulis oleh

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
  1. Cara kerjanya
  2. 1. Script-nya
  3. 2. Command sendiri
  4. Error umum
  5. Dengan RoCode
  6. Pertanyaan umum
  7. Sumber dan bacaan lanjutan

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.

Command di panduan ini
Ketik di chatYang terjadi
/kick NameMengeluarkan pemain itu dari server.
/tp NameMen-teleport kamu ke pemain itu. /tp Name1 Name2 mengirim Name1 ke Name2.
/speed Name 50Mengatur WalkSpeed-nya (0 sampai 200). Tanpa angka, nilainya kembali ke 16.
/heal NameMemulihkan health-nya sampai penuh.
/kill NameMembunuh 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

  1. 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.
  2. Sisipkan Script di ServerScriptService bernama AdminCommands dan tempel kode di bawah.
  3. Ganti 123456 di ADMINS dengan user ID kamu.
Script di ServerScriptService bernama AdminCommands
-- 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 speed dan ganti namanya jadi jump.
  • Di dalamnya, atur humanoid.UseJumpPower = true dan humanoid.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

  1. Tekan Play di place milikmu. Ketik /speed me 60 di chat: kamu berlari lebih cepat, dan pesannya tidak muncul di chat.
  2. Ketik /heal me setelah jatuh untuk mengecek health-nya pulih.
  3. 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.

Kamu ketik

Tambahkan admin command untukku dan temanku (user ID 111 dan 222): /kick, /tp, /speed, /heal, /kill dan /fly, dicek di server.

RoCode mengerjakan
  • 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

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.

Coba RoCode di game kamu sendiri.

Kredit gratis setiap hari, tanpa kartu. Pasang plugin-nya, jelaskan fiturnya, lalu cek hasilnya di Studio.