+ Pridėti serverį Prisijungti Registruotis
Savininkams

Prizai už balsus

Kai žaidėjas prabalsuoja už tavo serverį, jis gali automatiškai gauti prizą žaidime – raktą, pinigų, daiktą ar bet ką kitą. Tai nebūtina: serveris tope veikia ir be prizų, bet su jais žaidėjai balsuoja kur kas dažniau.

MinecraftNuVotifier (rekomenduojama) arba Votifier FiveMParuoštas resursas su /balsuoti CS2RCON komanda – be papildomų įskiepių Kita / programuotojamsWebhook (HTTP POST)

Minecraft: NuVotifier (rekomenduojama)

NuVotifier – populiariausias įskiepis, per kurį topai praneša serveriui apie balsą. Jis veikia su Spigot, Paper, Purpur, BungeeCord ir Velocity.

  1. Parsisiųsk NuVotifier (SpigotMC arba Modrinth) ir įmesk į plugins aplanką. Perkrauk serverį.
  2. Atsidaryk plugins/Votifier/config.yml (Velocity – plugins/nuvotifier/config.yml). Ten rasi:
    host: 0.0.0.0
    port: 8192
    tokens:
      default: abc123tavo-tokenas
  3. Įsitikink, kad prievadas 8192 (TCP) atidarytas. Jei serveris pas hostingo tiekėją, paprastai reikia jų panelėje pridėti papildomą prievadą (angl. additional port / allocation) ir jį įrašyti į port:.
  4. TopServeriai.lt → Mano serveriai → Redaguoti → Prizai už balsus:
    • Būdas: NuVotifier v2 (Minecraft, token)
    • Votifier adresas: serverio IP ar domenas (galima palikti tuščią – bus naudojamas serverio adresas)
    • Prievadas: 8192 (arba tas, kurį nurodei)
    • Raktas: tokenas iš tokens → default
  5. Išsaugok ir spausk „Siųsti bandomąjį balsą (TestUser)“. Jei viskas gerai, serverio konsolėje pamatysi gautą balsą (įjunk debug: true config.yml, jei nieko nerodo).
Svarbu: NuVotifier tik priima balsą. Pačiam prizui išduoti reikia prizų įskiepio, pvz. VotingPlugin arba SuperbVote. Juose balsavimo svetainės pavadinimas (service) turi būti TopServeriai.lt.

BungeeCord / Velocity tinklas: NuVotifier įdiek proxy serveryje ir įjunk forwarding į žaidimo serverius (arba įdiek jį tiesiai tame serveryje, kuriame dalinami prizai). TopServeriai.lt nurodyk proxy adresą.

Minecraft: senas Votifier (v1, viešasis raktas)

Jei naudoji klasikinį Votifier (arba NuVotifier su išjungtais tokenais):

  1. Atsidaryk plugins/Votifier/rsa/public.key ir nukopijuok visą turinį (ilga raidžių eilutė).
  2. TopServeriai.lt pasirink būdą Votifier v1 (Minecraft, viešasis raktas), įrašyk adresą, prievadą (iš config.yml, numatytasis 8192) ir įklijuok raktą.
  3. Išsaugok ir išsiųsk bandomąjį balsą.

Dažniausios klaidos

  • „Nepavyko prisijungti“ / timeout – neatidarytas prievadas arba neteisingas adresas. Patikrink hostingo panelėje papildomus prievadus ir ugniasienę.
  • Balsas ateina, bet prizo nėra – nėra prizų įskiepio arba jame neteisingas service pavadinimas (turi būti TopServeriai.lt).
  • „Bad token“ / „Unknown service“ – neteisingai nukopijuotas tokenas. Kopijuok be tarpų ir kabučių.

FiveM: paruoštas resursas „topserveriai_vote“

Nereikia atidarinėti prievadų ar rašyti kodo. Resursas pats klausia TopServeriai.lt, ar žaidėjas balsavo, ir išduoda prizą. Veikia su ESX, QBCore, Qbox, ox_inventory arba be karkaso (per komandas).

  1. TopServeriai.lt → Mano serveriai → Redaguoti → Prizai už balsus → būdas „FiveM resursas – /balsuoti“ → išsaugok.
  2. Spausk „Atsisiųsti resursą (.zip)“. Tavo API raktas jau bus įrašytas viduje.
  3. Išarchyvuok ir įkelk aplanką topserveriai_vote į serverio resources aplanką.
  4. Atsidaryk config.lua ir pasirink prizą:
    Config.Reward = {
      money = 5000,        -- pinigai
      account = 'bank',   -- 'bank' arba 'cash'
      items = { { name = 'bread', count = 2 } },
      commands = { 'givecar {id} adder' },
    }
  5. Į server.cfg pridėk (po es_extended / qb-core / ox_inventory eilučių):
    ensure topserveriai_vote
  6. Perkrauk serverį. Konsolėje turi pasirodyti [TopServeriai] Prisijungta prie TopServeriai.lt, o redagavimo puslapyje – „Resurso būsena: prisijungęs“.

Kaip tai veikia žaidėjams

  • Žaidėjas prabalsuoja svetainėje, įrašęs savo FiveM vardą, ir žaidime parašo /balsuoti. Jei balsavo kitu vardu – /balsuoti Vardas.
  • Jei Config.AutoCheck = true, prizas prisijungusiam žaidėjui išduodamas automatiškai per minutę, net neparašius komandos.
  • Vienas balsas = vienas prizas. Atsiimtas balsas pažymimas, todėl to paties prizo dukart gauti negalima. Neatsiimti balsai galioja 24 val.

Dažniausios klaidos

  • „Neteisingas API raktas“ – raktas pakeistas arba nukopijuotas ne visas. Parsisiųsk resursą iš naujo.
  • „Neatsiimtų balsų nerasta“ – žaidėjas balsavo kitu vardu arba prizą jau atsiėmė. Tegu bando /balsuoti VardasIšSvetainės.
  • Pinigai neateina – Config.Framework nustatyk ranka ('esx', 'qb', 'qbx') ir patikrink account pavadinimą.

Webhook (programuotojams)

Kiekvieno balso metu TopServeriai.lt siunčia POST užklausą į tavo nurodytą adresą su JSON:

{"server_id": 12, "nickname": "Jonas", "ip": "1.2.3.4", "timestamp": 1760000000, "service": "TopServeriai.lt"}

Antraštėje X-Signature – HMAC-SHA256 parašas (hex) nuo viso užklausos turinio, pasirašytas tavo slaptu raktu (jį rasi serverio redagavimo puslapyje). Visada patikrink parašą:

$body = file_get_contents('php://input');
$sig = hash_hmac('sha256', $body, 'TAVO_SLAPTAS_RAKTAS');
if (!hash_equals($sig, $_SERVER['HTTP_X_SIGNATURE'] ?? '')) { http_response_code(403); exit; }
$vote = json_decode($body, true); // išduok prizą $vote['nickname']

Adresas turi būti viešai pasiekiamas per http:// arba https://. Atsakyk HTTP 200 per 4 sekundes.

CS2: RCON komanda (paprasčiausia)

Nieko papildomai diegti nereikia. Kai žaidėjas prabalsuoja, TopServeriai.lt per RCON prisijungia prie tavo serverio ir įvykdo tavo nurodytą komandą – pvz. duoda kreditų per Store įskiepį arba parašo padėką chat'e.

  1. Serverio server.cfg faile nustatyk RCON slaptažodį (sugalvok ilgą ir unikalų):
    rcon_password "IlgasSlaptazodis2026"
  2. Į serverio paleidimo parametrus pridėk -usercon (be jo CS2 RCON neveikia). Daugumos hostingų panelėje tai „Startup / Launch parameters“ laukelis.
  3. RCON naudoja tą patį prievadą kaip žaidimas (pvz. 27015), tik TCP. Dažniausiai jis jau atidarytas.
  4. TopServeriai.lt → Mano serveriai → Redaguoti → Prizai už balsus → būdas „CS2 – RCON komanda“:
    • RCON slaptažodis – tas pats, kaip server.cfg
    • Prievadas ir adresas – palik tuščius, jei sutampa su serverio adresu
    • Komanda už balsą – kiekviena naujoje eilutėje, {name} pakeičiamas žaidėjo vardu
  5. Išsaugok ir spausk „Siųsti bandomąjį balsą (TestUser)“. Matysi, ar komanda įvykdyta.

Komandų pavyzdžiai (tikslus pavadinimas priklauso nuo tavo įskiepio – pasitikrink jo aprašyme):

css_givecredits {name} 100
say {name} prabalsavo už serverį ir gavo 100 kreditų!
Svarbu: prizą žaidėjas gauna tik jei balsuodamas yra prisijungęs prie serverio ir svetainėje įrašo tikslų savo žaidimo vardą. Rekomenduok žaidėjams balsuoti būnant serveryje (pvz. per Steam naršyklę Shift+Tab).

Dažniausios klaidos

  • „RCON neatsakė“ – serveris paleistas be -usercon arba TCP prievadas uždarytas.
  • „Neteisingas RCON slaptažodis“ – slaptažodis nesutampa su server.cfg (po pakeitimo perkrauk serverį).
  • Komanda įvykdyta, bet prizo nėra – žaidėjas nebuvo serveryje, įrašė kitokį vardą arba įskiepio komanda kitokia.

RCON slaptažodį saugome tik tam, kad galėtume įvykdyti tavo nurodytas komandas, ir niekur jo nerodome.

Kyla klausimų? Rašyk info@topserveriai.lt – padėsime prijungti.