# ❄️ SnowFall: Śnieg dla twojego serwera CS2
**Wersja 1.3.0** · Wtyczka CounterStrikeSharp · autor: illusion @ CodeStrike
Zmień dowolną mapę w mapę zimową. Śnieg pada z nieba wokół każdego gracza, na każdej mapie,
bez konieczności wprowadzania zmian w mapie i bez konieczności ręcznej instalacji czegokolwiek przez graczy.
---
## ✨ Funkcje
- **Śnieg na każdej mapie**: działa na de_dust2, mirage, inferno, mapach z Workshopu – na każdej mapie.
- **Dwie warstwy śniegu**: gęste płatki w pobliżu gracza oraz lżejszy śnieg w odległości do około 60 m, więc to
Wygląda na to, że śnieg pada na całej mapie.
- **Niewielkie obciążenie**: każdy gracz widzi tylko swój własny śnieg, więc 30 graczy kosztuje tyle samo, co
1. Płatki śniegu nigdy się nie gromadzą: każdy z nich znika po kilku sekundach.
- **Automatyczne pobieranie**: gracze otrzymują śnieg automatycznie po dołączeniu do gry (poprzez
(MultiAddonManager), bez konieczności ręcznego pobierania.
- **Również widzowie**: zmarli gracze i widzowie widzą śnieg wokół gracza, którego obserwują.
- **Wybór gracza**: każdy może wyłączyć śnieg tylko dla siebie za pomocą `!nosnow` (dla słabych postaci).
- **Przełącznik administracyjny**: `!snow`włącza lub wyłącza tę funkcję dla całego serwera.
- **Czystość**: śnieg jest usuwany przy rozłączeniu, ponownym uruchomieniu rundy oraz zmianie mapy, dzięki czemu nie pozostają żadne pozostałości
i nie ma problemów związanych z „zbyt dużą liczbą podmiotów”.
---
## 📋 Wymagania
| Co | Gdzie to kupić |
|---|---|
| **Metamod:Source** (wersja CS2) | metamodsource.net |
| **CounterStrikeSharp** (z biblioteką uruchomieniową, wersja 1.0.376 lub nowsza) | github.com/roflmuffin/CounterStrikeSharp |
| **MultiAddonManager** | github.com/Source2ZE/MultiAddonManager |
Jeśli na Twoim serwerze działają już inne wtyczki CounterStrikeSharp, wystarczy, że sprawdzisz
MultiAddonManager.
---
## 🚀 Instalacja (5 minut)
### Krok 1: Zainstaluj wtyczkę
1. Rozpakuj archiwum.
2. Skopiuj folder**`SnowFall`** na serwer pod adresem:
```
game/csgo/addons/counterstrikesharp/plugins/
```
w ten sposób otrzymujesz `.../plugins/SnowFall/SnowFall.dll`.
### Krok 2: Załaduj efekt śniegu (wybierz JEDNĄ opcję)
Sam śnieg (to, co widzą gracze) to niewielki dodatek stworzony w programie Workshop (~3 KB). Gracze pobierają go
automatycznie po dołączeniu.
#### Opcja A: Skorzystaj z naszego gotowego dodatku do warsztatu (najłatwiejsze rozwiązanie, zalecane)
Dodaj identyfikator warsztatu **`3837941466`**do MultiAddonManager. Otwórz:
```
game/csgo/cfg/multiaddonmanager/multiaddonmanager.cfg
```
i dodaj identyfikator do `mm_extra_addons` (poszczególne identyfikatory oddziel przecinkami):
```
mm_extra_addons "3837941466"
```
Jeśli masz już tam inne dodatki, wygląda to tak: `mm_extra_addons "111111111,3837941466"`.
#### Opcja B: Skorzystaj z własnego dodatku do warsztatu
Dla osób, które już publikują własne dodatki:
1. Skopiuj dwa pliki z folderu archiwum `workshop-addon/particles/nox/`do swojego dodatku w lokalizacji
`Counter-Strike Global Offensive/game/csgo_addons/<your_addon>/particles/nox/`.
2. Opublikuj lub zaktualizuj swój dodatek za pomocą **menedżera CS2 Workshop** (narzędzia CS2 Workshop).
3. Dodaj identyfikator swojego dodatku w serwisie Workshop `mm_extra_addons`zgodnie z opcją A.
### Krok 3: Uruchom ponownie
Uruchom ponownie serwer (lub zmień mapę). Gotowe, pada śnieg! ❄️
> **Wskazówka:** przy pierwszym uruchomieniu serwer pobiera dodatek. Jeśli od razu nie widać śniegu,
> Wpisz `mm_download_addon 3837941466` w konsoli serwera i zmień mapę raz.
---
## 🎮 Polecenia
| Polecenie | Kto | Jak to działa |
|---|---|---|
| `!nosnow` | Każdy gracz | Wyłącza śnieg specjalnie dla Ciebie. Wpisz to ponownie, aby go przywrócić. |
| `!snow` | Administratorzy (`@css/generic`) | Włącza lub wyłącza śnieg na całym serwerze (do momentu zmiany mapy). |
Polecenia działają również w `/`trybie cichym oraz w konsoli jako `css_nosnow`/`css_snow`.
---
## ⚙️ Konfiguracja
Konfiguracja jest tworzona automatycznie przy pierwszym uruchomieniu:
```
game/csgo/addons/counterstrikesharp/configs/plugins/SnowFall/SnowFall.json
```
| Ustawienia | Domyślnie | Jak to działa |
|---|---|---|
| `Enabled` | `true` | Śnieg pojawia się po uruchomieniu serwera. |
| `ParticleEffects` | warstwa „blisko + daleko” | Warstwy śniegu. Usuń, aby`particles/nox/snowfall_far.vpcf` uzyskać lżejszy śnieg (tylko wokół gracza). |
| `HeightOffset` | `0` | Przesuwa śnieg w górę/w dół (od -200 do 500). Zazwyczaj warto pozostawić tę wartość na 0. |
| `SnowForSpectators` | `true` | Śnieg dla zmarłych graczy i widzów. |
| `AllowPlayerToggle` | `true` | Umożliwia graczom korzystanie z `!nosnow`. |
| `AdminFlag` | `@css/generic` | Wymagane jest zezwolenie na `!snow`. |
| `ChatPrefix` | `[Snow]` | Przedrostek wiadomości na czacie. |
Przykład:
```json
{
"Enabled": true,
"ParticleEffects": [
"particles/nox/snowfall.vpcf",
"particles/nox/snowfall_far.vpcf"
],
"HeightOffset": 0,
"SnowForSpectators": true,
"AllowPlayerToggle": true,
"AdminFlag": "@css/generic",
"ChatPrefix": " \u0004[Snow]\u0001",
"ConfigVersion": 3
}
```
Po wprowadzeniu zmian w konfiguracji należy zaktualizować mapę (lub ponownie uruchomić serwer).
---
## ⚡ Wydajność
- **Serwer**: tylko 2 małe obiekty na gracza, brak konieczności przetwarzania każdego płatka śniegu z osobna i brak dodatkowego ruchu sieciowego.
- **Gracze**: stała liczba małych śnieżnych duchów (najlżejszy rodzaj efektu w grze). Liczba
nigdy się nie powiększa, niezależnie od liczby graczy i czasu trwania rozgrywki na mapie.
- Gracze korzystający z bardzo słabych komputerów mogą skorzystać z `!nosnow`.
---
## ❓ Często zadawane pytania / Rozwiązywanie problemów
**Nie widzę śladu śniegu.**
1. Sprawdź, czy wtyczka została załadowana: wpisz `css_plugins list` w konsoli serwera i poszukaj
**SnowFall**.
2. Sprawdź, czy `3837941466` (lub identyfikator Twojego dodatku) znajduje się w pliku `mm_extra_addons`.
3. Wpisz `mm_download_addon 3837941466` w konsoli serwera i zmień mapę.
4. Na swoim komputerze: zamknij grę CS2, a następnie w serwisie Steam otwórz pozycję w Warsztacie o numer**ze 3837941466** i kliknij
**Wypisz się**, a następnie **zapisz się** ponownie, aby serwis Steam pobrał najnowszą wersję.
**Czy w budynkach pada śnieg?**
W pomieszczeniach może padać śnieg: płatki śniegu nie zderzają się z otoczeniem. Gracze mogą tę funkcję wyłączyć
jeśli`!nosnow` to im przeszkadza.
**Czy śnieg gromadzi się na ziemi?**
Nie, śnieg jest tylko wizualny.
**Czy mogę to włączyć tylko na święta?**
Tak. Należy to ustawić w`"Enabled": false` pliku konfiguracyjnym lub po prostu usunąć wtyczkę po świętach. Administratorzy
można to również przełączyć na tryb na żywo za pomocą `!snow`.
**Czy będzie to powodować konflikty z innymi wtyczkami?**
Nie. SnowFall generuje wyłącznie własne efekty śnieżne i nie wprowadza żadnych zmian dotyczących graczy, broni ani mapy.
Działa w połączeniu z wtyczkami ChristmasHats, VIP, skinami itp.
---
## 📝 Lista zmian
**1.3.0**
- Nowa warstwa śniegu w oddali: śnieg widoczny z odległości do ~60 m, więc pada na całym obszarze widocznej mapy.
**1.2.0**
- Śnieg opada w sposób naturalny (pod wpływem grawitacji i lekkiego wiatru), a płatki śniegu są mniejsze i realistyczne.
**1.0.0**
- Pierwsze wydanie.
---
Potrzebujesz pomocy? Skontaktuj się z nami za pośrednictwem strony internetowej, na której kupiłeś wtyczkę.