Tutorial · Gameplay

Cara buat arahan admin dalam Roblox Studio

Arahan admin membolehkan anda mengawal game sendiri terus daripada chat: menendang pemain yang melanggar peraturan, teleport kepada rakan, menguji kelajuan. Dalam chat Roblox semasa, TextChatService, arahan sudah terbina dalam melalui TextChatCommand. Dalam panduan ini anda akan menambah satu set arahan admin berdasarkannya, dan setiap arahan disemak pada pelayan berdasarkan senarai user ID, jadi tiada orang lain boleh menggunakannya.

Dikemas kini 20 November 20264 minit bacaanDitulis oleh

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
  1. Cara ia berfungsi
  2. 1. Skrip
  3. 2. Arahan sendiri
  4. Common errors
  5. With RoCode
  6. Soalan lazim
  7. Sumber dan bacaan lanjut

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.

Arahan dalam panduan ini
Apa yang ditaip dalam chatApa yang berlaku
/kick NameMembuang pemain itu daripada pelayan.
/tp NameTeleport anda kepadanya. /tp Name1 Name2 menghantar Name1 kepada Name2.
/speed Name 50Menetapkan WalkSpeed beliau (0 hingga 200). Tanpa nombor, ia kembali kepada 16.
/heal NameMemulihkan kesihatan beliau sepenuhnya.
/kill NameMembunuh 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

  1. 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.
  2. Masukkan Script ke dalam ServerScriptService bernama AdminCommands dan tampal kod di bawah.
  3. Gantikan 123456 dalam ADMINS dengan user ID anda.
Script dalam ServerScriptService bernama AdminCommands
-- 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 speed dan namakan semula sebagai jump.
  • Di dalamnya, tetapkan humanoid.UseJumpPower = true dan humanoid.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

  1. Tekan Play dalam place yang anda miliki. Taip /speed me 60 dalam chat: anda berlari lebih laju, dan mesej tidak muncul dalam chat.
  2. Selepas jatuh, taip /heal me untuk menyemak bahawa kesihatan kembali.
  3. 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.

Anda tulis

Tambah arahan admin untuk saya dan rakan saya (user ID 111 dan 222): /kick, /tp, /speed, /heal, /kill dan /fly, dengan semakan pada pelayan.

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

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.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.