Lencana

Lencana buruk adalah penghargaan khusus yang dapat Anda berikan kepada pemain ketika mereka memenuhi tujuan dalam pengalaman Anda, seperti menyelesaikan tujuan sulit atau bermain selama jangka waktu tertentu.Saat seorang pemain menerima lencana, itu ditampilkan dalam kategori Lencana dari inventaris mereka.

Buat lencana

Anda dapat membuat hingga 5 lencana gratis dalam periode 24 jam (GMT) untuk setiap pengalaman yang Anda memiliki.Jika Anda ingin membuat lebih banyak dalam periode 24 jam, setiap lencana tambahan harganya 100 Robux.

Untuk membuat lencana:

1. Navigasikan ke Dashboard Pencipta.

2. Pasang mouse di atas thumbnail pengalaman, klik tombol ⋯ dan pilih Buat Lencana .

   

3. Di halaman buat, klik tombol Upload Gambar dan kemudian pilih/konfirmasi gambar yang ingin Anda gunakan sebagai ikon badge.Saat membuat gambar untuk digunakan untuk lencana, pertimbangkan hal mengikuti:

   • Gunakan template dari 512×512 piksel .

   • Proses upload memotong dan memotong gambar lencana menjadi ikon bulat, jadi hindari menempatkan detail penting di luar batas bulat.

     

     

4. Selesaikan bidang berikut:

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

5. Klik tombol Buat Lencana .Lencana baru ditampilkan dalam bagian Keterlibatan ⟩ Lencana pada Dashboard Pencipta.Jika lencana baru diaktifkan, itu juga akan ditampilkan di bawah bagian Lencana dari halaman utama pengalaman.

   

Ulangi lencana buruk

Ketika lencana pertama dibuat, lencana itu ditempatkan di akhir daftar lencana. Anda dapat mengatur ulang hingga 50 lencana sekaligus menggunakan antarmuka seret dan lepaskan.

Untuk mengatur ulang lencana:

1. Navigasikan ke pengalaman terkait.

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

3. Pilih Ulangi Urutan untuk menavigasi ke halaman reordering.

   

4. Di halaman pengatur ulang, seret dan lepaskan lencana ke dalam urutan yang diinginkan.

   

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

Lencana skrip

Alur kerja penulisan lencana umum termasuk memberikan lencana , memeriksa apakah pemain sebelumnya mendapatkan lencana dalam pengalaman Anda, dan mendapatkan informasi lencana .

Temukan ID lencana

ID lencana adalah identifikator uniknya. Anda akan membutuhkan ID ini saat menerapkan alur kerja seperti memberikan lencana kepada pemain.

1. Di Dashboard Pencipta, navigasikan ke bagian Lencana dari pengalaman terkait di bawah Keterlibatan .

2. Pasang mouse di atas thumbnail lencana, klik tombol ⋯ dan pilih Copy Asset ID dari menu konteks.

   

Tanda penghargaan

Anda dapat memberikan lencana kepada pemain selama pengalaman Anda dengan memanggil metode BadgeService:AwardBadge() di sisi server Script. BadgeService:GetBadgeInfoAsync() kembali mengembalikan properti lencana, termasuk IsEnabled yang menyatakan apakah lencana dapat diberikan kepada pemain atau tidak.Anda dapat mengaktifkan atau menonaktifkan lencana dari form Konfigurasi Lencana pada Dashboard Pencipta.

Berikut adalah contoh fungsi aman untuk memberikan lencana kepada pemain.

local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
  -- Ambil informasi lencana buruk
  local success, badgeInfo = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, badgeId)
  if success then
    -- Konfirmasikan bahwa lencana dapat diberikan
    if badgeInfo.IsEnabled then
      -- lencanapenghargaan
      local awarded, errorMessage = pcall(BadgeService.AwardBadge, BadgeService, player.UserId, badgeId)
      if not awarded then
        warn("Error while awarding badge:", errorMessage)
      end
    end
  else
 	  warn("Error while fetching badge info!")
  end
end

Periksa lencana yang diperoleh

Skrip berikut memeriksa ketika pemain mana pun memasuki pengalaman, kemudian menggunakan metode untuk memverifikasi apakah pemain itu memiliki lencana dengan ID yang cocok dengan variabel .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  -- Ubah ini menjadi 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("Error while checking if player has badge")
		return
	end

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

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

Dapatkan informasi lencana

Untuk mendapatkan informasi tentang lencana, seperti deskripsinya atau ID aset ikon, panggil metode dengan ID lencana . Misalnya:

local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- Ubah ini menjadi ID lencana Anda

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

-- Keluarkan informasi
if success then
	print("Badge:", result.Name)
	print("Enabled:", result.IsEnabled)
	print("Description:", result.Description)
	print("Icon:", "rbxassetid://" .. result.IconImageId)
else
	warn("Error while fetching badge info:", result)
end