qVIP

qVIP to plugin dla CounterStrikeSharp do Counter-Strike 2, który pozwala zbudować własny system VIP oparty o role, permisje i konfigurację JSON.

Plugin obsługuje klasyczne role VIP, losowego darmowego VIP-a, nocnego VIP-a, bonusy za rundy i zabójstwa, dodatkowe wyposażenie oraz funkcje specjalne takie jak doublejump czy kolorowe smoke.

Funkcje

• Dowolna liczba ról VIP w jednej konfiguracji
• Role przydzielane na podstawie permisji CounterStrikeSharp
• Losowy VIP raz na mapę
• Nocny VIP aktywny w wybranych godzinach i dniach
• Doublejump z możliwością włączenia lub wyłączenia przez gracza
• Bonusy do HP, armora, pieniędzy, prędkości i grawitacji
• Dodatkowe granaty, healthshoty, taser i defuse kit
• Wiadomości powitalne i tagi w tabeli wyników
• Pliki językowe pl, en, cs, ua

Instalacja

1. Wrzuć paczkę z plikami do csgo.
2. Skonfiguruj plugin.
3. Zrestartuj serwer bądź przeładuj plugin.

Komendy gracza

• !dj lub !doublejump - przełącza własny doublejump, jeśli funkcja jest włączona w configu
• !nightvip lub !nocnyvip - aktywuje nocnego VIP-a, jeśli NightVip.Command = true

Konfiguracja

Główny plik konfiguracyjny:

addons/counterstrikesharp/configs/Qesik/Vip.json

Struktura pliku:

{
  "RandomVip": { },
  "NightVip": { },
  "Doublejump": { },
  "Role": [ ]
}

RandomVip

Sekcja odpowiada za darmowego VIP-a losowanego raz na mapę.

"RandomVip": {
  "RoleId": 2,
  "NameTag": "Qesik",
  "Round": 3,
  "AddPermissions": [ "@qShowDamage/permission" ]
}

Pola:

• RoleId - numer roli z sekcji Role, która zostanie nadana wylosowanemu graczowi
• NameTag - opcjonalny fragment nicku wymagany do udziału w losowaniu
• Round - od której rundy plugin może rozpocząć losowanie
• AddPermissions - dodatkowe permisje nadawane razem z rolą losowego VIP-a

NightVip

Sekcja odpowiada za VIP-a aktywnego w określonych godzinach i dniach.

"NightVip": {
  "RoleId": 2,
  "Hours": [22, 8],
  "DayNum": [0, 6],
  "Command": true,
  "NameTag": "Qesik",
  "InfoToAll": true,
  "AddPermissions": [ "@qShowDamage/permission" ]
}

Pola:

• RoleId - numer roli z sekcji Role, używanej przez nocnego VIP-a
• Hours - zakres godzin w formacie 24h; jeśli koniec jest mniejszy lub równy początkowi, zakres przechodzi przez północ
• DayNum - lista dozwolonych dni tygodnia; 0 = niedziela
• Command - true oznacza aktywację przez komendę gracza, false oznacza nadawanie automatyczne
• NameTag - opcjonalny fragment nicku wymagany do aktywacji
• InfoToAll - czy po aktywacji ogłaszać to wszystkim graczom
• AddPermissions - dodatkowe permisje nadawane razem z nocnym VIP-em

Doublejump

Sekcja steruje komendą gracza do przełączania doublejump.

"Doublejump": {
  "Commands": true
}

Pola:

• Commands - włącza lub wyłącza komendy !dj i !doublejump

Role

Sekcja Role zawiera listę wszystkich ról VIP. Kolejność ma znaczenie, bo RoleId odwołuje się właśnie do pozycji w tej tablicy.

Przykład:

{
  "Name": "SVIP",
  "Permission": "@qVip/svip",
  "ScoreTag": "[SVIP]",
  "Doublejump": 2,
  "Defuse": true,
  "Gravity": 1.0,
  "Speed": 0.05,
  "MaxMoney": 20000,
  "FallDamage": 0.5,
  "ColorSmoke": false,
  "HealthShotBoostEffect": 3.0,
  "StartHealthRound": 2,
  "StartHealth": 130,
  "MaxHealth": 130,
  "StartArmorRound": 2,
  "StartArmor": 100,
  "HelmetRound": 2,
  "Helmet": true,
  "ExcludePermission": "@css/ban",
  "WelcomeMsg": "qvip.chat.welcomeSVip",
  "GrenadesRound": 2,
  "AddHegrenade": true,
  "AddDecoy": true,
  "AddSmokegrenade": true,
  "AddMolotov": true,
  "AddFlashbang": 1,
  "HealthshotRound": 2,
  "AddHealthshot": 1,
  "TaserRound": 2,
  "AddTaser": true,
  "Money": {
    "RoundStart": 500,
    "RoundEnd": 300,
    "Assist": 150,
    "Death": 150,
    "Kill": 200,
    "KillHs": 150
  },
  "Health": {
    "Assist": 1,
    "Kill": 3,
    "KillHs": 2
  }
}

Opis pól:

• Name - nazwa roli używana organizacyjnie w configu
• Permission - permisja CounterStrikeSharp wymagana do otrzymania roli
• ScoreTag - tag wyświetlany w scoreboardzie
• Doublejump - liczba dodatkowych skoków
• Defuse - czy dawać CT zestaw do rozbrajania
• Gravity - mnożnik grawitacji
• Speed - dodatkowy mnożnik prędkości ruchu; 0.05 to około +5%
• MaxMoney - maksymalna ilość pieniędzy dla tej roli
• FallDamage - mnożnik obrażeń od upadku
• ColorSmoke - czy smoke rzucane przez gracza mają być kolorowe
• HealthShotBoostEffect - czas trwania efektu healthshot po zabójstwie
• StartHealthRound - od której rundy przyznawać startowe HP
• StartHealth - ilość HP na start
• MaxHealth - maksymalny limit HP
• StartArmorRound - od której rundy przyznawać startowy armor
• StartArmor - ilość pancerza na start
• HelmetRound - od której rundy przyznawać hełm
• Helmet - czy przyznawać hełm
• ExcludePermission - gracze z tą permisją nie zobaczą wiadomości powitalnej
• WelcomeMsg - klucz tłumaczenia wiadomości powitalnej; ustaw null, aby ją wyłączyć
• GrenadesRound - od której rundy rozdawane są granaty z tej sekcji
• AddHegrenade - dodaje HE
• AddDecoy - dodaje decoy
• AddSmokegrenade - dodaje smoke
• AddMolotov - dodaje molotov
• AddFlashbang - docelowa liczba flashbangów po spawnie
• HealthshotRound - od której rundy rozdawane są healthshoty
• AddHealthshot - docelowa liczba healthshotów
• TaserRound - od której rundy rozdawany jest taser
• AddTaser - czy dodawać taser
• Money.RoundStart - bonus pieniędzy na start rundy
• Money.RoundEnd - bonus pieniędzy na koniec rundy
• Money.Assist - bonus za asystę
• Money.Death - bonus za śmierć
• Money.Kill - bonus za zabójstwo
• Money.KillHs - dodatkowy bonus za headshota
• Health.Assist - ile HP odzyskać za asystę
• Health.Kill - ile HP odzyskać za zabójstwo
• Health.KillHs - dodatkowe HP za headshota

Przykład pełnego configu

{
  "RandomVip": {
    "RoleId": 2,
    "NameTag": "Qesik",
    "Round": 3,
    "AddPermissions": [ "@qShowDamage/permission", "@css/custom_customa" ]
  },
  "NightVip": {
    "RoleId": 2,
    "Hours": [ 22, 8 ],
    "DayNum": [ 0, 6 ],
    "Command": true,
    "NameTag": "Qesik",
    "InfoToAll": true,
    "AddPermissions": [ "@qShowDamage/permission", "@css/custom_customa" ]
  },
  "Doublejump": {
    "Commands": true
  }
}

Permisje

Role są przydzielane na podstawie permisji ustawionych w polu Permission.

Przykłady:

• @qVip/vip
• @qVip/svip

Jeśli gracz spełnia warunki kilku ról, plugin korzysta z kolejności wpisów w Role.

Języki

Folder lang/ zawiera gotowe tłumaczenia:

• pl.json
• en.json
• cs.json
• ua.json

Możesz edytować istniejące pliki albo dodać własne tłumaczenie.

Wskazówki

• RoleId zawsze odnosi się do pozycji w tablicy Role, zaczynając od 1
• jeśli WelcomeMsg ma być wyłączone, użyj null
• jeśli NameTag ma nie być wymagany, ustaw pusty tekst
• jeśli NightVip.Command = false, nocny VIP może być nadawany automatycznie
• bonusy rundowe zaczną działać dopiero od rund ustawionych w odpowiednich polach