qRoulette

qRoulette to plugin do CounterStrikeSharp, ktory dodaje ruletke dla graczy na serwerze CS2. Gracze moga obstawiac wybrany kolor, a plugin losuje wynik na podstawie szans ustawionych w configu i wyplaca wygrane zgodnie z mnoznikami.

Plugin obsluguje kilka rodzajow waluty:

• standardowe pieniadze CS2,
• walute z qShop,
• respect z qJailbreak,
• punkty rankingu z qProRanks.

Dodatkowo plugin moze opcjonalnie zapisywac statystyki graczy w bazie MySQL.

Funkcje

• obstawianie przez komende czatu / konsoli,
• kilka aliasow komendy ustawianych w configu,
• losowanie na podstawie wag chance,
• osobne mnozniki dla kazdego koloru,
• obsluga komunikatow na chacie i hintach,
• mozliwosc ograniczenia, kto moze korzystac z ruletki,
• opcjonalny zapis statystyk do MySQL,
• wsparcie dla qShop, qJailbreak i qProRanks.

Instalacja

1. Umiesc qRoulette.dll w addons/counterstrikesharp/plugins/qRoulette/.
2. Umiesc pliki jezykowe w addons/counterstrikesharp/plugins/qRoulette/lang/.
3. Umiesc config w addons/counterstrikesharp/configs/Qesik/Roulette.json.
4. Umiesc zaleznosci z folderu shared w addons/counterstrikesharp/shared/.
5. Zrestartuj serwer albo przeladuj plugin.

Minimalny uklad plikow po instalacji:

• addons/counterstrikesharp/plugins/qRoulette/qRoulette.dll
• addons/counterstrikesharp/plugins/qRoulette/lang/...
• addons/counterstrikesharp/configs/Qesik/Roulette.json
• addons/counterstrikesharp/shared/...

Uzywanie

Domyslne aliasy komendy to:

• css_obstaw
• css_bet
• css_ruletka
• css_roulette

Przykladowe uzycie:

css_roulette 500 red
css_bet 100 black
css_ruletka 250 zielony

Pierwszy argument to kwota, a drugi to alias koloru zdefiniowany w configu.

Konfiguracja

Plik konfiguracyjny:

addons/counterstrikesharp/configs/Qesik/Roulette.json

Przykladowy config:

{
  "Database": {
    "Hostname": "hostname",
    "Database": "database",
    "UserName": "username",
    "Password": "password"
  },
  "Commands": [ "css_obstaw", "css_bet", "css_ruletka", "css_roulette" ],
  "Main": {
    "EnableRanking": false,
    "ModType": 0,
    "Currency": 0,
    "BetTime": 60.0,
    "BetCooldown": 0,
    "BetMinValue": 1,
    "BetMaxValue": 10000,
    "RepeatTime": 0.0,
    "DisconnectReturn": true,
    "AnnounceAll": true,
    "PlayerStatus": 0,
    "WinInfo": {
      "Chat": true,
      "Hint": true,
      "CenterHtml": true
    }
  },
  "Color": [
    {
      "lang": "colorRed",
      "chance": 35,
      "multiplier": 2.0,
      "alias": [ "red", "czerwony" ]
    },
    {
      "lang": "colorBlack",
      "chance": 35,
      "multiplier": 2.0,
      "alias": [ "black", "czarny" ]
    }
  ]
}

Opis opcji configu

Database

Sekcja uzywana tylko wtedy, gdy EnableRanking jest wlaczone.

• Hostname - adres serwera MySQL.
• Database - nazwa bazy danych.
• UserName - nazwa uzytkownika bazy.
• Password - haslo do bazy.

Commands

Lista aliasow komendy, pod ktorymi gracze moga obstawiac ruletke. Kazdy wpis jest rejestrowany jako osobna komenda.

Main

• EnableRanking false - bez bazy danych i bez zapisu statystyk. true - plugin zapisuje statystyki graczy w MySQL.

• ModType 0 - ruletka startuje na poczatku rundy i konczy sie po uplywie BetTime albo wraz z zakonczeniem rundy. 1 - ruletka dziala w petli czasowej: po zakonczeniu losowania odczekuje BetCooldown, a potem startuje ponownie. 2 - plugin uruchamia pierwsze okno obstawiania automatycznie po zaladowaniu configu. To ustawienie warto przetestowac na swoim serwerze razem z wybranym stylem rozgrywki.

• Currency 0 - pieniadze CS2, 1 - waluta z qShop, 2 - respect z qJailbreak, 3 - punkty rankingu z qProRanks.

• BetTime Czas w sekundach, przez jaki gracze moga obstawiac.

• BetCooldown Przerwa pomiedzy kolejnymi losowaniami przy ModType = 1.

• BetMinValue Minimalna wartosc zakladu.

• BetMaxValue Maksymalna wartosc zakladu. Ustaw 0, jesli nie chcesz limitu gornego.

• RepeatTime Pole obecne w configu, ale w aktualnym dzialaniu pluginu nie ma praktycznego zastosowania.

• DisconnectReturn Jesli true, gracz po wyjsciu z serwera odzyskuje postawiony zaklad, o ile ruletka nie zostala jeszcze rozliczona.

• AnnounceAll true - wszyscy uprawnieni gracze widza informacje o postawionym zakladzie. false - informacje o postawieniu zakladu widzi tylko obstawiajacy gracz.

• PlayerStatus 0 - wszyscy gracze moga korzystac z ruletki, 1 - tylko zywi gracze, 2 - tylko martwi gracze.

WinInfo

• Chat - pokazuje wynik losowania na chacie.
• Hint - pokazuje wynik jako hint / center text.
• CenterHtml Pole istnieje w configu, ale w aktualnej wersji pluginu nie jest wykorzystywane do osobnego trybu wyswietlania.

Color

Lista dostepnych kolorow do obstawiania.

• lang - klucz koloru w plikach jezykowych.
• chance - waga uzywana podczas losowania.
• multiplier - mnoznik wygranej dla danego koloru.
• alias - lista nazw, ktorych gracz moze uzyc przy obstawianiu.

Im wieksza wartosc chance, tym wieksza szansa na wylosowanie danego koloru.

Przyklad konfiguracji waluty

Pieniadze CS2

"Currency": 0

qShop

"Currency": 1

qJailbreak

"Currency": 2

qProRanks

"Currency": 3

Uwagi

• Jesli wlaczasz EnableRanking, uzupelnij poprawnie dane MySQL przed startem pluginu.
• Jesli korzystasz z qShop, qJailbreak lub qProRanks, upewnij sie, ze odpowiadajacy plugin jest zaladowany na serwerze.
• Po zmianach struktury configu najlepiej porownac swoj plik z aktualnym wzorem i zaktualizowac go w calosci.