Lencana | Dokumentasi - Pusat Kreator Roblox

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

Membuat lencana

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

Untuk membuat lencana:

Navigasi ke Dasbor Pembuat.
Arahkan mouse ke thumbnail game, klik tombol ⋯, dan pilih Buat Lencana.
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 memotong dan memangkas gambar lencana menjadi ikon berbentuk lingkaran, jadi hindari menempatkan detail penting di luar batasan lingkaran tersebut.
  
  Konten utama terikut
  Konten teks terpotong
Lengkapi kolom-kolom berikut:
- Nama — Sebuah judul untuk lencana.
- Deskripsi — Sebuah deskripsi tentang apa yang bisa 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 game dan tidak dapat diperoleh oleh pemain.
Klik tombol Buat Lencana. Lencana baru akan ditampilkan dalam bagian Keterlibatan ⟩ Lencana di Dasbor Pembuat. Jika lencana baru diaktifkan, ia juga akan ditampilkan di bawah bagian Lencana di halaman utama game.

Lencana di halaman utama game

Mengurutkan lencana

Ketika lencana pertama kali dibuat, ia ditempatkan di akhir daftar lencana. Anda dapat mengurutkan hingga 50 lencana sekaligus menggunakan antarmuka drag-and-drop.

Untuk mengurutkan lencana:

Navigasi ke game yang terkait.
Di panel samping di bawah header Keterlibatan, navigasi ke halaman Lencana.
Pilih Urutkan untuk menavigasi ke halaman pengurutan.
Di halaman pengurutan, seret dan lepas lencana ke dalam urutan yang diinginkan.
Pilih Simpan untuk menyimpan urutan ini. Urutan yang ditentukan sekarang harus muncul di halaman detail game.

Skrip lencana

Alur kerja skrip lencana yang umum termasuk memberikan lencana, memeriksa apakah pemain sebelumnya telah mendapatkan lencana di game Anda, dan mengambil informasi lencana.

Temukan ID lencana

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

Di Dasbor Pembuat, navigasi ke bagian Lencana game yang terkait di bawah Keterlibatan.
Arahkan mouse ke thumbnail lencana, klik tombol ⋯, dan pilih Salin ID Aset dari menu konteks.

Memberikan lencana

Anda dapat memberikan lencana kepada pemain sepanjang game 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 pemain atau tidak. Anda dapat mengaktifkan atau menonaktifkan lencana dari formulir Konfigurasikan Lencana di Dasbor Pembuat.

Berikut adalah contoh fungsi aman untuk memberikan lencana kepada pemain.


local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
	-- Dapatkan 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 masuk ke game, 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 batch menggunakan metode BadgeService:CheckUserBadgesAsync().


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, berikan 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 peristiwa "PlayerAdded" ke fungsi "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

Ambil info lencana

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


local BadgeService = game:GetService("BadgeService")

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

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