# Подробности за Faceit

CS2 плъгин, който показва реалните нива във Faceit чрез икони в таблото с резултати, префикс в чата, таг на клана и меню.

## Характеристики

- **Икони в таблицата с резултати** – Показва персонализирани значки за нива в Faceit в таблицата с резултати (изисква добавка от Workshop + MultiAddonManager)
- **`!faceit` Меню** – Изброява всички онлайн играчи заедно с нивата им в Faceit чрез MenuManager
- **Префикс за чата** – поставя се `[6] PlayerName`пред всяко съобщение в чата (форматът се настройва)
- **Идентификатор на клана** – показва`[6]` се в таблицата с резултатите до името на играча
- **Автоматично обновяване** – периодично извлича данни от Faceit API
- **Ограничение на честотата** – максимум 3 едновременни заявки към API

## Изисквания

- [CounterStrikeSharp](https://github.com/roflmuffin/CounterStrikeSharp/releases) с CS2
- [MenuManager](https://github.com/NickFox/nf-core-MenuManager) (за меню`!faceit`)
- [MultiAddonManager](https://github.com/Source2ZE/MultiAddonManager) + [добавка Faceit Workshop](https://steamcommunity.com/sharedfiles/filedetails/?id=3724637448) (за икони на таблото с резултати)
- [API ключ за Faceit](https://developers.faceit.com/) – API ключ за сървъра

## Инсталиране

1. Копирай `FaceitDetails.dll`в `addons/counterstrikesharp/plugins/`
2. Уверете се, че и той е`MenuManager` инсталиран
3. Рестартирайте сървъра или стартирайте `css_plugins load FaceitDetails`
4. Конфигурацията се генерира автоматично в `configs/plugins/FaceitDetails/FaceitDetails.json`
5. Добавете своя API ключ за Faceit и презаредете страницата

### Настройка на иконите на таблото с резултати

За да се показват иконите за нивата в Faceit в таблицата с резултатите, добавете това към`game/csgo/cfg/multiaddonmanager/multiaddonmanager.cfg`:

```
mm_extra_addons "3724637448"
```

## Конфигурация

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

| Опция | По подразбиране | Описание |
|--------|---------|-------------|
| `FaceitApiKey` | `""` | Вашият API ключ за Faceit сървъра |
| `PrefixEnabled` | `true` | Добави `[LVL]`пред името на играча в чата |
| `PrefixFormat` | `"[{LEVEL}]"` | Формат на префикса в чата. `{LEVEL}`= Ниво във Faceit |
| `ClanTagEnabled` | `true` | Показване на нивото в Faceit като таг на клана в таблицата с резултатите |
| `ScoreboardIcons` | `true` | Показване на иконата/значката за ниво във Faceit в таблицата с резултатите |
| `RefreshMinutes` | `5` | Колко често да се актуализират нивата (в минути) |

### Примери за PrefixFormat

| Формат | Резултат |
|--------|--------|
| `[{LEVEL}]` | `[6] PlayerName: message` |
| `「{LEVEL}」` | `「6」 PlayerName: message` |
| `LVL {LEVEL}\|` | `Ниво 6 \| Име на играча: съобщение` |

## Команди

| Команда | Описание |
|---------|-------------|
| `!faceit` | Меню с всички онлайн играчи и техните нива във Faceit |

## Как работи

1. При свързване на играча се извлича нивото в Faceit от API-то на Faceit чрез SteamID64
2. Стойността на нивото се запазва в кеша и се актуализира на всеки `RefreshMinutes`
3. Пинът за таблото с резултати се задава чрез `InventoryServices.Rank[5]`използване на пиновете на MedalRank от добавката „workshop“
4. Съобщенията в чата получават префикс`[LVL]` пред името на играча
5. Емблемата на клана се актуализира на всеки 3 секунди с текущото ниво във Faceit
6. `!faceit` отваря меню, в което са изброени всички онлайн играчи

## Производителност

- Броят на API заявките е ограничен до 3 едновременни заявки
- Заявките за дубликати се отхвърлят автоматично
- Неактуалните данни се изтриват на всеки 5 минути
- Индексът на таблото се актуализира в реално време чрез OnTick

## Автор

**illusion @ CodeStrike**

## Лиценз

Всички права запазени.