# Plugin pentru reclame avansate

**Versiune:** 1.0
**Autor:** illusion @ CodeStrike.STORE
**Numele pluginului:** Reclame avansate

## Descriere

AdvertsNEW este un plugin AMX Mod X pentru serverele Counter-Strike care afișează anunțuri publicitare personalizabile, afișate alternativ, jucătorilor prin intermediul mesajelor HUD și al mesajelor colorate din chat. Pluginul suportă mai multe moduri de afișare, culori aleatorii (HUD) și diverse efecte vizuale pentru a crea anunțuri de server care atrag atenția.

## Caracteristici

- ✅ **Anunțuri rotative**: afișează mai multe anunțuri în ordine secvențială sau aleatorie
- ✅ **Reclame HUD**: Afișează reclame sub formă de mesaje HUD colorate pe ecran
- ✅ **Reclame în chat**: afișează reclame în chat (acceptă etichete colorate)
- ✅ **Comenzi de chat (declanșatoare)**: Definiți-le în`key = message` fișierul INI și declanșați-le tastând comanda respectivă în chat
- ✅ **Culori aleatorii (HUD)**: Fiecare reclamă HUD se afișează cu culori generate aleatoriu
- ✅ **Poziție personalizabilă**: Configurează poziția pe axele X/Y a mesajelor HUD
- ✅ **Efecte vizuale**: diverse efecte de apariție treptată și dispariție treptată, precum și moduri de afișare
- ✅ **Simboluri de substituție**: Suport pentru și`%map%` `%servername%`(HUD + chat)
- ✅ **Mesaje HUD pe mai multe linii**: Suport pentru `%newline%`(numai HUD)
- ✅ **Reîncărcare din mers**: Reîncărcarea configurației fără repornirea serverului
- ✅ **Crearea automată a configurației**: creează automat configurația implicită dacă aceasta lipsește

## Instalare

1. **Compilarea pluginului:**

```bash
amxxpc AdvertsNEW.sma
```

2. **Încărcare fișiere:**

- Puneți în`AdvertsNEW.amxx` `/addons/amxmodx/plugins/`
- Adaugă `AdvertsNEW.amxx`la `/addons/amxmodx/configs/plugins.ini`

3. **Configurație:**
- Pluginul va crea automat `/addons/amxmodx/configs/adverts.ini`
- Editați acest fișier pentru a adăuga reclamele dvs. personalizate

## Fișier de configurare

**Fișier:** `/addons/amxmodx/configs/adverts.ini`

### Format:

```ini
; Adverts Configuration File
; Lines starting with ; are comments and will be ignored
; Placeholders: %map% (current map), %servername% (hostname)
; Chat colors: !g = green, !t = team color, !n = normal

[HUD]
Welcome to %servername%!
Current map: %map%
Line 1%newline%Line 2 of same HUD advert

[CHAT]
!g[Info] !nWelcome to !t%servername%
!g[Map] !nCurrent map: !t%map%
discord = !g[Discord] !nJoin our Discord: !thttps://discord.gg/yourserver
```

### Simboluri de substituție și etichete:

- `%map%` - Înlocuit cu numele actual al hărții
- `%servername%` - Înlocuit cu numele de gazdă al serverului (`hostname`cvar)
- `%newline%` - Creează o întrerupere de rând în mesajul HUD (numai în HUD)
- `!g` / `!t`/ `!n`- Etichete colorate pentru chat (numai în chat)
- Liniile care încep cu sau`;` `/`sunt considerate comentarii

### Comportamentul INI (important):

- Liniile de sub `[HUD]`sunt considerate reclame HUD.
- Sub`[CHAT]`:
- O linie **fără** `=`este considerată o reclamă ciclică în chat.
- O linie **care conține** `key = message`este stocată ca declanșator al unei comenzi de chat.
- Cuvântul-cheie declanșator este considerat potrivit dacă apare **oriunde în mesaj** (sunt acceptate mesajele formate din mai multe cuvinte).
- `/key` și sunt acceptate și prefixele`!key`.
- Dacă jucătorul tastează **doar** cuvântul-cheie (de exemplu, sau`discord` `/discord`), mesajul jucătorului este ascuns și se afișează doar răspunsul pluginului.
- Dacă cuvântul-cheie apare în cadrul unui mesaj mai lung (de exemplu, `how to join discord server?`), mesajul jucătorului rămâne vizibil și se afișează și răspunsul pluginului.

## CVars (variabile de consolă)

| CVar | Implicit | Descriere |
| ---------------------- | ------- | ---------------------------------------------- |
| `amx_adverts_enabled` | `1` | Activarea/dezactivarea sistemului de publicitate |
| `amx_adverts_interval` | `60.0` | Intervalul de timp dintre reclame (secunde) |
| `amx_adverts_random` | `0` | Ordine aleatorie (1) sau secvențială (0) |
| `amx_adverts_effect` | `2` | Tipul efectului mesajului HUD (0-3) |
| `amx_adverts_holdtime` | `5.0` | Cât timp să fie afișată fiecare reclamă |
| `amx_adverts_fadein` | `0.1` | Durata de apariție treptată (secunde) |
| `amx_adverts_fadeout` | `0.2` | Durata de estompare (secunde) |
| `amx_adverts_x` | `-1.0` | Poziția pe axa X (-1,0 = centru) |
| `amx_adverts_y` | `0.2` | Poziția pe axa Y (0,0 = sus, 1,0 = jos) |

### CVAR-uri pentru anunțurile din chat:

| CVar | Implicit | Descriere |
| --------------------------- | ------- | ---------------------------------------------- |
| `amx_adverts_chat_enabled` | `1` | Activare/dezactivare anunțuri ciclice în chat |
| `amx_adverts_chat_interval` | `60.0` | Intervalul de timp dintre reclamele din chat (secunde) |
| `amx_adverts_chat_random` | `0` | Ordine aleatorie (1) sau secvențială (0) |

### CVAR-uri pentru comenzi în chat:

| CVar | Implicit | Descriere |
| ------------------------------ | ------- | ----------------------------------------------- |
| `amx_adverts_chatcmd_enabled` | `1` | Activare/dezactivare a declanșatoarelor de comenzi din chat |
| `amx_adverts_chatcmd_to_all` | `0` | 0 = se afișează doar expeditorului, 1 = se afișează tuturor |
| `amx_adverts_chatcmd_cooldown` | `5.0` | Timp de așteptare (secunde) pe jucător pentru declanșarea mesajelor de chat |

### Tipuri de efecte:

- `0` - Niciun efect
- `1` - Apariție/dispariție treptată
- `2` - Efect de bliț/stroboscopic
- `3` - Efectul de scriere

## Comenzi de administrare

| Comandă | Nivelul de acces | Descriere |
| ------------------- | ------------ | --------------------------------------------------- |
| `amx_reloadadverts` | `ADMIN_CVAR` | Reîncarcă configurația reclamelor fără a reporni sistemul |

## Exemple de utilizare

### Configurație de bază:

```ini
[HUD]
Welcome to %servername%!
Visit our website: www.yoursite.com
Current map: %map%
Join our Discord: discord.gg/yourserver
Type !shop to open the store

[CHAT]
!g[Info] !nWelcome to !t%servername%
discord = !g[Discord] !nJoin our Discord: !thttps://discord.gg/yourserver
```

### Reclamă pe mai multe rânduri:

```ini
[HUD]
=== SERVER RULES ===%newline%1. No cheating%newline%2. No spam%newline%3. Have fun!
```

### Conținut dinamic:

```ini
You are playing on: %map%
Server time: Check !time command
```

## Detalii tehnice

- **Dependențe:** amxmodx, amxmisc, reapi, reapi_stocks
- **Număr maxim de anunțuri:** 32
- **Lungimea maximă a mesajului:** 192 de caractere
- **Stocare bazată pe tabele:** utilizează tabele dinamice pentru o gestionare eficientă a memoriei
- **Sistem de culori:** valori RGB generate aleatoriu pentru fiecare afișaj

## Sfaturi de configurare

1. **Setări poziție:**

- X: centrare`-1.0` orizontală, `0.0`= stânga, `1.0`= dreapta
- Y: `0.0`= partea de sus a ecranului, `1.0`= partea de jos a ecranului

2. **Recomandări privind sincronizarea:**

- Interval: 30–120 de secunde (evitați spamul)
- Durata de menținere: 3-8 secunde (durata de vizibilitate)
- Durata de estompare: 0,1–0,5 secunde (tranziții fluide)

3. **Linii directoare privind mesajele:**
- Asigurați-vă că mesajele sunt concise și clare
- Folosiți-l cu moderație`%newline%` pentru a evita aglomerarea
- Testați diferite tipuri de efecte pentru a obține cea mai bună vizibilitate

## Depanare

**Nu se afișează reclamele?**

- Opțiunea „Verificare” `amx_adverts_enabled`este setată la `1`
- Opțiunea „Verificare” `amx_adverts_chat_enabled`este setată la `1`pentru reclamele din chat
- Verificați dacă fișierul de configurare există și dacă conținutul său este valid
- Asigurați-vă că există cel puțin o linie care nu conține comentarii în fișierul de configurare

**Probleme legate de poziție?**

- Reglați `amx_adverts_y`valorile și`amx_adverts_x`
- Testați cu diferite rezoluții ale ecranului

**Aveți îngrijorări legate de performanță?**

- Măriți durata intervalului dacă serverul prezintă întârzieri
- Reduceți numărul de reclame dacă consumul de memorie este ridicat

## Asistență

Pentru probleme sau întrebări:

- Autor: illusion @ CodeStrike.STORE
- Consultați documentația AMX Mod X pentru a afla care sunt limitările mesajelor afișate pe HUD
- Verificați instalarea ReAPI pentru a vă asigura că funcționează corect

---

**Notă:** Acest plugin necesită ReAPI pentru funcționalități avansate ale mesajelor HUD. Asigură-te că ReAPI este instalat și configurat corespunzător pe serverul tău de Counter-Strike.