# Szczegóły dotyczące Faceit

Wtyczka do CS2, która wyświetla rzeczywiste poziomy w Faceit wraz z ikonami w tabeli wyników, prefiksem na czacie, tagiem klanu oraz menu.

## Funkcje

- **Ikony na tablicy wyników** – wyświetla niestandardowe odznaki poziomów Faceit na tablicy wyników (wymaga dodatku z Workshopu oraz MultiAddonManager)
- **`!faceit` Menu** – wyświetla listę wszystkich graczy online wraz z ich poziomami Faceit za pośrednictwem programu MenuManager
- **Prefiks czatu** – dodawany `[6] PlayerName`przed każdą wiadomością na czacie (format można dostosować)
- **Znak klanu** – `[6]`wyświetla się na tablicy wyników obok nazwy gracza
- **Automatyczne odświeżanie** — okresowe pobieranie danych z interfejsu API Faceit
- **Ograniczenie liczby żądań** – maksymalnie 3 równoczesne żądania API

## Wymagania

- [CounterStrikeSharp](https://github.com/roflmuffin/CounterStrikeSharp/releases) z CS2
- [MenuManager](https://github.com/NickFox/nf-core-MenuManager) (dla menu`!faceit`)
- [MultiAddonManager](https://github.com/Source2ZE/MultiAddonManager) + [dodatek Faceit Workshop](https://steamcommunity.com/sharedfiles/filedetails/?id=3724637448) (do ikon na tablicy wyników)
- [Klucz API Faceit](https://developers.faceit.com/) – klucz API serwera

## Instalacja

1. Skopiuj do`FaceitDetails.dll` `addons/counterstrikesharp/plugins/`
2. Upewnij się, że program `MenuManager`jest również zainstalowany
3. Uruchom ponownie serwer lub wykonaj `css_plugins load FaceitDetails`
4. Konfiguracja jest generowana automatycznie w pliku `configs/plugins/FaceitDetails/FaceitDetails.json`
5. Wprowadź swój klucz API Faceit i odśwież stronę

### Konfiguracja ikon na tablicy wyników

Aby wyświetlać ikony poziomów Faceit w tabeli wyników, dodaj następujący wpis do pliku`game/csgo/cfg/multiaddonmanager/multiaddonmanager.cfg`:

```
mm_extra_addons "3724637448"
```

## Konfiguracja

```json
{
"FaceitApiKey": "your-api-key-here",
"PrefixEnabled": true,
"PrefixFormat": "[{LEVEL}]",
"ClanTagEnabled": true,
"ScoreboardIcons": true,
"RefreshMinutes": 5,
"ConfigVersion": 8
}
```

| Opcja | Domyślnie | Opis |
|--------|---------|-------------|
| `FaceitApiKey` | `""` | Twój klucz API serwera Faceit |
| `PrefixEnabled` | `true` | Dodaj `[LVL]`przed nazwą gracza na czacie |
| `PrefixFormat` | `"[{LEVEL}]"` | Format przedrostka na czacie. `{LEVEL}`= Poziom Faceit |
| `ClanTagEnabled` | `true` | Pokaż poziom Faceit jako tag klanu w tabeli wyników |
| `ScoreboardIcons` | `true` | Pokaż ikonę/przypinkę poziomu Faceit w tabeli wyników |
| `RefreshMinutes` | `5` | Jak często odświeżać poziomy (w minutach) |

### Przykłady formatów prefiksów

| Format | Wynik |
|--------|--------|
| `[{LEVEL}]` | `[6] PlayerName: message` |
| `「{LEVEL}」` | `「6」 PlayerName: message` |
| `LVL {LEVEL}\|` | `Poziom 6 \| NazwaGracza: wiadomość` |

## Polecenia

| Polecenie | Opis |
|---------|-------------|
| `!faceit` | Menu zawierające wszystkich graczy online wraz z ich poziomami w serwisie Faceit |

## Jak to działa

1. Po nawiązaniu połączenia przez gracza pobiera poziom Faceit z API Faceit za pomocą identyfikatora SteamID64
2. Poziom jest zapisywany w pamięci podręcznej i odświeżany co `RefreshMinutes`
3. Oznaczenie na tablicy wyników ustala się za `InventoryServices.Rank[5]`pomocą oznaczeń MedalRank z dodatku „Workshop”
4. Wiadomości na czacie otrzymują przedrostek`[LVL]` umieszczony przed nazwą gracza
5. Nazwa klanu aktualizuje się co 3 sekundy, pokazując aktualny poziom w Faceit
6. `!faceit` otwiera menu zawierające listę wszystkich graczy online

## Wydajność

- Liczba wywołań API jest ograniczona do 3 równoczesnych żądań
- Zgłoszenia zduplikowane są automatycznie odrzucane
- Nieaktualne dane są usuwane co 5 minut
- Dane na tablicy wyników są aktualizowane w czasie rzeczywistym za pośrednictwem OnTick

## Autor

**illusion @ CodeStrike**

## Licencja

Wszelkie prawa zastrzeżone.