# 🔫 Weapon Override — wtyczka SourceMod do CS:GO

**Autor:** illusion @ [CodeStrike.store](https://codestrike.store)
**Wersja:** 1.4
**Gra:** Counter-Strike: Global Offensive (CS:GO)
**Platforma:** SourceMod 1.10+

---

## 📋 Opis

**Weapon Override** to potężne narzędzie dla serwerów CS:GO, które pozwala graczom z drużyny CT wybierać preferowany zestaw broni niezależnie od ustawień ekwipunku. Automatycznie zastępuje ono karabin **M4A4** modelem **M4A1-S,** a pistolet **P2000** modelem **USP-S,** zgodnie z preferencjami gracza.

Wtyczka działa bez zarzutu podczas odrodzenia, przy zakupach w sklepie, a nawet podczas podnoszenia broni z ziemi.

---

## ✨ Funkcje

- 🔄 **Automatyczna zamiana** — natychmiastowa zamiana M4A4/P2000 na wersje z tłumikiem.
- 💾 **Ustawienia trwałe** — wybrane opcje są zapisywane w bazie danych (SQLite/MySQL) i przywracane po ponownym nawiązaniu połączenia.
- 🛠️ **Menu interaktywne** — łatwe w obsłudze menu służące do włączania i wyłączania ustawień nadrzędnych.
- ⚡ **Wymuś zmianę** — opcja „Zastosuj teraz”, umożliwiająca zmianę aktualnie posiadanej broni w trakcie rundy (jako CT).
- 💡 **Inteligentne podpowiedzi** — przypominają graczom o funkcji zastąpienia broni, jeśli na początku rundy używają broni domyślnych.
- 🔌 **Obsługa późnego ładowania** — natychmiast podłącza graczy, jeśli wtyczka zostanie załadowana w trakcie meczu.

---

## 📦 Instalacja

1. Skopiuj do`weapon_override.smx`:
```
csgo/addons/sourcemod/plugins/
```

2. (Opcjonalnie) Skonfiguruj bazę danych w `addons/sourcemod/configs/databases.cfg`. Domyślnie wykorzystywany jest wpis`storage-local` .

3. Załaduj wtyczkę:
```
sm plugins load weapon_override
```

---

## ⚙️ Konfiguracja

### CVars
Wtyczka wykorzystuje następującą zmienną CVar do określenia, który wpis w bazie danych ma zostać użyty:
- `sm_override_db` (Wartość domyślna: `storage-local`) — Połączenie o podanej nazwie w pliku `databases.cfg`.

### Tabela bazy danych
Wtyczka automatycznie tworzy tabelę o nazwie `weapon_override`o następującej strukturze:
- `steamid` (Klucz podstawowy)
- `rifle` (0/1)
- `pistol` (0/1)

---

## 🛠️ Polecenia

| Polecenie | Opis |
|---|---|
| `!override` / `/override` | Otwiera menu ustawień nadpisywania broni |
| `!weapons` / `/weapons` | Otwiera menu ustawień nadpisywania broni |
| `sm_override` | Polecenie konsoli służące do otwarcia menu |
| `sm_weapons` | Polecenie konsoli służące do otwarcia menu |

---

## 🎮 Opcje menu

1. **Zastąp M4A1-S** — Przełączaj między `[ON]`(M4A4 → M4A1-S) a `[OFF]`(Zachowaj M4A4).
2. **Zastąp USP-S** — Przełączanie między `[ON]`(P2000 → USP-S) a `[OFF]`(Zachowaj P2000).
3. **Zastosuj teraz** — zamienia twoją aktualną broń, jeśli żyjesz i należysz do drużyny CT.

---

## 📁 Struktura plików

```
csgo/addons/sourcemod/
├── plugins/
│ └── weapon_override.smx ← Compiled plugin
└── scripting/
└── weapon_override.sp ← Source code
```

---

## 📜 Lista zmian

### wersja 1.4
- Do menu dodano przycisk „Zgłoś się teraz”.
- Ulepszono logikę zmiany broni, aby zapobiec powielaniu obiektów.
- Dodano trwałą pamięć bazy danych.
- Dodano podpowiedzi dotyczące rozpoczęcia rundy.

---

**© 2026 illusion @ [CodeStrike.store](https://codestrike.store)** — Wszelkie prawa zastrzeżone.