# Подробная информация о Faceit

Плагин для CS2, который отображает реальные уровни Faceit с помощью значков в таблице результатов, префикса в чате, тега клана и меню.

## Особенности

- **Значки в таблице результатов** — отображение пользовательских значков уровней Faceit в таблице результатов (требуется дополнение из Workshop + MultiAddonManager)
- **`!faceit` Меню** — отображает список всех игроков, находящихся в сети, с указанием их уровней Faceit через MenuManager
- **Префикс чата** — добавляется `[6] PlayerName`перед каждым сообщением в чате (формат настраивается)
- **Тег клана** — `[6]`отображается в таблице результатов рядом с именем игрока
- **Автоматическое обновление** — периодически загружает данные из API Faceit
- **Ограничение скорости** — не более 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. Убедитесь, что программа «Ensure» `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**

## Лицензия

Все права защищены.