Studio eklentileri

Bir eklenti, Studio'ya ek özellikler veya işlevsellik ekleyen bir uzantıdır. Topluluk tarafından yapılmış eklentileri yükleyebilir veya kendi eklentilerinizi oluşturabilir ve yayınlayabilirsiniz ve bunları oyunlarınızda kullanmak için Araç Kutusu içine ekleyebilirsiniz.

Eklentilerinizi Creator Store'da dağıtmayı da seçerseniz, bunları ücretsiz sunabilir veya Amerikan Doları karşılığında satabilirsiniz. Roblox, bu satışlar için yalnızca vergiler ve ödeme işleme ücretleri düşüldüğünden, sektördeki en iyi gelir paylaşımını sunmaktadır. Eklenti satışı hakkında daha fazla bilgi için Creator Store - Varlıkları dağıtma ve satma bölümüne 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'ın çocuğu olarak veya ServerScriptService içinde boş bir Script ekleyen AddEmptyScript adlı bir eklentidir. Aşağıdaki bölümler, bu eklentiyi oluşturmanın ana parçalarını açıklar.

Başlamak için, Studio ayarlarının 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 sağlayan PluginDebugService'i Studio'da açar ve eklentinizi yeniden yüklemeyi ve kaydetmeyi kolaylaştırır.

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

-- "Özel" başlıklı yeni bir araç çubuğu bölümü ve Eklentiler menüsü klasörü 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")

-- 3D görünüm gizli olsa bile düğmeyi tıklanabilir yap
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 scriptini kaydet

Bir eklenti oluşturmak için önce bir Script oluşturun ve bunu yerel olarak kaydedin.

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

   

2. Yukarıdaki AddEmptyScript Eklentisi kodunu yeni scriptin içine 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 scriptini Studio kurulumunun yerel Eklentiler klasörüne eklemek için Kaydet butonuna tıklayın.

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

6. ÖNEMLİ

   ServerStorage içindeki orijinal scripti silin ve PluginDebugService içindeki AddEmptyScript eklentisi üzerinden çalışın, aksi takdirde değişiklikleri yanlış scriptte uygulama riskiyle karşı karşıya kalabilirsiniz.

   

Araç çubuğu düğmesi ekle

Eklentiniz için Studio araç çubuğunun 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 yeni bir bölüm ve Eklentiler menüsü klasörü oluştururken, 8. satır Boş Script etiketli bir düğme oluşturur.

Tıklama ile 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 fonksiyon bağlayın. AddEmptyScript kodunda, bağlanan fonksiyon onPluginButtonClicked()'dir.

Kullanıcı seçimini kontrol et

Kullanıcının seçimine bağlı olarak bir eklentinin davranışını değiştirmek için Selection hizmetini kullanın. onPluginButtonClicked() fonksiyonu, kullanıcının herhangi bir şey seçip seçmediğini kontrol eder ve yeni scripti ServerScriptService içinde değil, onun çocuğu olarak oluşturur. Kullanıcı herhangi bir şey seçmemişse, yeni scripti ServerScriptService içinde oluşturur.

Geri alma ve yineleme desteği

Kullanıcıların bir oyundaki eklenti tarafından yapılan değişiklikleri geri almasına ve yinelemesine izin vermek için ChangeHistoryService'i kullanın. Scriptinizde, eklentinin ChangeHistoryService:TryBeginRecording() çağrısını yapmasını ve değişiklikler yapmadan önce API çağrısına atanan tanımlayıcıyı saklamasını sağlayın. Ardından, değişiklikler yapıldıktan sonra ChangeHistoryService:FinishRecording() çağrısını yaparak, kayıt oturumu sırasında yapılan değişiklikleri geri alma ve yineleme için yakalayın.

Aşağıdaki kod örneği, seçilen parçalara neon malzemesi uygulayabilen bir örnek eklenti oluşturur. Eklentinin yaptığı değişiklikleri kaydetmek ve yönetmek için ChangeHistoryService'i kullanır:

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 fonksiyon bağla
button.Click:Connect(function()
	-- Belirli bir tanımlayıcı ile bir kaydı başlatmayı dene
	local recording = ChangeHistoryService:TryBeginRecording("Seçimi neon yap")

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

	-- Seçilen örnekler arasında döngü yap
	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 malzemesini Neon olarak ayarla
		end
	end

	-- Kaydı tamamla, değişiklikleri geçmişe kaydet
	ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit)
end)

Eklentileri yükle

Bir eklentiyi oluşturmayı bitirdikten sonra, onu envanterinize yükleyebilir ve tüm projelerinizde erişilebilir hale getirebilirsiniz.

Bir eklentiyi yüklemek için:

1. Explorer penceresinde bir eklenti scriptini 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öşesinde, eklentiniz için 512×512 boyutunda bir resim küçük resmi yüklemek üzere varsayılan bulmaca parçası resmine tıklayın.

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

   • Ad — Eklentiniz için bir başlık.
   • Açıklama — Potansiyel bir kullanıcının eklentinin ne yapmasını bekleyebileceğini 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 sekmelerinde sizin için mevcut.

Eklentileri dağıtma ve satma

Kendi eklentilerinizi Creator Store'da başkalarının kendi oyun geliştirmelerinde kullanması için kamuya açık olarak dağıtabilir ve satabilirsiniz. Bu para kazanma yöntemi, platform ücretlerini ve DevEx oranlarını atlayarak işlemlerden elde edilen net gelirlerin %100'ünü kazanmanızı sağlar. Bu süreç hakkında daha fazla bilgi için, fiyatları ayarlamak ve ödemeleri almak için bir satıcı hesabı nasıl kuracağınızı da içeren Creator Store - Varlıkları dağıtma ve satma bölümüne bakın.