Özel Komutlar
Tip
Bonus komutlara buradan göz atabilirsin.
Komutlar¶
Komutlar, ne olduklarını ve nasıl çalışacaklarını anlatan basit tablolardır. Bu şekilde tasarlanmalarının birkaç temel nedeni var:
| Bellek | Bir komut çalıştırıldığında artık bir 'görev' olarak temsil edilebilir ve yetkililer bunu kolayca görüp iptal edebilir. Görevler kendilerini otomatik temizler, yani bellek asla sızmaz. Ayrıca ayrı bir undo fonksiyonu yazmana bile gerek kalmaz. |
| Erişim | Görevler artık komutu çalıştıran belirli bir oyuncuya (yani çağırana) bağlı olmadığı için her komut her değiştirici ile çalışabilir. Yani yazdığın komutlar anında tüm sunuculara yayınlanabilir. |
| Güvenlik | Argümanlar run çağrılmadan önce doğrulanır. Yani bir Player argümanı gerçek bir Player olarak gelir, bir Number her zaman izin verilen aralığın içinde gelir, vb. Kodun hiçbir zaman ham metinle uğraşmaz ve çağıranlar rollerinin kullanamadığı bir komutu asla çalıştıramaz. |
| Arayüz | Run sayfası, komut çubuğu önerileri ve otomatik tamamlamalar args alanından otomatik üretilir. Böylece yazdığın her komut, sohbet edemeyen oyuncular için de anında kullanılabilir olur. |
| Tipli | Komutlar tamamen tiplidir. Komutlarını CommandAPI.Commands ile işaretlersen yazarken otomatik tamamlama ve tip uyarıları alırsın. |
Kendi komutunu oluştur¶
ConfigCommands altında mevcut Custom modülünü genişletebilir ya da istediğin kadar komut tablosu içeren kendi modülünü ekleyebilirsin:

--!strict
-- LOCAL
local TAGS = {"CoolCommands"}
local StarterPlayer = game:GetService("StarterPlayer")
local CommandAPI = require(script:FindFirstAncestor("HD Admin").Core.CommandAPI)
local getHumanoid = CommandAPI.getHumanoid
local getHRP = CommandAPI.getHRP
-- COMMANDS
local commands: CommandAPI.Commands = {
--------------------
{
name = "Jump",
args = {"Player"},
tags = TAGS,
run = function(task: CommandAPI.Task)
local target = task.target
local humanoid = getHumanoid(target)
if not humanoid then return end
humanoid.Jump = true
end,
},
--------------------
{
name = "Fire",
args = {"Player"},
tags = TAGS,
run = function(task: CommandAPI.Task)
local target = task.target
local hrp = getHRP(target)
if not hrp then return end
task:keep("UntilTargetRespawns")
local fire = task.janitor:add(Instance.new("Fire"))
fire.Parent = hrp
end,
},
--------------------
}
return commands
İstemci komutları¶
Komut kodu varsayılan olarak sadece sunucuda bulunur ve orada çalışır, ama bazen istemcide çalışması gerekebilir. Bunun için komut modülünün altına Client adında bir ModuleScript ekleyebilirsin. İçindeki komut tablolarının name değerleri sunucudaki komutlarla aynı olmalı:
--!strict
-- LOCAL
local TAGS = {script.Name}
local CommandAPI = require(script:FindFirstAncestor("HD Admin").Core.CommandAPI)
-- COMMANDS
local commands: CommandAPI.Commands = {
--------------------
{
name = "Flash",
args = {"Player"},
tags = TAGS,
run = function(task: CommandAPI.Task)
local target = task.target
task.client:run(target)
end,
},
--------------------
}
return commands
--!strict
-- LOCAL
local CommandAPI = require(script:FindFirstAncestor("HD Admin").Core.CommandAPI)
local Players = game:GetService("Players")
local TweenService = game:GetService("TweenService")
-- COMMANDS
local clientCommands: CommandAPI.ClientCommands = {
--------------------
{
name = "Flash",
run = function(task: CommandAPI.Task)
local localPlayer = Players.LocalPlayer
local playerGui = localPlayer:FindFirstChildOfClass("PlayerGui")
if not playerGui then
return
end
local screenGui = Instance.new("ScreenGui")
screenGui.Name = "HDCustomFlash"
screenGui.IgnoreGuiInset = true
screenGui.DisplayOrder = 999
local frame = Instance.new("Frame")
frame.BackgroundColor3 = Color3.new(1, 1, 1)
frame.Size = UDim2.fromScale(1, 1)
frame.Parent = screenGui
screenGui.Parent = playerGui
local tween = TweenService:Create(frame, TweenInfo.new(1), {BackgroundTransparency = 1})
tween.Completed:Once(function()
screenGui:Destroy()
end)
tween:Play()
end,
},
--------------------
}
return clientCommands
Yanıp sönen görüntüler içerir. Görmek için tıkla
Info
Hiçbir şeyi kendin replike etmen gerekmez. Framework, Client adlı her alt modülü algılar ve otomatik olarak oyunculara taşır.
Komut alanları¶
name dışındaki her alan isteğe bağlıdır:
| Adlandırma | |
|---|---|
name Shared |
Gösterilen komut başlığı ve oyuncuların ön eklerinden sonra yazdığı şey. Aynı zamanda geri alma adıdır, yani ;speed komutu ;unspeed ile biter |
aliases Server |
Bu komutu tetikleyen diğer adlar`` |
undoAliases Server |
Komutu çalıştırmak yerine geri alan adlar (örneğin NoClip, {"Clip"} kullanır) |
description Server |
Komutun çalıştırma sayfasında altında gösterilen bir cümle |
credit Server |
Komut için kimin adının anılacağı (örneğin {"GigsD4X"}) |
| Çalışma | |
|---|---|
args Server |
Komutunun aldığı argümanlar (örneğin "Player", "Text", "Number", vb. Tam listeyi MainModuleValueModulesParserArgs altında bulabilirsin |
run Shared |
Komutunun kodu. Sunucuda bir görev ve doğrulanmış argümanlar verilir, istemcide ise bir görev ve sunucunun task.client:run ile ona ilettiği değerler verilir |
replication Client |
Sunucudan dönen verinin ulaştığı fonksiyon. İstemcin task.server:replicate çağırır, sunucunun task.client.replicator fonksiyonu kimin alacağını seçer, sonra bu fonksiyon onların istemcisinde çalışır |
config Server |
Oyun geliştiricilerinin, dahili komutları yüklerken modify ile değiştirebileceği varsayılan değerler |
cooldown Server |
Komut bittikten sonra tekrar çalışabilmesi için beklenecek saniye |
stackable Server |
Normalde bir oyuncuda/sunucuda aynı anda sadece bir komut aktif olabilir, ama bu true olduğunda birden fazlası aynı anda çalışabilir |
groups Server |
Aynı gruptaki komutlar aynı oyuncu üzerinde birbirini geri alır (örneğin Fly ve NoClip ikisi de "Flight" grubundadır, yani birini başlatmak diğerini bitirir) ve cooldown paylaşır. İki grubun ekstra bir anlamı var: "Prompt" mesaj tarzı komutları işaretler. Bunlar hiçbir şey yazılmasa bile dakikada bir metin sınırını harcar ve Block prompts ayarıyla filtrelenir. "Map" ise haritayı düzenleyen komutları işaretler, yani çalışan ilk komut ;clearmap için sessizce bir kopya saklar |
| Erişim | |
|---|---|
tags Server |
Bu komutun miras alacağı etiketler. Roller hangi komutları miras alacağına bunlara bakarak karar verir |
disableModifiers Server |
Komutta değiştiricilerin kullanılmasını engeller |
disableGlobalModifiers Server |
Komutta global değiştiricilerin (örneğin global, perm, join, vb.) kullanılmasını engeller |
| Arayüz | |
|---|---|
order Server |
Komutlar sayfasındaki sırası. Küçük sayılar önce gelir |
hide Server |
Komutu Komutlar sayfasından gizler |
autoPreview Server |
Komut sohbetten veya hızlı önizleme düğmesinden çalıştırıldığında, komutu çalıştırmak yerine Run sayfasını açar (örneğin Ban bunu, ayrıntıları önce onaylatmak için kullanır) |
Özel argümanlar¶
Yerleşik argümanlar (MainModuleValueModulesParserArgs altında) ihtiyacın olan çoğu şeyi karşılar. Yine de kendi argümanını oluşturmak istersen bunu Config > Args altında yapabilirsin:

return function(Args)
return {
["Radius"] = Args.createAliasOf("Number", {
display = "Radius",
min = 0,
max = 500,
step = 1,
default = 50,
}),
}
end
Warning
Seçtiğin ad HD Admin'in yerleşik argümanlarından biriyle aynı olmasın. Aksi halde başlangıçta uyarı verir ve biri diğerinin önüne geçer.
Tek bir komutun argümanlarını değiştirmek istersen, argüman adını bir argüman tablosuyla değiştirebilirsin:
args = {
"Player",
{arg = "Number", display = "Speed", default = 50, min = 0, max = 1000, step = 1, logarithmic = true},
},
args = {
"Player",
"Number",
},
Tip
Bu, bir argümanın davranışını tamamen değiştirmeden sadece sınırlarını güncellemek istediğinde işe yarar:

Diğer oyuncuların gördüğü metin
Roblox'un yaş güvenliği politikaları, bir oyuncunun başkalarına gösterdiği metni dakikada bir ile sınırlar. HD Admin her metin argümanını filtreler ve o türün bir dakikalık sınırını harcar. Bu sınır, o türdeki tüm komutlar arasında ortaktır:
| Arg | Ne için kullanılır |
|---|---|
"Text" |
Mesaj, ipucu, bildirim, uyarı veya anket olarak gösterilen her şey |
"SurfaceText" |
Bir oyuncunun üstünde veya dünyada gösterilen adlar, başlıklar ve etiketler |
"ChatText" |
Sohbet etiketleri ve sohbet adları |
"Reason" |
Kick ve ban sebepleri |
Türü kendin seçmek için bir argüman tablosuna textSurface ekle, örneğin {arg = "Text", textSurface = "SurfaceText"}. Başkalarına sadece bazen gösterilen metin için "None" kullan, sonra gösterildiği anda checkTextLimit fonksiyonunu çağır.
Argümanlar¶
Bir komutun argümanını almak için task:getArg() kullan ve adını ya da indeksini ver:
args = {"Player", "Number"},
run = function(task: CommandAPI.Task)
local target = task:getArg("Player")
local number = task:getArg("Number")
-- ...
end
args = {"Player", "Number"},
run = function(task: CommandAPI.Task)
local target = task:getArg(1)
local number = task:getArg(2)
-- ...
end
Note
Bir komutta aynı argümandan iki ya da daha fazlası varsa argümanı indeksle almak şarttır: {"Player", "Number", "Number"}
İlk argüman olarak "Player" kullanıldığında komut, hedeflenen her oyuncu üzerinde ayrı ayrı çalışır. Bu durumda "Player" argümanına task.target ile ulaşabilirsin:
args = {"Player", "Number"},
run = function(task: CommandAPI.Task)
local target = task.target
local number = task:getArg("Number")
-- ...
end
Kalıcılık¶
Bir görev, run bittiği anda yok edilir. ;jump gibi anında biten komutlar için sorun yok, ama etkisinin kalmasını isteyen music gibi komutlar için pek istenen bir şey değil. Bu yüzden canlı kalmasını istediğimiz her komut task:keep üzerinden geçmeli:
task:keep("UntilTargetRespawns")
| Kalıcılık | Görev şu zaman biter |
|---|---|
"UntilTargetRespawns" |
hedef yeniden doğduğunda veya oyundan çıktığında |
"UntilTargetLeaves" |
hedef oyundan çıktığında |
"UntilCallerRespawns" |
komutu çalıştıran kişi yeniden doğduğunda veya oyundan çıktığında |
"UntilCallerLeaves" |
komutu çalıştıran kişi oyundan çıktığında |
"Indefinitely" |
biri ;un ile bitirdiğinde ya da oyuncu oyundan çıktığında |
Tip
Birden fazla 'keep' birleştirebilirsin. Örneğin task:keep("UntilTargetLeaves") ve task:keep("UntilCallerLeaves") birlikte kullanılırsa komut, çağıran ya da hedeften biri sunucudan çıktığında biter.
Buff'lar¶
Humanoid'lerdeki WalkSpeed gibi özellikleri değiştirmek normalde kolaydır. Özelliği istediğin değere ayarlarsın ve iş biter. Birden fazla komut devreye girince işler biraz karmaşıklaşır.
Diyelim canın 100 ve önce ;health me 500 sonra ;god me çalıştırdın. ;health canını önce 500 yapar, sonra ;god onu 99999 yapar. Bu gayet iyi çalışır, ama health görevini tutup god görevini kaldırmak istersen ne olur? Birçok admin sisteminde god geri alınınca canın doğrudan 100 olur ve hâlâ aktif olan health görevi yok sayılır. Bu istenen bir şey değil, buff'lar da tam burada işe yarar:
task:buff(target, "WalkSpeed", function(hasEnded: boolean, original: any)
local humanoid = getHumanoid(target)
local before = if humanoid then humanoid.WalkSpeed else StarterPlayer.CharacterWalkSpeed
if humanoid then
humanoid.WalkSpeed = if hasEnded then original else task:getArg("Number")
end
return before
end)
Bir buff, senin kodun ile ait olduğu gruptan (bu örnekte "WalkSpeed") ibarettir. O gruptaki bir görev her başladığında veya bittiğinde, tüm buff'ları sırayla yeniden çalışır. Böylece özelliğin her zaman son komutun istediği değere oturur.
Ayrıca bir orijinal değer de döndürebilirsin. Bu değer, gruptaki en eski buff tarafından hatırlanan değerdir. Son buff kaldırıldığında özelliğin bu orijinal değere geri ayarlanabilir. Böylece canın, önceki komutun bıraktığı değere değil 100'e döner.
Ağ iletişimi¶
Sunucudan istemci komutlarımıza ulaşmak için task.client kullanırız:
local part = Instance.new("Part")
task.client:expose(target, part)
task.client:run(target, part , "Hello this is a part from the server")
run = function(task: CommandAPI.Task, part, message)
print("part, message =", part, message)
end
Important
Sunucuda yeni oluşturulan ve istemcilerle paylaşmak istediğimiz instance'lar/modeller için task:expose kullanmak şarttır. Aksi halde istemciye ulaşmama ihtimali vardır
İstemcinin de bilgiyi sunucuyla, hatta diğer istemcilerle paylaşmak istediği zamanlar olur. Örneğin ;laserEyes kullanırken diğer istemcilerin lazer ışınlarımızı ve nereye baktığımızı görmesini isteriz. Bunu yapmak için task.server kullanırız:
-- The client's device knows something that others don't
task.server:replicate(targetCFrame, lookCFrame)
-- Your chance to pick who sees it, and to throw out anything dodgy
task.client.replicator = function(replicateTo, targetCFrame, lookCFrame)
if typeof(targetCFrame) ~= "CFrame" or typeof(lookCFrame) ~= "CFrame" then
return
end
for _, player in getTargets("OthersNearby", target, 100) do
replicateTo(player, target, targetCFrame, lookCFrame)
end
end
-- Runs on every client the server chose in the same client module
replication = function(target: Player, targetCFrame: CFrame, lookCFrame: CFrame)
-- Show it happening on their screen
end,
Important
Replicator içindeki değerlerin beklediğin gibi olduğunu kontrol etmen önemli, çünkü istemci her zaman kötü niyetli ya da farklı değerler gönderebilir
Info
replicator göndermediği sürece hiçbir şey başka bir oyuncuya ulaşmaz, yani bir istemci canının istediğini sessizce herkese yayınlayamaz. Replikasyon isteklerinin sayısı da dahili olarak sınırlandırılmıştır ve istemcilerden gelebilecek olası kötüye kullanımlar hesaba katılmıştır
İstemler¶
Komutları çalıştırmak bir şey, ama çalışırken ince ayar yapabilmek daha da güzel. İşte burada task:bindPrompt ile çağırana ayarlayabileceği bir kart verebilirsin:
local function applyLaserColour()
local colour = task:getArg("Color")
-- set the beam colours, eye colours, etc
end
applyLaserColour()
task:bindPrompt({
args = {"Color"},
onChange = applyLaserColour,
})
Tek seferlik eylemler için buttons da ekleyebilirsin:
task:bindPrompt({
title = "Teleport",
text = `Click to teleport to '{placeName}'`,
deactivate = false,
endOnClose = true, -- dismissing the card ends its task
buttons = {
{
label = "Teleport",
onActivate = onActivate,
},
},
})
Kartın kabul ettiği tüm anahtarlar, confirm düğmeleri, ekstra anahtarlar ve Re-run düğmesi dahil, task:bindPrompt altında listelenir. Düz bildirimler ve mesajlar için istem sayfasına bak.
Görevler ve kullanılabilir metotları hakkında daha fazla ayrıntıyı Task API sayfasında öğrenebilirsin.