# 📢 CallAdmin Simple – lekki system raportowania

## 🔥 Opis

**CallAdmin Simple** to uproszczona wersja popularnej wtyczki CallAdmin, specjalnie zoptymalizowana pod kątem wydajności i łatwości konfiguracji. Wtyczka umożliwia graczom zgłaszanie osób naruszających zasady bezpośrednio na kanale Discord bez konieczności korzystania z bazy danych MySQL.

## ✨ Najważniejsze cechy

- **Brak MySQL:** Wszystkie dane są przechowywane w pamięci serwera (RAM).
- **Webhook Discorda:** wysyła przejrzyste i szczegółowe raporty do Discorda.
- **Oczyszczanie ciągów znaków:** Ochrona przed błędami HTTP 400 spowodowanymi przez znaki specjalne (cyrylica, emoji itp.).
- **Ochrona przed spamem:** Wbudowana ochrona przed zgłaszaniem spamu.
- **Wydajność:** Nieblokujące żądania HTTP, które nie powodują spowolnienia serwera.
- **Menu administratora:** Administratorzy mogą przeglądać najnowsze raporty w grze.

## 🚀 Instalacja

### Krok 1: Kompilacja

1. Otwórz `CallAdmin_Simple.sma`.
2. Skompiluj to za pomocą programu AMX Mod X w wersji 1.8.2 lub nowszej.
3. Otrzymasz `CallAdmin_Simple.amxx`.

### Krok 2: Instalacja serwera

1. Skopiuj `.amxx`plik do `addons/amxmodx/plugins/`.
2. Otwórz `addons/amxmodx/configs/plugins.ini`.
3. Dodaj w nowym wierszu:
```
CallAdmin_Simple.amxx
```

### Krok 3: Konfiguracja Discorda

1. Utwórz webhook na swoim serwerze Discord (Ustawienia serwera → Integracje → Webhooki).
2. Skopiuj adres URL webhooka.
3. Otwórz plik`.sma` i edytuj wiersz 31:
```pawn
#define DISCORD_WEBHOOK_URL "YOUR_WEBHOOK_URL_HERE"
```
4. Skompiluj ponownie wtyczkę.

## ⚙️ Konfiguracja (w pliku .sma)

Wszystkie ustawienia znajdują się na początku pliku:

```pawn
// Discord Webhook URL
#define DISCORD_WEBHOOK_URL "https://discord.com/..."

// Server Name (shown in Discord)
#define SERVER_NAME "My CS 1.6 Server"

// Cooldown between reports (in seconds)
#define SPAM_COOLDOWN 300.0

// Maximum number of reports stored in memory
#define MAX_STORED_REPORTS 100
```

## 🎮 Polecenia

### Dla graczy:

- `/call` - Otwiera menu raportów
- `/calladmin` - Alternatywa
- `/report` - Alternatywa

### Dla administratorów (wymagany uprawnienie ADMIN_BAN):

- `/reports` - Wyświetla najnowsze raporty w menu

## 🛡️ Ochrona przed błędami

Wtyczka zawiera specjalną `SanitizeForDiscord`funkcję, która automatycznie usuwa z nazw graczy i opisów przyczyn problematyczne znaki (takie jak †, ™, © itp.), które zazwyczaj zakłócają działanie integracji z Discordem i powodują błędy HTTP 400.

## 📋 Wymagania

- AMX Mod X 1.8.2+
- Moduły: `amxmisc`, `cromchat`, `easy_http`
- `easy_http.inc` biblioteka (do połączenia z Discordem)

## 🐛 Rozwiązywanie problemów

**Problem:** Nie otrzymuję wiadomości w Discordzie.
**Rozwiązanie:**

1. Sprawdź, czy wartość jest`DISCORD_ENABLED` ustawiona na 1.
2. Sprawdź, czy adres URL webhooka jest poprawny.
3. Sprawdź konsolę serwera pod kątem błędów: `[CallAdmin] Discord webhook failed...`

**Problem:** Podczas generowania raportów serwer działa z opóźnieniem.
**Rozwiązanie:** Wtyczka korzysta z żądań nieblokujących, więc taka sytuacja nie powinna mieć miejsca. Upewnij się, że wartość jest`WEBHOOK_TIMEOUT` ustawiona na 5000 (5 sekund).

---

**Autor:** illusion
**Wersja:** 1.0