Eğitim · Oynanış

Roblox Studio'da admin komutları nasıl yapılır

Admin komutları oyununu doğrudan chat'ten yönetmeni sağlar: kuralları çiğneyen birini atmak, bir arkadaşının yanına ışınlanmak, bir hızı denemek. Roblox'un şu anki chat'i TextChatService'te komutlar TextChatCommand ile hazır geliyor. Bu rehberde onun üzerine bir admin komutları seti ekliyorsun ve her biri sunucuda bir user ID listesine göre kontrol ediliyor, yani başka kimse onları kullanamıyor.

Güncellendi: 20 Kasım 20264 dk okumaYazan:

Kısaca

ServerScriptService içindeki bir Script'te her komut için bir TextChatCommand oluştur, PrimaryAlias'ını ayarla (örneğin "/kick") ve onu TextChatService'in içine koy. Triggered event'i sana gönderenin TextSource'unu ve mesajın tamamını verir. Oyuncuyu Players:GetPlayerByUserId(textSource.UserId) ile bul, user ID'sinin admin listende olduğunu kontrol et, sonra mesajı kelimelere böl ve işlemi yap.

  • Admin listesini sunucuda kontrol et. Bir LocalScript'teki kontrolü bir exploiter atlatabilir.
  • İsimleri değil user ID'leri kontrol et: oyuncular adlarını değiştirebilir ama ID asla değişmez.
  • Bir komutla eşleşen mesaj chat'te görünmez, yani komutlar diğer oyuncuların chat'ini doldurmaz.
Bu sayfada
  1. Nasıl çalışır
  2. 1. Script
  3. 2. Kendi komutun
  4. Common errors
  5. With RoCode
  6. Sık sorulan sorular
  7. Kaynaklar ve ek okumalar

Chat komutları nasıl çalışır

TextChatService içindeki bir TextChatCommand chat'e gönderilen mesajları izler. Bir mesaj onun PrimaryAlias'ı ya da SecondaryAlias'ı ile başlayıp ardından bir boşluk gelirse ya da hiçbir şey gelmezse, Roblox mesajı diğer oyunculara göndermez ve onun yerine Triggered'ı çalıştırır. Alias eşleşmesi büyük küçük harfe bakmaz. Roblox'un özel komut örneği Triggered'a bir sunucu Script'inde bağlanır ve admin kontrolünün yeri de tam orası.

Bu rehberdeki komutlar
Chat'e ne yazarsınNe olur
/kick NameO oyuncuyu sunucudan atar.
/tp NameSeni onun yanına ışınlar. /tp Name1 Name2 Name1'i Name2'nin yanına gönderir.
/speed Name 50WalkSpeed'ini ayarlar (0 ile 200 arası). Sayı yoksa 16'ya döndürür.
/heal NameCanını tamamen doldurur.
/kill NameKarakterini öldürür.

Bir ad yerine me, all ya da others yazabilirsin ve adın başı yeterli: /heal ro adı ya da görünen adı "ro" ile başlayan tüm oyuncuları iyileştirir.

Adım 1: komutları ekle

  1. Oyununun TextChatService kullandığından emin ol: Explorer'da TextChatService'i seç ve Properties penceresinde ChatVersion'a bak. Eski bir place'te hâlâ LegacyChatService yazıyorsa, Roblox'un oyun içi metin chat'i sayfasında geçişle ilgili bir bölüm var.
  2. ServerScriptService'e AdminCommands adlı bir Script ekle ve aşağıdaki kodu yapıştır.
  3. ADMINS içindeki 123456'yı kendi user ID'nle değiştir.
Script konum: ServerScriptService adı: AdminCommands
-- ServerScriptService içinde AdminCommands adlı Script.
-- ADMINS içindeki user ID'ler için chat komutları: /kick, /tp, /speed, /heal, /kill.
local Players = game:GetService("Players")
local RunService = game:GetService("RunService")
local TextChatService = game:GetService("TextChatService")

-- User ID'n profil linkindeki sayıdır: roblox.com/users/123456/profile
local ADMINS: { [number]: boolean } = {
	[123456] = true,
}

local function isAdmin(userId: number): boolean
	-- Kendi hesabına ait bir place'te Studio testinde sen de admin sayılırsın
	local ownerInStudio = RunService:IsStudio() and game.CreatorType == Enum.CreatorType.User and userId == game.CreatorId
	return ADMINS[userId] == true or ownerInStudio
end

-- Oyuncuları adlarının ya da görünen adlarının başına göre, veya "me", "all", "others" ile bulur
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: ona git. /tp name1 name2: name1'i name2'nin yanına gönder.
		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,
}

-- Her komut için bir TextChatCommand oluşturur. Sonucu sadece adminler alır; diğerleri için
-- komut hiçbir şey yapmaz ve mesaj chat'te de görünmez.
for name, handler in commands do
	local command = Instance.new("TextChatCommand")
	command.Name = "Admin_" .. name
	command.PrimaryAlias = "/" .. name
	command.AutocompleteVisible = false -- komutlar diğer oyuncuların önerilerinde görünmez
	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

commands tablosu her ada bir fonksiyon eşler. Alttaki döngü her girişi bir TextChatCommand'a çevirir, yani yeni bir komut tabloya tek bir giriş eklemek demek. string.split(unfilteredText, " ") mesajı kelimelere böler: args[1] komuttur, args[2] hedef, args[3] de bir sayı ya da ikinci bir hedef.

AutocompleteVisible = false komutları her oyuncunun eğik çizgi yazınca gördüğü önerilerden çıkarır. Bir admin komutu tamamen yazarsa yine çalışır.

Adım 2: kendi komutunu ekle

commands tablosuna bir giriş ekle. Örneğin zıplama gücünü ayarlayan bir /jump Name 100 komutu:

  • speed girişini kopyala ve adını jump yap.
  • İçinde humanoid.UseJumpPower = true ve humanoid.JumpPower = math.clamp(power, 0, 300) ayarla.

Herkese gidecek bir mesaj için, örneğin bir duyuru, onu her client'ın ekranda gösterdiği bir RemoteEvent üzerinden gönder. Oyuncuların okuyabildiği ve yazılmış metinden gelen her şey önce Roblox'un metin filtresinden geçmeli, bu yüzden duyurular için sabit mesajlar kullan ya da onları TextService:FilterStringAsync ile filtrele.

Dene

  1. Sahibi olduğun bir place'te Play'e bas. Chat'e /speed me 60 yaz: daha hızlı koşarsın ve mesaj chat'te görünmez.
  2. Düştükten sonra canın geri geliyor mu diye /heal me yaz.
  3. 2 oyunculu bir test başlat (Test sekmesi, Clients and Servers). Player1'den /tp Player2 yaz. Admin olmayan Player2'den /kill Player1 yaz: hiçbir şey olmaz.

Sık yapılan hatalar ve çözümleri

Bir komut hiçbir şey yapmıyorsa önce Output penceresine ve bu maddelere bak.

Komut chat'te görünüyor ve hiçbir şey olmuyor

TextChatCommand TextChatService'e aittir. TextChatService'in ChatVersion özelliğini kontrol et, ayrıca scriptin ServerScriptService içinde bir Script olduğunu ve Output'ta kırmızı bir hata olmadığını da.

Yayındaki oyunda komut bende hiçbir şey yapmıyor

User ID'n ADMINS içinde değil. Studio istisnası sadece Studio'da ve sadece bir gruba değil kendi kişisel hesabına ait bir place için geçerli.

/tp hiçbir şey yapmıyor

İki oyuncunun da dünyada bir karakteri olmalı. Hedefin adını kontrol et: adın ya da görünen adın başı yeterli, ama yazım hatasıyla kimse bulunmaz.

Moderatör ve sahip gibi rütbeler istiyorum

ADMINS'i her user ID'ye bir rütbe numarası eşleyecek şekilde değiştir ve her komuta onu çalıştırabilecek en düşük rütbeyi ver.

RoCode ile yap

Bunu elle kurmak istemiyorsan RoCode onu açık olan place'inde kurabilir. RoCode Roblox Studio için bağımsız bir yapay zeka ajanı, Roblox'un değil: değişikliği bir web chat'inde anlatırsın, Studio plugin'i de scriptleri Explorer'ında oluşturur.

Sen yazarsın

Benim ve arkadaşım için admin komutları ekle (user ID 111 ve 222): /kick, /tp, /speed, /heal, /kill ve /fly, sunucuda kontrol edilsin.

RoCode yapar
  • Admin ID'lerinle ve anlattığın ek komutlarla komut scriptini yazar
  • Var olanı kullanmak için, örneğin mevcut bir chat ayarını, önce place'ini okuyabilir
  • Her scriptin derlendiğini Check Script ile kontrol etmesi söylenmiştir ve her değişiklik grubunun etrafına geri alma noktaları koyar

Komutları bir testte denemek yine sana kalıyor, admin kontrolü için de ikinci bir oyuncu gerekiyor. RoCode Studio'ya nasıl bağlanır.

Sık sorulan sorular

Roblox oyunuma admin komutları nasıl eklerim?

Bir sunucu Script'inde TextChatCommand'lar oluştur ve her Triggered işleyicisinde bir şey yapmadan önce gönderenin user ID'sini admin listene göre kontrol et. Tam script 1. adımda.

HD Admin ya da Adonis gerekli mi?

Hayır. Creator Store'daki admin sistemleri çok sayıda komut ve bir panel ekler, ama onlar senin yazmadığın büyük bir kod. Kendi kısa scriptin tam olarak ihtiyacın olanı yapar, fazlasını değil.

Roblox user ID'mi nasıl bulurum?

roblox.com'da profilini aç: linkte /users/ ile /profile arasındaki sayı senin user ID'n.

Oyuncular admin komutlarını chat'te görür mü?

Hayır. Bir TextChatCommand ile eşleşen mesaj diğer oyunculara gönderilmez.

Kaynaklar ve ek okumalar

Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.