# CS Chat Logger за Discord

Плъгин за Counter-Strike 1.6 AMX Mod X, който записва в реално време всички съобщения от чата в играта, чата на отбора, както и събитията при присъединяване и излизане на играчи в канал в Discord чрез уебхукове.

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

- 💬 **Записване на всички чат съобщения** – Записва всички съобщения от публичните чатове
- 👥 **Записване на чата в екипа** – записва съобщенията, специфични за всеки екип (терористи, антитерористи, зрители)
- 📥 **Съобщения за присъединяване** – Записва се, когато играчите се свързват със сървъра
- 📤 **Съобщения за излизане** – Записва кога играчите напускат сървъра
- ⚙️ **Настройваемо** – CVars за активиране/деактивиране на конкретни функции
- 🎨 **Форматирани съобщения** – Използва форматирането на Discord (удебелен шрифт, блокове с код) и емоджита за по-добра четимост
- 🚫 **Филтриране на ботове** – автоматично игнорира съобщенията от ботове

## Формат на съобщението

### Всички чатове
```
💬 **PlayerName**: message content
```

### Групов чат
```
🔴 **PlayerName** `[T]`: message content (Terrorists)
🔵 **PlayerName** `[CT]`: message content (Counter-Terrorists)
👁️ **PlayerName** `[SPEC]`: message content (Spectators)
```

### Свързване/Развързване
```
📥 **PlayerName** joined the server
📤 **PlayerName** left the server
```

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

1. **Изтегляне на зависимости**
- Уверете се, че имате `easy_http.inc`в папката „include“ на AMX Mod X
- Задължителните елементи включват: `amxmodx`, `amxmisc`, `cstrike`, `easy_http`

2. **Конфигуриране на уебхук**
- Създайте уебхук в Discord в желания от вас канал
- Отворете файла и`ChatLogger.sma` заместете URL адреса на уебхука в ред 15:
```pawn
new const g_szWebhookURL[] = "YOUR_DISCORD_WEBHOOK_URL_HERE"
```

3. **Компилиране**
- Компилирайте плъгина с помощта на компилатора AMX Mod X
- Поставете компилирания файл в`ChatLogger.amxx` `addons/amxmodx/plugins/`

4. **Активиране на плъгина**
- Добави към`ChatLogger.amxx` `addons/amxmodx/configs/plugins.ini`

5. **Рестартиране на сървъра**
- Рестартирайте сървъра си или сменете картата, за да се зареди плъгинът

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

Добавете тези CVars към вашия файл `amxx.cfg`или ги задайте чрез конзолата/RCON:

### chatlog_show_teamchat
- **Описание**: Определя дали съобщенията от отборния чат се записват в Discord
- **Стойности**:
- `1` = Показване на чата на отбора (по подразбиране)
- `0` = Скриване на чата на отбора
- **Пример**: `chatlog_show_teamchat 1`

### chatlog_show_joinleave
- **Описание**: Определя дали съобщенията за присъединяване/отключване на играчи да се записват в Discord
- **Стойности**:
- `1` = Показване на съобщения за присъединяване/напускане (по подразбиране)
- `0` = Скриване на съобщенията за присъединяване/напускане
- **Пример**: `chatlog_show_joinleave 0`

## Примери за употреба

### Покажи всичко (по подразбиране)
```
chatlog_show_teamchat 1
chatlog_show_joinleave 1
```

### Показване само на публичния чат
```
chatlog_show_teamchat 0
chatlog_show_joinleave 0
```

### Показване на чата, но скриване на спама при присъединяване/напускане
```
chatlog_show_teamchat 1
chatlog_show_joinleave 0
```

## Настройка на уебхук за Discord

1. Отворете своя Discord сървър
2. Отидете в „Настройки на сървъра“ → „Интеграции“ → „Уебхукове“
3. Кликнете върху „Нов уебхук“
4. Изберете канала, в който искате да се съхраняват записите от чата
5. Копирайте URL адреса на уебхука
6. Поставете го в изходния код на плъгина (ред 15)
7. Прекомпилирайте плъгина

## Технически подробности

- **Версия на приставката**: 1.0
- **Автор**: illusion
- **Зависимости**: AMX Mod X 1.8.2+ и модулът easy_http
- **HTTP метод**: POST заявки към API-то за уебхукове на Discord
- **Време за изчакване**: 5 секунди на заявка
- **Тип на съдържанието**: application/json

## Отстраняване на неизправности

### Съобщения, които не се показват в Discord
- Уверете се, че URL адресът на уебхука е правилен
- Проверете логовете на AMX Mod X за грешки: `addons/amxmodx/logs/`
- Уверете се, че `easy_http`модулът е зареден
- Проверете URL адреса на уебхука ръчно с помощта на curl или Postman

### Грешки при компилирането
- Уверете се, че всички включени файлове се намират в `addons/amxmodx/scripting/include/`
- Уверете се, че използвате AMX Mod X 1.8.2 или по-нова версия
- Проверете дали е`easy_http.inc` инсталиран правилно

### Появяват се съобщения от ботове
- Плъгинът автоматично филтрира ботовете, като използва `is_user_bot()`
- Ако ботовете продължават да се появяват, вероятно играта не ги открива правилно

## Декларация за поверителност

Този плъгин записва всички съобщения от чата и информацията за играчите във външен канал в Discord. Уверете се, че:
- Уведомете играчите си, че чатът се записва
- Спазвайте местните закони и разпоредби за защита на личните данни
- Запазете URL адреса на уебхука си в Discord (не го споделяйте публично)

## Лиценз

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

## Поддръжка

При проблеми, предложения или желание да допринесете, моля, свържете се с автора на приставката.

---

**Забележка**: Този плъгин изпраща данни към сървърите на Discord. Уверете се, че вашият сървър има интернет връзка и може да се свърже с крайните точки на API-то на Discord.