Rozetler

Bir rozet, oyunculara oyununuzda zor bir hedefi tamamlamak veya belirli bir süre oynamak gibi bir hedefe ulaştıklarında verebileceğiniz özel bir ödüldür. Bir oyuncu bir rozet aldığında, bu rozet Rozetler kategorisinde envanterinde görüntülenir.

Rozet oluşturma

Her sahip olduğunuz oyun için 24 saat içinde (GMT) ücretsiz olarak en fazla 5 rozet oluşturabilirsiniz. Eğer 24 saat içinde daha fazla rozet oluşturmak istiyorsanız, her ek rozet 100 Robux'tur.

Bir rozet oluşturmak için:

1. Yaratıcı Kontrol Paneli'ne gidin.

2. Bir oyunun küçük resminin üzerine gelin, ⋯ butonuna tıklayın ve Roze Oluştur seçeneğini seçin.

   

3. Oluşturma sayfasında, Görüntü Yükle butonuna tıklayın ve ardından kullanmak istediğiniz rozet simgesi olarak görüntüyü seçin/onaylayın. Bir rozet için kullanılacak bir görüntü oluştururken aşağıdakilere dikkat edin:

   • 512×512 piksel bir şablon kullanın.

   • Yükleme işlemi rozet görüntüsünü dairesel bir simge olarak kesin ve kırpar, bu yüzden önemli detayları dairesel sınırların dışına koymaktan kaçının.

     

     

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

   • Ad — Rozet için bir başlık.
   • Açıklama — Oyuncunun rozeti kazanmak için ne yapması gerektiği hakkında bir açıklama.
   • Roze Etkin — Rozetin oluşturulduğunda etkin olup olmayacağı. Devre dışı bırakılmış rozetler oyunun ana sayfasının Rozetler bölümünde gösterilmez ve oyuncular tarafından kazanılamaz.

5. Roze Oluştur butonuna tıklayın. Yeni rozet, Yaratıcı Kontrol Paneli'nde İlgili ⟩ Rozetler bölümünde görüntülenecektir. Yeni rozet etkinse, oyunun ana sayfasının Rozetler bölümünde de gösterilecektir.

   

Rozetleri yeniden sıralama

Bir rozet ilk oluşturulduğunda, rozet listesine en son eklenir. Tek seferde 50 rozet yeniden sıralamak için sürükleyip bırakma arayüzünü kullanabilirsiniz.

Rozetleri yeniden sıralamak için:

1. İlgili oyuna gidin.

2. İlgili başlığının altındaki yan panelde Rozetler sayfasına gidin.

3. Yeniden sıralama sayfasına gitmek için Yeniden Sırala seçeneğini seçin.

   

4. Yeniden sıralama sayfasında, rozetleri tercih ettiğiniz sıraya sürükleyip bırakın.

   

5. Bu sıralamayı kaydetmek için Kaydet seçeneğini seçin. Belirlenen sıralama artık oyun detayları sayfasında görünmelidir.

Rozetleri Script ile Yönetme

Yaygın rozet scripting iş akışları arasında rozet verme, bir oyuncunun daha önce kazanıp kazanmadığını kontrol etme ve rozet bilgilerini alma yer alır.

Rozet ID'lerini Bulma

Bir rozetin ID'si, onun benzersiz tanımlayıcısıdır. Bu ID'yi, bir oyuncuya rozet verme gibi iş akışlarını uygularken kullanmanız gerekecek.

1. Yaratıcı Kontrol Paneli'nde, ilgili oyunun Rozetler bölümüne gidin.

2. Bir rozetin küçük resminin üzerine gelin, ⋯ butonuna tıklayın ve bağlam menüsünden Varlık ID'sini Kopyala seçeneğini seçin.

   

Rozet Verme

Oyunculara oyununuzda rozetler verebilirsiniz, sunucu tarafında bir Script içinde BadgeService:AwardBadgeAsync() metodunu çağırarak. BadgeService:GetBadgeInfoAsync() rozetin özelliklerini döndürür, bunlar arasında IsEnabled de vardır ve rozetin oyuncuya verilip verilemeyeceğini doğrular. Bir rozeti Yaratıcı Kontrol Paneli'ndeki Roze Yapılandır formundan etkin veya devre dışı bırakabilirsiniz.

Aşağıda oyunculara rozet vermek için güvenli bir fonksiyon örneği verilmiştir.

local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
	-- Rozet bilgilerini al
	local success, badgeInfo = pcall(function()
		return BadgeService:GetBadgeInfoAsync(badgeId)
	end)

	if success then
		-- Rozetin verilebileceğini doğrula
		if badgeInfo.IsEnabled then
			-- Rozet ver
			local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
			if not awarded then
				warn("Rozet verilirken hata:", errorMessage)
			end
		end
	else
		warn("Rozet bilgileri alınırken hata: " .. badgeInfo)
	end
end

Kazanılmış Rozetleri Kontrol Etme

Aşağıdaki script, herhangi bir oyuncu oyuna girdiğinde kontrol eder, ardından BadgeService:UserHasBadgeAsync() metodunu kullanarak o oyuncunun eşleşen ID ile set edilen rozetin sahibi olup olmadığını doğrular. Ayrıca, rozet sahipliğini topluca doğrulamak için BadgeService:CheckUserBadgesAsync() metodunu da kullanabilirsiniz.

local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")

local BADGE_ID = 00000000  -- Bunu rozet ID'niz ile değiştirin

local function onPlayerAdded(player)
  -- Oyuncunun rozeti olup olmadığını kontrol et
	local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, BADGE_ID)

  -- Hata varsa, uyarı ver ve fonksiyondan çık
	if not success then
		warn("Oyuncunun rozeti var mı kontrol edilirken hata")
		return
	end

	if hasBadge then
		-- Oyuncunun rozet sahipliğini gerektiği gibi yönetin
	end
end

-- "PlayerAdded" olaylarını "onPlayerAdded()" fonksiyonuna bağlayın
Players.PlayerAdded:Connect(onPlayerAdded)

Rozet Bilgilerini Alma

Bir rozetle ilgili bilgileri almak için, açıklaması veya simge varlık ID'si gibi, bir rozet ID'si ile BadgeService:GetBadgeInfoAsync() metodunu çağırın. Örneğin:

local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- Bunu rozet ID'niz ile değiştirin

-- Rozet bilgilerini al
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)

-- Bilgiyi çıktıya ver
if success then
	print("Roze:", result.Name)
	print("Etkin:", result.IsEnabled)
	print("Açıklama:", result.Description)
	print("Simge:", "rbxassetid://" .. result.IconImageId)
else
	warn("Rozet bilgileri alınırken hata:", result)
end