# Rozwiązywanie problemów

> Najczęstsze przyczyny to błędny Riot ID lub serwer (404), przekroczony limit zapytań (429) oraz wygasły klucz Riot API po stronie serwera (401/403). Każdy komunikat ma proste rozwiązanie.

## Komunikaty błędów i co z nimi zrobić

| Komunikat | Przyczyna | Rozwiązanie |
| --- | --- | --- |
| Nie znaleziono gracza o takim Riot ID w wybranym regionie. | Literówka w Riot ID lub zły serwer. | Sprawdź nazwę, tag i [serwer](https://lolbanner.vxh.pl/docs/serwery-i-riot-id). |
| Podaj poprawny Riot ID i obsługiwany region. | Brak tagu lub nieobsługiwany serwer. | Wpisz Riot ID w formacie Nazwa#TAG i wybierz serwer z listy. |
| Za dużo zapytań. Spróbuj ponownie za minutę. | Limit 60 zapytań na minutę z jednego adresu IP. | Odczekaj minutę. Nie odświeżaj widżetu ręcznie w pętli. |
| Limit Riot API został chwilowo wyczerpany. | Wiele osób odpytuje serwer jednocześnie. | Poczekaj kilka minut – widżet spróbuje ponownie sam. |
| Klucz Riot API jest nieprawidłowy lub wygasł. | Problem po stronie konfiguracji serwera (wygasły klucz). | Jeśli hostujesz własną instancję, ustaw nowy `RIOT_API_KEY`. |
| Serwer nie ma skonfigurowanego klucza RIOT_API_KEY. | Brak zmiennej środowiskowej na serwerze. | Dodaj `RIOT_API_KEY` w konfiguracji aplikacji i uruchom ją ponownie. |

## Problemy po stronie OBS

- **Biały lub czarny prostokąt** – sprawdź, czy w polu URL jest pełny link, a „Plik lokalny” jest odznaczony.
- **Obcięty baner** – wymiary źródła są mniejsze niż w oknie eksportu.
- **Rozmyty tekst** – źródło zostało rozciągnięte myszą. Przywróć wymiary i użyj opcji skali w Studio.
- **Stare dane** – kliknij „Odśwież pamięć podręczną bieżącej strony” we właściwościach źródła.
- **Nie zmienia się wygląd** – po zmianach w Studio wygeneruj nowy link.

## Ranga się nie zgadza

Dane pochodzą z Riot API i są buforowane do ok. 90 sekund, a widżet odświeża się co 2 minuty. Po meczu może minąć chwila, zanim Riot zaktualizuje LP. Jeśli konto nie ma rangi w wybranej kolejce, zmień kolejkę w ustawieniach.

## Najczęstsze pytania

### Dlaczego baner pokazuje „Nie znaleziono gracza”?

Najczęściej Riot ID zawiera literówkę lub wybrano zły serwer. Sprawdź nazwę, tag i region.

### Co oznacza komunikat o zbyt dużej liczbie zapytań?

Z jednego adresu IP można wysłać 60 zapytań na minutę. Odczekaj minutę i spróbuj ponownie.

### Dlaczego LP nie zmieniło się po meczu?

Dane są buforowane do ok. 90 sekund, widżet odświeża się co 2 minuty, a Riot może aktualizować LP z krótkim opóźnieniem.

Źródło: https://lolbanner.vxh.pl/docs/rozwiazywanie-problemow · Zaktualizowano: 2026-10-05