Ana içeriğe geç

Ö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:

görsel

--!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ı:

görsel

--!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

görsel

--!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:

görsel

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: görsel

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.