# Flash Notifier

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

```
You flashed PlayerName for 2.5s
PlayerName flashed you for 2.5s
```

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

- **Уведомление за атакуващия** – „Заслепихте PlayerName за 2,5 секунди“, когато заслепите някого
- **Уведомление за жертвата** – „ИграчИме ви е заслепил за 2,5 секунди“, когато ви заслепят
- **Имена в цветовете на отбора** – името на другия играч приема цвета на неговия отбор
- **Напълно конфигурируеми съобщения** – текст, цветове и заместващи символи
- **Филтър за минимална продължителност** – пренебрегва кратките частични светкавици, които никой не забелязва
- **Режим „Само за отбора“** – по избор да се известява само когато съотборник е заслепен
- **Лек** – само един кука за събитие, без таймери, без база данни, нищо на всеки тик

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

[CounterStrikeSharp](https://github.com/roflmuffin/CounterStrikeSharp/releases) (версия на API 227 или
(по-нова). Нищо друго.

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

1. Копирайте папката `FlashNotifier`в `addons/counterstrikesharp/plugins/`, така че накрая да получите
`addons/counterstrikesharp/plugins/FlashNotifier/FlashNotifier.dll`.
CounterStrikeSharp зарежда плъгин само от папка, чието име съвпада с това на неговия DLL файл – самият файл се намира в
`plugins/` се игнорира.
2. Рестартирайте сървъра или изпълнете `css_plugins load FlashNotifier`.
3. Конфигурацията се генерира в
`addons/counterstrikesharp/configs/plugins/FlashNotifier/FlashNotifier.json`.

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

```json
{
"NotifyAttacker": true,
"NotifyVictim": true,
"AttackerMessage": "{GREEN}You flashed {TEAM}{VICTIM}{GREEN} for {YELLOW}{DURATION}s",
"VictimMessage": "{TEAM}{ATTACKER}{DEFAULT} flashed you for {YELLOW}{DURATION}s",
"MinDuration": 0.5,
"DurationDecimals": 1,
"NotifyTeamFlashOnly": false,
"ConfigVersion": 1
}
```

| Опция | По подразбиране | Описание |
|--------|---------|-------------|
| `NotifyAttacker` | `true` | Изпрати съобщение на играча, който е хвърлил светкавицата |
| `NotifyVictim` | `true` | Изпрати съобщение на играча, който е бил „заслепен“ |
| `AttackerMessage` | виж по-горе | Линията, която вижда нападателят |
| `VictimMessage` | виж по-горе | Линията, която вижда жертвата |
| `MinDuration` | `0.5` | Минимална продължителност на „сляпото“ състояние, в секунди, която заслужава да бъде отчетена. Отрицателните стойности се третират като `0`. |
| `DurationDecimals` | `1` | Десетични знаци за продължителността (`1`= 2,5 с, `2`= 2,50 с). Ограничено до 0–3. |
| `NotifyTeamFlashOnly` | `false` | Да се уведомява само когато играчът с превръзка на очите е съотборник |

Самопроизвеждащите се светкавици никога не се отчитат – това вече го знаете.

## Заместващи символи

| Заместващ текст | Заменено с |
|-------------|---------------|
| `{ATTACKER}` | Името на играча, който хвърли флаш |
| `{VICTIM}` | Името на играча, който е загубил залозите си |
| `{DURATION}` | Продължителност на затъмнението в секунди |
| `{TEAM}` | Цвятът на отбора на** другия играч** – на жертвата в `AttackerMessage`, на нападателя в `VictimMessage` |
| `{ATTACKERTEAM}` | Цветът на отбора на нападателя, независимо в кое съобщение се използва |
| `{VICTIMTEAM}` | Цветът на отбора на жертвата, независимо в кое съобщение се използва |

Цветовете на отборите са оранжев за T и син за CT. Играч, който не е в нито един отбор, получава цвета по подразбиране
цвят.

Преди да бъдат въведени в реда, контролните символи се премахват от имената на играчите, така че едно име не може
променете цвета на чата си или го разделите на редове.

## Цветови кодове

| Код | Цвят |
|------|--------|
| `{DEFAULT}` / `{WHITE}` | Бяло |
| `{DARKRED}` | Тъмночервено |
| `{RED}` | Червено |
| `{LIGHTRED}` | Светлочервено |
| `{GREEN}` | Зелено |
| `{LIME}` | Лайм |
| `{OLIVE}` / `{LIGHTGREEN}` | Маслина |
| `{YELLOW}` / `{LIGHTYELLOW}` | Жълто |
| `{GOLD}` / `{ORANGE}` | Златно / оранжево |
| `{SILVER}` / `{BLUEGREY}` | Сребро |
| `{GREY}` / `{GRAY}` | Сиво |
| `{BLUE}` / `{LIGHTBLUE}` | Синьо |
| `{DARKBLUE}` | Тъмносиньо |
| `{PURPLE}` / `{MAGENTA}` | Лилаво |
| `{LIGHTPURPLE}` | Светлолилаво |

Някои имена се помещават в един ред, тъй като самата игра им присвоява един и същ цвят – те се запазват като
псевдоними, за да продължат да работят съществуващите конфигурации.

## Примери за съобщения

Покажи само продължителността:

```json
"VictimMessage": "{YELLOW}{DURATION}s{DEFAULT} flash from {TEAM}{ATTACKER}"
```

Минималистичен:

```json
"AttackerMessage": "{GREEN}Flash hit {TEAM}{VICTIM}",
"VictimMessage": "{RED}Flashed by {TEAM}{ATTACKER}"
```

И двете имена в един ред, всяко в цвета на своя отбор:

```json
"VictimMessage": "{ATTACKERTEAM}{ATTACKER}{DEFAULT} flashed {VICTIMTEAM}{VICTIM}{DEFAULT} for {YELLOW}{DURATION}s"
```

## Какво се съдържа в архива

```
addons/counterstrikesharp/plugins/FlashNotifier/
FlashNotifier.dll the plugin
FlashNotifier.deps.json dependency manifest - keep it next to the dll
README.md this file
```

Собствените асембли на CounterStrikeSharp умишлено не са включени; сървърът вече разполага с тях и
Второто копие може да доведе до конфликт между версиите.

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

### 1.1.0

- **Поправихме цветовите кодове.** Няколко маркера имаха цвят, различен от този, който обещаваше името им —
`{RED}` беше тъмночервено, `{PURPLE}`беше светлолилаво, `{GREY}`беше сребристо, `{LIGHTBLUE}`беше тъмно
синьо и изобщо не `{DARKBLUE}`беше цвят. Сега те се коригират чрез собствената технология на CounterStrikeSharp
константи, така че те се определят от играта, а не са твърдо зададени байтове.
- **Поправихме цветовете на отбора.** Буквите „Т“ се изписваха в лилаво, вместо в оранжево.
- **Поправено`{TEAM}`.** Винаги се използваше цветът на нападателя, така че в случая`AttackerMessage` на жертвата
Името беше нарисувано в цвета на отбора на нападателя. Сега то следва името, до което се намира, и
`{ATTACKERTEAM}` / `{VICTIMTEAM}`бяха добавени за пълен контрол.
- **Отново се съобщава за спам, свързан с ботове.** Преди това, ако някъде в двойката имаше бот, това водеше до
послание и за човека.
- **`DurationDecimals` е фиксирана** в диапазона 0–3. Стойност като тази преди се`-1` прилагаше при всеки светкавичен импулс.
- Имената на играчите се преобразуват, преди да бъдат включени в съобщението.
- Нови цветни жетони: `{DARKRED}`, `{LIGHTRED}`, `{OLIVE}`, `{GOLD}`, `{SILVER}`, `{BLUEGREY}`,
`{LIGHTPURPLE}`, `{MAGENTA}`, `{LIGHTYELLOW}`, `{GRAY}`.

### 1.0.0

- Първо издание.

## Автор

**illusion @ CodeStrike**

## Лиценз

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