Studio eklentileri

Bir eklenti, Studio'ya ek özellikler veya işlevsellik ekleyen bir uzantıdır. Eklenti mağazasından topluluk tarafından yapılmış eklentileri kurabilir veya yayınlayabilir ve bunları deneyimlerinizi oluştururken kullanmak üzere Araç Kutusu'na gönderebilirsiniz.

Eklentilerinizi Eklenti Mağazasında dağıtmaya karar verirseniz, bunları ücretsiz olarak sunabilirsiniz veya Amerikan Doları karşılığında satabilirsiniz. Roblox, bu satışlar için yalnızca vergi ve ödeme işleme ücretlerinin kesildiği, sektörde lider bir gelir payı sunmaktadır. Eklenti satışı ile ilgili daha fazla bilgi için Eklenti Mağazası - Varlıkları dağıtma ve satma sayfasına bakın.

Yeni eklentiler oluşturun

Kendi eklentilerinizi oluşturarak Studio'daki iş akışınızı geliştirebilirsiniz. Aşağıdaki kod örneği, bir Instance'in çocuğu veya ServerScriptService içerisinde boş bir Script ekleyen AddEmptyScript adlı bir eklentidir. Aşağıdaki bölümler, bu eklentiyi oluşturmanın temel parçalarını açıklar.

Başlamak için, Studio'nun ayarları altındaki Studio bölümünde Eklenti Hata Ayıklama Etkin seçeneğini etkinleştirmelisiniz. Bu, eklentinizin kodu için gerçek zamanlı hata ayıklama sunan PluginDebugService'i Studio'da açar ve eklentinizi yeniden yüklemeyi ve kaydetmeyi kolaylaştırır.

AddEmptyScript Eklentisi
local ServerScriptService = game:GetService("ServerScriptService")
local Selection = game:GetService("Selection")

-- "Özel" adında yeni bir araç çubuğu bölümü ve Eklentiler menüsü oluştur
local toolbar = plugin:CreateToolbar("Özel")

-- "Boş Script" etiketli bir araç çubuğu düğmesi ekle
local newScriptButton = toolbar:CreateButton("Boş Script", "Boş bir script oluştur", "rbxassetid://14978048121")

-- Düğmeyi tıklanabilir yapmak için 3D görünüm gizli olduğunda etkinleştir
newScriptButton.ClickableWhenViewportHidden = true

local function onPluginButtonClicked()
	local selectedObjects = Selection:Get()
	local parent = selectedObjects[1] or ServerScriptService
	local newScript = Instance.new("Script")
	newScript.Source = ""
	newScript.Parent = parent
end

newScriptButton.Click:Connect(onPluginButtonClicked)

Eklenti script'ini kaydedin

Bir eklenti oluşturmak için önce bir Script oluşturmalı ve bunu yerel olarak kaydetmelisiniz.

1. ServerStorage içinde yeni bir Script ekleyin ve adını AddEmptyScript olarak değiştirin.

   

2. Yukarıdaki AddEmptyScript Eklentisi kodunu yeni script'e kopyalayın ve yapıştırın.

3. Yeni script Explorer penceresinde seçili iken, Studio'nun Eklentiler menüsünden Yerel Eklenti Olarak Kaydet seçeneğini seçin.

4. Açılan pencerede, eklenti script'ini Studio kurulumunun yerel Eklentiler klasörüne eklemek için Kaydet'e tıklayın.

5. Eklenti, PluginDebugService içerisinde görünmeli ve çalışmaya başlamalıdır.

6. ÖNEMLİ

   ServerStorage içindeki orijinal script'i silin ve PluginDebugService içindeki AddEmptyScript eklentisi üzerinden çalışın, aksi takdirde değişikliklerinizi yanlış script'e uygulama durumuyla karşılaşabilirsiniz.

   

Araç çubuğu düğmesi ekleyin

Eklentiniz için Studio araç çubuğundaki Eklentiler sekmesine bir düğme eklemek için Plugin:CreateToolbar() ve PluginToolbar:CreateButton() yöntemlerini kullanın. AddEmptyScript kodunda, 5. satır araç çubuğunda ve Eklentiler menüsü klasöründe Özel başlıklı yeni bir bölüm oluşturmaktadır, 8. satır ise Boş Script etiketli bir düğme oluşturmaktadır.

Tıklamada kodu çalıştır

Eklentinin, kullanıcı araç çubuğu düğmesine tıkladığında kodu çalıştırmasını sağlamak için düğmenin PluginToolbarButton.Click olayına bir işlev bağlayın. AddEmptyScript kodunda bağlama işlevi onPluginButtonClicked()'dir.

Kullanıcı seçimini kontrol et

Bir eklentinin davranışını kullanıcının ne seçtiğine dayalı olarak değiştirmek için Selection hizmetini kullanın. onPluginButtonClicked() işlevi kullanıcının bir şey seçip seçmediğini kontrol eder ve yeni script'i ServerScriptService içine değil, onun çocuğu olarak yaratır. Kullanıcı hiçbir şey seçmemişse, yeni script ServerScriptService içinde oluşturulur.

Geri alma ve yineleme desteği

Kullanıcıların bir eklenti aracılığıyla yapılan değişiklikleri geri almasına ve yinelemesine izin vermek için ChangeHistoryService kullanın. Script'inizde, eklentiyi TryBeginRecording() çağrısını yapacak şekilde ayarlayın ve değişiklik yapmadan önce API çağrısına atanan tanımlayıcıyı saklayın. Daha sonra değişiklik yaptıktan sonra, geri alma ve yineleme için kayıt oturumu sırasında yapılan değişiklikleri yakalamak üzere FinishRecording()'yi çağırması için eklentiyi ayarlayın.

Aşağıdaki kod örneği, seçilen parçalara neon materyali uygulayabilen bir örnek eklenti oluşturmaktadır. Bu, eklenti tarafından yapılan değişiklikleri kaydetmek ve yönetmek için ChangeHistoryService'i kullanır:

Geri Alma ve Yineleme için Kayıtlarla Örnek Materyal Eklentisi
local ChangeHistoryService = game:GetService("ChangeHistoryService")
local Selection = game:GetService("Selection")

-- Bir örnek eklenti oluştur
local toolbar = plugin:CreateToolbar("Örnek Eklenti")
local button = toolbar:CreateButton("Neon yap", "", "")

-- Tıklama olayına bir işlev bağlantısı kur
button.Click:Connect(function()
	-- Belirli bir tanımlayıcı ile bir kayıt başlatmaya çalış
	local recording = ChangeHistoryService:TryBeginRecording("Seçimi neon yap")

	-- Kaydın başarıyla başlatıldığını kontrol et
	if not recording then
		-- Bu, eklentinizin önceki bir kaydı başlattığını ve tamamlamadığını gösterir
		-- Her eklenti için aynı anda yalnızca bir kayıt aktif olabilir
		return
	end

	-- Seçilen örnekleri geçmek
	for _, instance in Selection:Get() do
		-- Örneğin bir BasePart olup olmadığını kontrol et
		if instance:IsA("BasePart") then
			instance.Material = Enum.Material.Neon -- Parçanın materyalini Neon olarak ayarla
		end
	end

	-- Kaydı tamamla ve değişiklikleri tarihe kaydet
	ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit)
end)

Eklentileri yükleyin

Bir eklenti oluşturmayı tamamladıktan sonra, onu envanterinize yükleyebilir ve böylece tüm projelerinizde erişilebilir hale getirebilirsiniz.

Bir eklenti yüklemek için:

1. Explorer penceresinde bir eklenti script'ini seçin.

2. Studio'nun Eklentiler menüsüne gidin, ardından Eklenti Olarak Yayınla seçeneğini seçin.

3. İSTEĞE BAĞLI

   Varlık yapılandırma penceresinin sol üst köşesindeki varsayılan yapboz parçası simgesine tıklayın ve eklentiniz için 512×512 boyutunda bir görüntü küçük resmi yükleyin.

4. Aşağıdaki alanları doldurun:

   • İsim — Eklentiniz için bir başlık.
   • Açıklama — Potansiyel bir kullanıcının eklentiden bekleyebileceği durumu açıklayan bir açıklama.
   • Yaratıcı — Eklentinin yaratıcısı olarak atamak istediğiniz kişi veya grup.

5. Gönder butonuna tıklayın. Eklentiniz artık Araç Kutusu altında Envanter ve Yaratımlar sekmeleri içinde sizin için erişilebilir hale gelmiştir.

Eklentileri dağıtma ve satma

Kendi eklentilerinizi Eklenti Mağazasında başkalarının kendi oyun geliştirme süreçlerinde kullanabilmesi için halka açık olarak dağıtabilir ve satabilirsiniz. Bu gelir modeli, platform ücretlerini ve DevEx oranlarını atlayarak, işlemlerde elde edilen net gelirin %100'ünü kazanmanızı sağlar. Bu süreç hakkında daha fazla bilgi için, fiyatları belirlemek ve ödemeleri almak için bir satıcı hesabı nasıl kuracağınızı da içeren Eklenti Mağazası - Gereksinimler sayfasına bakın.