Atkvæðislaun

Voting Check

Hvernig þú verðlaunar spilara eftir að þeir kjósa árangursríkt fyrir skráninguna þína á JoinGameServers.

Opna stjórnborð Hvernig þetta virkar

Uppsetningarleið: Stjórnborð → Breyta server → Vote Rewards (og Minecraft-upplýsingar fyrir Votifier).

01

Hvernig þetta virkar

  1. Spilari opnar atkvæða-tengilinn þinn, helst með ?p=USERNAME svo formið sé forútfyllt.

  2. Hann sendir inn atkvæðið. Við framfylgjum 24 klukkustunda biðtíma á IP (og á innskráðan aðgang). Ef verðlaun eru stillt er notandanafn / færibreyta nauðsynleg.

  3. Við látum verðlaunakerfin þín vita: HTTP GET á postback-slóðina þína og/eða Votifier-pakka á Minecraft-hýsilinn þinn — með sömu færibreytu og IP kjósandans.

  4. Þú veitir verðlaunin. Afhendingarbilanir á þinni hlið eru skráðar hér en fjarlægja ekki atkvæðið.

Veldu aðferð

HTTP Postback

Best fyrir vefsíður, launchers og leiki sem eru ekki Minecraft. Fyrir Minecraft er þetta valfrjáls valkostur við Votifier (eða viðbót ef þú verðlaunar líka á vefsíðu).

  • Virkar fyrir alla leiki á þessum lista
  • Þú stýrir punktum, biðtíma og skráningu
  • Þarf opinberan HTTPS-enda
Postback PHP →
Best fyrir Minecraft

Minecraft Votifier

Æskilegt fyrir Minecraft. Best fyrir crates, keys og listener-plugins í leik. Við opnum TCP-tengingu á Votifier-portið þitt.

  • Aðeins Minecraft-skráningar
  • Classic RSA eða NuVotifier v2 tákn
  • Þarf opið port + firewall-leyfislista
Minecraft Votifier →

Fyrir Minecraft, notaðu Votifier fyrst. HTTP postback er valfrjálst (eða viðbótar). Hver virkur rás keyrir sjálfstætt eftir atkvæðið.

Fljótleg byrjun

  1. Skráðu þig inn og opnaðu stjórnborðið.
  2. Breyttu samþykktri serveraskráningu þinni.
  3. Settu postback-slóð og/eða virkjaðu Votifier undir Minecraft-upplýsingum.
  4. Afritaðu hvatningartengilinn úr breytingareyðublaðinu (endar á ?p=USERNAME).
  5. Settu þann tengil á vefsíðuna þína eða Discord; skiptu út USERNAME fyrir hvern spilara.
  6. Kastaðu prófatkvæði og staðfestu að verðlaun berist.
02

Postback PHP

Eftir árangursríkt atkvæði biðjum við um slóðina þína með færibreytu spilarans og IP þeirra. Skriftan þín merkir þann aðgang sem hafa kosið og veitir punkta eða hluti.

Settu opinbera útleiðandi IP þessarar vefsíðu á whitelist í firewall og postback-skriftunni. Hafnaðu öllum öðrum uppruna. Kýstu HTTPS.

1. Settu postback-slóðina þína

Stjórnborð → Breyta server → Vote Rewards → Postback-slóð.

https://YOURDOMAIN/postback.php
  • Skráarnafnið er valfrjálst — notaðu hvaða slóð sem stackinn þinn kýs.
  • Aðeins opinberar http/https-slóðir eru samþykktar. Localhost, einkarekin LAN-IP og URL-auðkenni eru hafnað (SSRF-vörn).
  • Við fylgjum fáum redirectum og tímunum út eftir nokkrar sekúndur svo kosningin haldist hröð.

2. Búðu til hvatningartengla

Bættu við færibreytu svo hver spilari sé auðkenndur þegar hann lendir á atkvæðasíðunni.

/GAME/server/SLUG/vote?p=PARAMETER
Hluti Reglur
PARAMETER / p_resp Aðeins stafir, tölustafir, _, - · hámark 32 stafir · notandanafn, aðgangs-auðkenni eða annað auðkenni sem þú fylgist með
ip IPv4 eða IPv6 kjósandans eins og listinn sér það (proxy-meðvitað þegar virkt)
Forútfyllingar-query ?p= eða ?username=

3. Hvað við köllum eftir atkvæði

Aðeins við árangur. Ef spilarinn lauk ekki gildu atkvæði sendum við enga beiðni.

https://YOURDOMAIN/postback.php?p_resp=PARAMETER&ip=USERIP
Hvatningartengill Callback okkar
/minecraft-server/server/your-server-slug/vote?p=1234 …/postback.php?p_resp=1234&ip=123.123.123.123
/minecraft-server/server/your-server-slug/vote?p=Razor …/postback.php?p_resp=Razor&ip=123.123.123.123

Þegar við höfum samband við postback þinn með p_resp=Razor hefur spilarinn Razor kosið. ip-gildið er vistfangið sem hann notaði á þessum lista.

Hvað skriftan þín ætti að gera

  • Staðfestu að beiðnin komi frá opinberu IP þessa lista.
  • Hreinsaðu p_resp og ip (treystu aldrei hráu inntaki).
  • Staðfestu að aðgangur / character sé til í gagnagrunninum þínum.
  • Notaðu eigin biðtíma fyrir verðlaun ef þú þarft eitthvað strangara en 24 klukkustundir.
  • Veittu punkta, coins eða hluti; skráðu atburðinn; skilaðu HTTP 200.

postback.php dæmi

Hýstu þetta á verðlaunasíðunni þinni, ekki endilega á þessum atkvæðalista. Settu VOTE_LIST_IP á útleiðandi opinbert IP þessarar vefsíðu áður en þú ferð live.

<?php
/**
 * Example vote postback receiver for YOUR game website / CMS.
 *
 * Configure this URL on your listing under Dashboard → Edit server → Vote Rewards.
 * This list will call it ONLY after a successful vote:
 *
 *   https://yoursite.com/postback.php?p_resp=PARAMETER&ip=USERIP
 *
 * PARAMETER is the username / account id the player entered on the vote form
 * (or the value from ?p= on your incentive voting link).
 *
 * Docs: /voting-check
 */

define('DEBUG', 0); // set to 1 to write _postback.log
define('LOG_FILE', __DIR__ . '/_postback.log');

/**
 * Only accept callbacks from the vote list's public IP.
 * Leave empty to skip the allowlist (not recommended in production).
 *
 * Example: define('VOTE_LIST_IP', '203.0.113.10');
 */
define('VOTE_LIST_IP', '');

$ipRequest = $_SERVER['HTTP_CF_CONNECTING_IP']
    ?? (isset($_SERVER['HTTP_X_FORWARDED_FOR'])
        ? trim(explode(',', (string) $_SERVER['HTTP_X_FORWARDED_FOR'])[0])
        : null)
    ?? $_SERVER['REMOTE_ADDR']
    ?? '';
$ipRequest = trim((string) $ipRequest);

if (VOTE_LIST_IP !== '' && $ipRequest !== VOTE_LIST_IP) {
    if (DEBUG) {
        error_log(date('[Y-m-d H:i] ') . "[Invalid] Request from {$ipRequest}" . PHP_EOL, 3, LOG_FILE);
    }
    http_response_code(403);
    exit('Forbidden');
}

if (DEBUG) {
    error_log(date('[Y-m-d H:i] ') . "[OK] Valid callback: {$ipRequest}" . PHP_EOL, 3, LOG_FILE);
}

// Clean parameters from the vote list (letters, numbers, underscore, hyphen).
$p = preg_replace('/[^A-Za-z0-9_\-]+/', '', (string) ($_GET['p_resp'] ?? '')) ?? '';
$userIp = preg_replace('/[^0-9a-fA-F:\.]+/', '', (string) ($_GET['ip'] ?? '')) ?? '';

if ($p === '') {
    http_response_code(400);
    exit('Missing p_resp');
}

if (DEBUG) {
    error_log(date('[Y-m-d H:i] ') . "[GET] Parameters [p_resp]={$p} [ip]={$userIp}" . PHP_EOL, 3, LOG_FILE);
}

// ---------------------------------------------------------------------------
// Connect to your database, verify account $p exists, enforce your own
// cooldown if needed, then grant vote points / items to $p (voted from $userIp).
// We send p_resp + ip ONLY when that player successfully voted on the list.
// ---------------------------------------------------------------------------

http_response_code(200);
echo 'OK';
03

Minecraft Votifier

Við getum þrýst atkvæðinu beint inn á Minecraft-serverinn þinn. Listener-plugin keyrir síðan verðlaunaskipunum þínum.

Firewall: leyfðu innkomandi TCP frá opinberu IP þessarar vefsíðu á Votifier-portið þitt (sjálfgefið 8192). Ekki opna portið fyrir allt internetið ef þú getur forðast það.

  1. Spilari slær inn Minecraft-notandanafnið sitt á atkvæðasíðunni okkar (eða kemur via ?p=Steve).

  2. Atkvæði tekst á þessum lista.

  3. Við tengjumst Votifier-hýsli/porti þínu og afhendum atkvæðispakkann.

  4. Listenerinn þinn veitir crates, keys, peninga o.s.frv.

Virkjaðu Votifier undir Minecraft-upplýsingum, veldu NuVotifier v2 eða Classic, og sláðu síðan inn hýsil, port og tákn eða RSA-opinberan lykil.

Settu upp NuVotifier (classic RSA og protocol v2) eða classic Votifier, auk listener fyrir Minecraft-útgáfuna þína (GAListener, SuperbVote eða sérsniðinn listener).

Classic / v1: límdu alla public.key-skrána. Hýsill og port koma úr config.yml. Hafðu debug: true meðan þú tengir þennan lista, slökktu síðan.

host: YOUR_PUBLIC_IP
port: 8192
debug: true

Pakkar auðkenna þennan lista sem: JoinGameServers

04

NuVotifier v2

Protocol v2 skiptir RSA út fyrir sameiginlegt tákn og einnota challenge. Tengdu tákn við þjónustunafn þessa lista, eða notaðu sjálfgefna táknið.

tokens:
  default: REPLACE_WITH_DEFAULT_TOKEN
  "JoinGameServers": REPLACE_WITH_LIST_TOKEN

Wire-snið: TCP-tenging → lesa kveðju VOTIFIER 2 <challenge> → JSON-payload (username, serviceName, timestamp ms, address, challenge) → Base64(HMAC-SHA256(payload, token)) → magic 0x733A + length + JSON {signature, payload}. Bústu við {"status":"ok"}.

Einkenni Líkleg orsök
Ekki NuVotifier v2-server Kveðja hefur ekkert challenge — notaðu Classic, eða uppfærðu NuVotifier og virkjaðu v2.
Ógild undirskrift / óþekkt þjónusta Rangt tákn, eða þjónustunafn ekki tengt. Bættu við þjónustunafni listans eða notaðu sjálfgefið.
Tenging mistókst / tímaút Rangt hýsill/port, Votifier offline, eða firewall hindrar IP þessa lista.
Ekkert svar Proxy/plugin truflun; virkjaðu NuVotifier debug og reyndu aftur.
05

Prófunarlisti

  1. Vistaðu stillingar skráningar án staðfestingarvillna.
  2. Opnaðu hvatningartengil — notandanafnsreiturinn ætti að forútfyllast úr ?p=.
  3. Kastaðu einu atkvæði. Þú ættir að sjá árangursstöðu. Annað atkvæði innan 24 klukkustunda verður að vera hindrað.
  4. Staðfestu postback: virkjaðu DEBUG í móttökunni þinni; staðfestu að p_resp og ip berist.
  5. Staðfestu Votifier: með debug true ætti Minecraft-console að sýna innkomandi atkvæði fyrir notandanafnið þitt og þjónustunafn þessa lista.
  6. Staðfestu verðlaun í leik eða á síðu. Ef ekki, lagaðu listenerinn — atkvæðið á listanum telst samt.

Afhendingartilraunir eru skráðar í vote_reward_logs (ok / fail / skipped). Misheppnaður callback rúllar aldrei atkvæðið til baka á þessum lista.

06

Algengar spurningar og bilanaleit

Nei. Gestir geta kosið. Innskráðir aðgangar deila sömu 24 klukkustunda biðtímalögum til að koma í veg fyrir misnotkun.

Ef þú stilltir postback-slóð eða Votifier þurfum við færibreytu til að segja þér hverjum á að verðlauna. Án stilltra verðlauna er notandanafn valfrjálst.

Já. Bæði keyra eftir árangursríkt atkvæði. Bilanir eru óháðar.

Hún þarf að vera opinber http(s)-slóð. Localhost, .local, einkarekin IP (t.d. 10.*, 192.168.*) og slóðir með innbyggðum auðkennum eru hindruð.

Staðfestu að atkvæðið hafi tekist á þessum lista. Athugaðu postback-skrárnar þínar eða NuVotifier debug-úttak. Staðfestu firewall-leyfislista og að notandanafnið passi við aðgang í leik. Biðtími listans er 24 klukkustundir; eigin biðtími verðlauna getur verið annar.

Aðeins A–Z, a–z, 0–9, _ og -. Allt annað er fjarlægt. Haltu færibreytum ≤ 32 stafi.