# 🏆 Система MVP – плъгин за CounterStrikeSharp

**Брутален и богат на функции** плъгин **„MVP System“** за Counter-Strike 2, който обявява най-ценния играч в края на всеки рунд с подробна статистика, красиви цветни съобщения в чата, **както и впечатляващи съобщения на екрана (HUD)**!


---

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

- **🎯 Разнообразни критерии за MVP** – Изберете MVP въз основа на убити, нанесени щети, изстрели в главата или асистенции
- **📊 Подробна статистика** – отчита убийствата, смъртните случаи, изстрелите в главата, нанесените щети, асистенциите и още много други
- **🔪 Специално проследяване на убийствата** – убийства с нож, убийства през стена, убийства без прицел, убийства с граната
- **🎨 Напълно персонализируеми съобщения** – Всички съобщения поддържат цветни заместващи символи
- **📺 Съобщения на HUD** – Красиво екранно меню във формат HTML с възможност за персонализиране на стила
- **⚙️ Конфигурация в JSON** – Лесна за настройка без прекомпилиране
- **🤖 Филтриране на ботове** – възможност за включване или изключване на ботовете от изчисленията на MVP
- **🏅 Най-полезен играч на отбора** – възможност да се вземат предвид само играчи от победилия отбор
- **💬 Красиви съобщения** – впечатляващи цветни съобщения в чата с поддръжка на емоджита

---

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

1. **Изтеглете** компилирания плъгин (`MVPSystem.dll`)
2. **Създайте** папка в директорията с плъгини на CounterStrikeSharp:
```
csgo/addons/counterstrikesharp/plugins/MVPSystem/
```
3. **Копирай** `MVPSystem.dll`в папката
4. **Рестартирайте** сървъра си или заредете плъгина чрез командата за администратори

---

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

При първото стартиране плъгинът автоматично създава конфигурационен файл в:

```
csgo/addons/counterstrikesharp/configs/plugins/MVPSystem/MVPSystem.json
```

### Опции за конфигуриране

| Опция | Тип | По подразбиране | Описание |
| -------------------------- | ------ | --------- | ----------------------------------------------------------------- |
| `plugin_enabled` | bool | `true` | Активиране или деактивиране на приставката |
| `chat_prefix` | низ | `""` | Префикс за всички съобщения в чата |
| `mvp_criteria` | низ | `"kills"` | Критерии за избор на MVP: `kills`, `damage`, `headshots`, `assists` |
| `only_winning_team` | bool | `false` | Вземете предвид само играчите от победилия отбор |
| `include_bots` | bool | `false` | Включване на ботовете в изчисленията на MVP |
| `count_team_damage` | bool | `false` | Включване на щетите, нанесени от отбора, в статистиката за щетите |
| `show_no_mvp_message` | bool | `true` | Показване на съобщение, когато не е намерен MVP |
| `show_detailed_stats` | bool | `true` | Показване на подробна статистика в съобщението |
| `show_extra_stats` | bool | `true` | Показване на допълнителни статистики (нож, стрелба през стена, стрелба без прицел) |
| `show_separator_lines` | bool | `true` | Показване на разделителни линии около съобщението |
| `enable_chat_announcement` | bool | `true` | Активиране на съобщенията в чата |
| `enable_hud_announcement` | bool | `true` | Активиране на HUD/съобщения на екрана |

### Настройки на HUD

| Опция | Тип | По подразбиране | Описание |
| ------------------- | ------ | ---------------------- | ------------------------------------- |
| `display_duration` | float | `5.0` | Колко дълго да се показва HUD (в секунди) |
| `title_color` | низ | `"#FFD700"` | Цвят на заглавието (златно) |
| `player_name_color` | низ | `"#00FF00"` | Цвят на името на играча (зелен) |
| `stats_color` | низ | `"#FFFFFF"` | Цвят на текста на статистиката (бял) |
| `accent_color` | низ | `"#FF4444"` | Акцентен цвят (червен) |
| `background_color` | низ | `"rgba(0, 0, 0, 0.8)"` | Цвят на фона с прозрачност |
| `hud_template` | низ | _HTML шаблон_ | Напълно персонализируем HTML шаблон |

### Примерна конфигурация

```json
{
"plugin_enabled": true,
"chat_prefix": "",
"mvp_criteria": "kills",
"only_winning_team": false,
"include_bots": false,
"count_team_damage": false,
"show_no_mvp_message": true,
"show_detailed_stats": true,
"show_extra_stats": true,
"enable_chat_announcement": true,
"enable_hud_announcement": true,
"show_separator_lines": true,
"hud_settings": {
"display_duration": 5.0,
"title_color": "#FFD700",
"player_name_color": "#00FF00",
"stats_color": "#FFFFFF",
"accent_color": "#FF4444",
"background_color": "rgba(0, 0, 0, 0.8)",
"hud_template": "<div style='background: linear-gradient(135deg, {hud_bg_color}, rgba(30, 30, 30, 0.95)); border: 2px solid {hud_title_color}; border-radius: 15px; padding: 20px 40px; text-align: center; box-shadow: 0 0 30px rgba(255, 215, 0, 0.5);'><div style='font-size: 24px; color: {hud_title_color}; font-weight: bold; text-shadow: 0 0 10px {hud_title_color}; margin-bottom: 10px;'>★ ROUND MVP ★</div><div style='font-size: 32px; color: {hud_player_color}; font-weight: bold; text-shadow: 0 0 15px {hud_player_color}; margin-bottom: 15px;'>🏆 {player}</div><div style='font-size: 18px; color: {hud_stats_color}; margin-bottom: 8px;'><span style='color: #00FF00;'>{kills}</span> Kills • <span style='color: {hud_accent_color};'>{headshots}</span> Headshots ({hspercent}%) • <span style='color: #4488FF;'>{damage}</span> Damage</div><div style='font-size: 14px; color: #888888;'>K/D: {kd} • Assists: {assists}</div></div>"
},
"messages": {
"separator_line": "{gold}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━",
"mvp_title_line": "{yellow}★ {gold}ROUND MVP {yellow}★",
"mvp_announcement_message": "{lime}🏆 {gold}{player} {white}is the {yellow}MVP {white}of this round!",
"mvp_stats_line": "{grey}» {green}{kills} Kills {white}| {red}{headshots} Headshots ({hspercent}%) {white}| {blue}{damage} Damage {white}| {purple}{assists} Assists",
"mvp_extra_stats_line": "{grey}» {orange}Special: {lightred}🔪 {knifekills} Knife {white}| {magenta}⊛ {wallbangkills} Wallbang {white}| {lightblue}⌖ {noscopekills} Noscope",
"no_mvp_message": "{grey}No MVP this round - no kills recorded."
},
"version": 1
}
```

---

## 🎨 Запълнители за цвят в чата

Използвайте тези заместващи символи в съобщенията си в чата, за да добавите цветове:

| Заместващ текст | Цвят |
| --------------- | ------------ |
| `{default}` | По подразбиране |
| `{white}` | Бяло |
| `{red}` | Червено |
| `{lightred}` | Светлочервено |
| `{darkred}` | Тъмночервено |
| `{green}` | Зелено |
| `{lime}` | Лайм |
| `{olive}` | Маслина |
| `{yellow}` | Жълто |
| `{lightyellow}` | Светложълто |
| `{gold}` | Злато |
| `{orange}` | Оранжево |
| `{blue}` | Синьо |
| `{lightblue}` | Светлосиньо |
| `{darkblue}` | Тъмно синьо |
| `{purple}` | Лилаво |
| `{lightpurple}` | Светлолилаво |
| `{magenta}` | Магента |
| `{grey}` | Сиво |
| `{silver}` | Сребро |
| `{bluegrey}` | Синьо-сиво |

---

## 🖥️ Цветови заместители в HUD

Използвайте тези заместващи символи във вашия шаблон за HUD:

| Заместващ текст | Описание |
| -------------------- | ----------------------------- |
| `{hud_title_color}` | Цвят на заглавието от конфигурацията |
| `{hud_player_color}` | Цвят на името на играча от конфигурацията |
| `{hud_stats_color}` | Цвят на текста на статистиката от конфигурацията |
| `{hud_accent_color}` | Акцентен цвят от конфигурацията |
| `{hud_bg_color}` | Цвят на фона от конфигурацията |

---

## 📝 Заместващи символи в съобщенията

Използвайте следните заместващи символи в съобщенията си:

| Заместващ текст | Описание |
| ----------------- | ------------------------ |
| `{player}` | Име на играча, избран за MVP |
| `{kills}` | Брой убити |
| `{deaths}` | Брой на смъртните случаи |
| `{headshots}` | Брой изстрели в главата |
| `{damage}` | Общо нанесени щети |
| `{assists}` | Брой асистенции |
| `{flashassists}` | Брой асистенции при флаш |
| `{knifekills}` | Брой убийства с нож |
| `{wallbangkills}` | Брой убийства чрез „wallbang“ |
| `{noscopekills}` | Брой убийства без носкоп |
| `{grenadekills}` | Брой убийства с гранати |
| `{kd}` | Съотношение „убийства/смъртни случаи“ |
| `{hspercent}` | Процент на точните изстрели в главата |

---

## 📸 Предварителен преглед

### Съобщение в чата

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
★ ROUND MVP ★
🏆 PlayerName is the MVP of this round!
» 5 Kills | 3 Headshots (60%) | 450 Damage | 1 Assists
» Special: 🔪 1 Knife | ⊛ 0 Wallbang | ⌖ 1 Noscope
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

### Съобщение на HUD (в центъра на екрана)

```
┌─────────────────────────────────────┐
│ ★ ROUND MVP ★ │
│ 🏆 PlayerName │
│ 5 Kills • 3 Headshots (60%) │
│ 450 Damage │
│ K/D: 2.50 • Assists: 1 │
└─────────────────────────────────────┘
```

---

## 🛠️ Създаване от изходния код

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

- .NET 8.0 SDK
- CounterStrikeSharp API

### Команди за изграждане

```bash
# Restore dependencies
dotnet restore

# Build the plugin
dotnet build --configuration Release
```

Компилираният файл `MVPSystem.dll`ще се намира в:

```
bin/Release/net8.0/MVPSystem.dll
```

---

## 📄 Лиценз

Този плъгин се предоставя „както е“ за използване на вашите CS2 сървъри.

---

## 👨‍💻 Автор

**illusion @ CodeStrike.STORE**

- 🌐 Уебсайт: [CodeStrike.STORE](https://codestrike.store)
- 💬 Discord: Достъпно на уебсайта

---

## 🤝 Подкрепа

За поддръжка, предложения за нови функции или съобщения за грешки:

- Посетете [CodeStrike.STORE](https://codestrike.store)
- Присъединете се към нашата общност в Discord

---

## 📝 Списък с промените

### версия 1.1.0

- **НОВО: Съобщения на HUD** – Красиво екранно представяне на MVP във формат HTML
- Шаблон за HUD с възможност за персонализиране и пълна поддръжка на HTML/CSS
- Настройваема продължителност на показване на HUD
- Отделни опции за включване/изключване на съобщенията в чата и на HUD
- Настройваеми цветове на HUD (заглавие, име на играча, статистика, акцент, фон)

### версия 1.0.0

- Първоначално издание
- Пълна система за проследяване на MVP
- Съобщения, които могат да се персонализират чрез JSON
- Опции за различни критерии за MVP
- Специално отчитане на убийствата (с нож, през стена, без прицел)
- Красиви цветни съобщения в чата

---

_Създадено с ❤️ от illusion @ CodeStrike.STORE_