Lencana

Sebuah lencana adalah penghargaan khusus yang dapat Anda berikan kepada pemain ketika mereka mencapai tujuan dalam permainan Anda, seperti menyelesaikan tujuan yang sulit atau bermain selama jangka waktu tertentu. Segera setelah seorang pemain menerima lencana, lencana tersebut akan ditampilkan dalam kategori Lencana di inventaris mereka.

Buat lencana

Anda dapat membuat hingga 5 lencana secara gratis dalam periode 24 jam (GMT) untuk setiap permainan yang Anda miliki. Jika Anda ingin membuat lebih banyak dalam periode 24 jam tersebut, setiap lencana tambahan akan dikenakan biaya 100 Robux.

Untuk membuat lencana:

1. Navigasikan ke Dasbor Pembuat.

2. Arahkan kursor ke thumbnail permainan, klik tombol ⋯ dan pilih Buat Lencana.

   

3. Di halaman pembuatan, klik tombol Unggah Gambar dan kemudian pilih/konfirmasi gambar yang ingin Anda gunakan sebagai ikon lencana. Saat membuat gambar untuk digunakan sebagai lencana, pertimbangkan hal-hal berikut:

   • Gunakan template berukuran 512×512 piksel.

   • Proses unggah akan memangkas dan memotong gambar lencana menjadi ikon berbentuk lingkaran, jadi hindari menempatkan detail penting di luar batas lingkaran.

     

     

4. Lengkapi kolom berikut:

   • Nama — Judul untuk lencana.
   • Deskripsi — Deskripsi tentang apa yang dapat dilakukan pemain untuk mendapatkan lencana.
   • Lencana Diaktifkan — Apakah lencana akan diaktifkan saat dibuat. Lencana yang dinonaktifkan tidak ditampilkan di bawah bagian Lencana di halaman utama permainan dan tidak dapat diperoleh oleh pemain.

5. Klik tombol Buat Lencana. Lencana baru akan ditampilkan di bagian Keterlibatan ⟩ Lencana di Dasbor Pembuat. Jika lencana baru diaktifkan, lencana tersebut juga akan ditampilkan di bawah bagian Lencana di halaman utama permainan.

   

Susun ulang lencana

Ketika sebuah lencana pertama kali dibuat, lencana tersebut ditempatkan di akhir daftar lencana. Anda dapat menyusun ulang hingga 50 lencana sekaligus menggunakan antarmuka seret dan lepas.

Untuk menyusun ulang lencana:

1. Navigasikan ke permainan terkait.

2. Di panel samping di bawah header Keterlibatan, navigasikan ke halaman Lencana.

3. Pilih Susun Ulang untuk menuju ke halaman penyusunan ulang.

   

4. Di halaman penyusunan ulang, seret dan lepas lencana ke dalam urutan yang diinginkan.

   

5. Pilih Simpan untuk menyimpan urutan ini. Urutan yang ditentukan sekarang harus muncul di halaman detail permainan.

Skrip lencana

Alur kerja skrip lencana yang umum mencakup memberikan lencana, memeriksa apakah seorang pemain telah mendapatkan lencana dalam permainan Anda, dan mendapatkan informasi lencana.

Temukan ID lencana

ID lencana adalah pengidentifikasi uniknya. Anda akan memerlukan ID ini saat menerapkan alur kerja seperti memberikan lencana kepada seorang pemain.

1. Di Dasbor Pembuat, navigasikan ke bagian Lencana permainan terkait di bawah Keterlibatan.

2. Arahkan kursor ke thumbnail lencana, klik tombol ⋯ dan pilih Salin ID Aset dari menu konteks.

   

Memberikan lencana

Anda dapat memberikan lencana kepada pemain di seluruh permainan Anda dengan memanggil metode BadgeService:AwardBadgeAsync() dalam Script sisi server. BadgeService:GetBadgeInfoAsync() mengembalikan properti dari lencana, termasuk IsEnabled yang mengonfirmasi apakah lencana dapat diberikan kepada seorang pemain. Anda dapat mengaktifkan atau menonaktifkan lencana dari formulir Konfigurasi Lencana di Dasbor Pembuat.

Berikut adalah contoh fungsi aman untuk memberikan lencana kepada pemain.

local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
	-- Ambil informasi lencana
	local success, badgeInfo = pcall(function()
		return BadgeService:GetBadgeInfoAsync(badgeId)
	end)

	if success then
		-- Konfirmasi bahwa lencana dapat diberikan
		if badgeInfo.IsEnabled then
			-- Berikan lencana
			local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
			if not awarded then
				warn("Kesalahan saat memberikan lencana:", errorMessage)
			end
		end
	else
		warn("Kesalahan saat mengambil informasi lencana: " .. badgeInfo)
	end
end

Periksa lencana yang diperoleh

Skrip berikut memeriksa ketika pemain mana pun memasuki permainan, kemudian menggunakan metode BadgeService:UserHasBadgeAsync() untuk memverifikasi apakah pemain tersebut memiliki lencana dengan ID yang cocok yang ditetapkan dalam variabel BADGE_ID. Anda juga dapat memverifikasi kepemilikan lencana dalam kelompok menggunakan metode BadgeService:GetUserBadgesAsync().

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

local BADGE_ID = 00000000  -- Ganti ini dengan ID lencana Anda

local function onPlayerAdded(player)
  -- Periksa apakah pemain memiliki lencana
	local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, BADGE_ID)

  -- Jika ada kesalahan, keluarkan peringatan dan keluar dari fungsi
	if not success then
		warn("Kesalahan saat memeriksa apakah pemain memiliki lencana")
		return
	end

	if hasBadge then
		-- Tangani kepemilikan lencana pemain sesuai kebutuhan
	end
end

-- Hubungkan acara "PlayerAdded" ke fungsi "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

Dapatkan informasi lencana

Untuk mendapatkan informasi tentang lencana, seperti deskripsi atau ID aset ikonnya, panggil metode BadgeService:GetBadgeInfoAsync() dengan ID lencana. Sebagai contoh:

local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- Ganti ini dengan ID lencana Anda

-- Ambil informasi lencana
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)

-- Keluarkan informasi
if success then
	print("Lencana:", result.Name)
	print("Diaktifkan:", result.IsEnabled)
	print("Deskripsi:", result.Description)
	print("Ikon:", "rbxassetid://" .. result.IconImageId)
else
	warn("Kesalahan saat mengambil informasi lencana:", result)
end