Odznaki

Odznaka to odznaka specjalna nagroda, którą możesz przyznać graczom, gdy osiągną cel w twojej grze, na przykład ukończąc trudny cel lub grając przez określony czas. Gdy tylko gracz otrzyma odznakę, wyświetla się ona w kategorii Odznaki w jego ekwipunku.

Tworzenie odznak

Możesz stworzyć do 5 odznak za darmo w ciągu 24 godzin (GMT) dla każdej gry, którą posiadasz. Jeśli chcesz stworzyć więcej w ciągu 24 godzin, każda dodatkowa odznaka kosztuje 100 Robux.

Aby stworzyć odznakę:

1. Przejdź do Panelu Twórcy.

2. Najedź na miniaturę gry, kliknij przycisk ⋯ i wybierz Utwórz odznakę.

   

3. Na stronie tworzenia kliknij przycisk Prześlij obraz, a następnie wybierz/potwierdź obraz, który chcesz użyć jako ikonę odznaki. Tworząc obraz do użycia jako odznakę, weź pod uwagę następujące:

   • Użyj szablonu o rozmiarze 512×512 pikseli.

   • Proces przesyłania przycina i przycina obraz odznaki do okrągłej ikony, więc unikaj umieszczania ważnych szczegółów poza okrągłymi granicami.

     

     

4. Uzupełnij następujące pola:

   • Nazwa — Tytuł odznaki.
   • Opis — Opis tego, co gracz może zrobić, aby zdobyć odznakę.
   • Odznaka jest włączona — Czy odznaka będzie włączona, gdy zostanie stworzona. Wyłączone odznaki nie są wyświetlane w sekcji Odznaki na głównej stronie gry i nie mogą być zdobywane przez graczy.

5. Kliknij przycisk Utwórz odznakę. Nowa odznaka wyświetli się w sekcji Zaangażowanie ⟩ Odznaki na Panelu Twórcy. Jeśli nowa odznaka jest włączona, będzie również widoczna w sekcji Odznaki na głównej stronie gry.

   

Zmień kolejność odznak

Gdy odznaka jest po raz pierwszy tworzona, zostaje umieszczona na końcu listy odznak. Możesz zmienić kolejność do 50 odznak jednocześnie, korzystając z interfejsu przeciągania i upuszczania.

Aby zmienić kolejność odznak:

1. Przejdź do związanej gry.

2. W panelu bocznym pod nagłówkiem Zaangażowanie przejdź do strony Odznaki.

3. Wybierz Zmień kolejność, aby przejść na stronę zmiany kolejności.

   

4. Na stronie zmiany kolejności przeciągnij i upuść odznaki w preferowanej kolejności.

   

5. Wybierz Zapisz, aby zapisać tę kolejność. Określona kolejność powinna teraz być widoczna na stronie szczegółów gry.

Skrypt odznak

Typowe przepływy skryptów odznak obejmują przyznawanie odznak, sprawdzanie, czy gracz wcześniej zdobył odznakę w twojej grze oraz uzyskiwanie informacji o odznakach.

Zlokalizuj identyfikatory odznak

Identyfikator odznaki to jej unikalny identyfikator. Będziesz potrzebować tego identyfikatora podczas implementacji takich procesów, jak przyznawanie odznaki graczowi.

1. Na Panelu Twórcy przejdź do sekcji Odznaki związanej z grą pod nagłówkiem Zaangażowanie.

2. Najedź na miniaturę odznaki, kliknij przycisk ⋯ i wybierz Kopiuj identyfikator zasobu z menu kontekstowego.

   

Przyznawanie odznak

Możesz przyznawać odznaki graczom w całej swojej grze, wywołując metodę BadgeService:AwardBadgeAsync() w serwerowym Script. Metoda BadgeService:GetBadgeInfoAsync() zwraca właściwości odznaki, w tym IsEnabled, która potwierdza, czy odznaka może być przyznana graczowi. Możesz włączyć lub wyłączyć odznakę z formularza Konfiguruj odznakę na Panelu Twórcy.

Oto przykład bezpiecznej funkcji przyznawania odznak graczom.

local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
	-- Pobierz informacje o odznace
	local success, badgeInfo = pcall(function()
		return BadgeService:GetBadgeInfoAsync(badgeId)
	end)

	if success then
		-- Potwierdź, że odznaka może być przyznana
		if badgeInfo.IsEnabled then
			-- Przyznaj odznakę
			local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
			if not awarded then
				warn("Błąd podczas przyznawania odznaki:", errorMessage)
			end
		end
	else
		warn("Błąd podczas pobierania informacji o odznace: " .. badgeInfo)
	end
end

Sprawdź zdobyte odznaki

Poniższy skrypt sprawdza, gdy którykolwiek gracz wejdzie do gry, następnie używa metody BadgeService:UserHasBadgeAsync(), aby potwierdzić, czy ten gracz posiada odznakę o pasującym identyfikatorze ustawionym w zmiennej BADGE_ID. Możesz również zweryfikować posiadanie odznak w partiach, korzystając z metody BadgeService:CheckUserBadgesAsync().

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

local BADGE_ID = 00000000  -- Zmień to na swój identyfikator odznaki

local function onPlayerAdded(player)
  -- Sprawdź, czy gracz ma odznakę
	local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, BADGE_ID)

  -- Jeśli wystąpił błąd, wydaj ostrzeżenie i zakończ funkcję
	if not success then
		warn("Błąd podczas sprawdzania, czy gracz ma odznakę")
		return
	end

	if hasBadge then
		-- Obsłuż posiadanie odznaki przez gracza zgodnie z potrzebami
	end
end

-- Podłącz zdarzenia "PlayerAdded" do funkcji "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

Uzyskaj informacje o odznace

Aby uzyskać informacje o odznace, takie jak jej opis lub identyfikator zasobu ikony, wywołaj metodę BadgeService:GetBadgeInfoAsync() z identyfikatorem odznaki. Na przykład:

local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- Zmień to na swój identyfikator odznaki

-- Pobierz informacje o odznace
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)

-- Wyjście informacji
if success then
	print("Odznaka:", result.Name)
	print("Włączona:", result.IsEnabled)
	print("Opis:", result.Description)
	print("Ikona:", "rbxassetid://" .. result.IconImageId)
else
	warn("Błąd podczas pobierania informacji o odznace:", result)
end