Ανταμοιβές ψήφου
Πώς ανταμείβεις παίκτες αφού ψηφίσουν επιτυχώς την καταχώρησή σου στο JoinGameServers.
Διαδρομή ρύθμισης: Πίνακας ελέγχου → Επεξεργασία server → Vote Rewards (και Λεπτομέρειες Minecraft για Votifier).
Ο παίκτης ανοίγει τον σύνδεσμο ψήφου σου, ιδανικά με ?p=USERNAME ώστε η φόρμα να είναι προ συμπληρωμένη.
Υποβάλλει την ψήφο. Εφαρμόζουμε cooldown 24 ωρών ανά IP (και ανά συνδεδεμένο λογαριασμό). Αν έχουν ρυθμιστεί rewards, απαιτείται το όνομα χρήστη / παράμετρος.
Ειδοποιούμε τα συστήματα rewards σου: HTTP GET στο postback URL σου και/ή πακέτο Votifier στο Minecraft host σου — με την ίδια παράμετρο και το IP του ψηφοφόρου.
Εσύ δίνεις το reward. Αποτυχίες παράδοσης από τη μεριά σου καταγράφονται εδώ αλλά δεν αφαιρούν την ψήφο.
Καλύτερο για ιστοσελίδες, launchers και παιχνίδια εκτός Minecraft. Για Minecraft είναι προαιρετική εναλλακτική του Votifier (ή επιπλέον αν ανταμείβεις και σε ιστοσελίδα).
Προτιμότερο για Minecraft. Ιδανικό για in-game crates, keys και listener plugins. Ανοίγουμε TCP σύνδεση στο port Votifier σου.
Για Minecraft, χρησιμοποίησε πρώτα Votifier. Το HTTP postback είναι προαιρετικό (ή επιπλέον). Κάθε ενεργό κανάλι τρέχει ανεξάρτητα μετά την ψήφο.
Μετά από επιτυχημένη ψήφο ζητάμε το URL σου με την παράμετρο παίκτη και το IP του. Το script σου σημειώνει ότι ο λογαριασμός ψήφισε και δίνει πόντους ή αντικείμενα.
Βάλε σε whitelist το δημόσιο outbound IP αυτής της ιστοσελίδας στο firewall και στο postback script σου. Απόρριψε κάθε άλλη πηγή. Προτίμησε HTTPS.
Πίνακας ελέγχου → Επεξεργασία server → Vote Rewards → Postback URL.
https://YOURDOMAIN/postback.phpΠρόσθεσε παράμετρο ώστε κάθε παίκτης να αναγνωρίζεται όταν φτάνει στη σελίδα ψήφου.
/GAME/server/SLUG/vote?p=PARAMETER| Κομμάτι | Κανόνες |
|---|---|
PARAMETER / p_resp |
Μόνο γράμματα, αριθμοί, _, - · έως 32 χαρακτήρες · όνομα χρήστη, account id ή οποιοδήποτε id παρακολουθείς |
ip |
IPv4 ή IPv6 του ψηφοφόρου όπως το βλέπει αυτή η λίστα (proxy-aware όταν είναι ενεργό) |
| Query προ συμπλήρωσης | ?p= ή ?username= |
Μόνο σε επιτυχία. Αν ο παίκτης δεν ολοκλήρωσε έγκυρη ψήφο, δεν στέλνουμε αίτημα.
https://YOURDOMAIN/postback.php?p_resp=PARAMETER&ip=USERIP| Incentive link | Το callback μας |
|---|---|
/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 |
Όταν χτυπάμε το postback σου με p_resp=Razor, ο παίκτης Razor έχει ψηφίσει. Η τιμή ip είναι η διεύθυνση που χρησιμοποίησε σε αυτή τη λίστα.
Φιλοξένησέ το στο rewards site σου, όχι απαραίτητα σε αυτή τη λίστα ψήφων. Όρισε το VOTE_LIST_IP στο outbound δημόσιο IP αυτής της ιστοσελίδας πριν πας 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';
Μπορούμε να σπρώξουμε την ψήφο απευθείας στον Minecraft server σου. Ένα listener plugin τρέχει μετά τις εντολές reward σου.
Firewall: επίτρεψε inbound TCP από το δημόσιο IP αυτής της ιστοσελίδας στο port Votifier σου (προεπιλογή 8192). Μην εκθέτεις το port σε όλο το internet αν μπορείς να το αποφύγεις.
Ο παίκτης βάζει το Minecraft username του στη σελίδα ψήφου μας (ή φτάνει μέσω ?p=Steve).
Η ψήφος επιτυγχάνει σε αυτή τη λίστα.
Συνδεόμαστε στο host/port Votifier σου και παραδίδουμε το πακέτο ψήφου.
Το listener σου δίνει crates, keys, χρήματα κ.λπ.
Ενεργοποίησε Votifier στις Λεπτομέρειες Minecraft, διάλεξε NuVotifier v2 ή Classic και μετά βάλε host, port και token ή δημόσιο κλειδί RSA.
Εγκατέστησε NuVotifier (classic RSA και πρωτόκολλο v2) ή classic Votifier, συν listener για την έκδοση Minecraft σου (GAListener, SuperbVote ή custom listener).
Classic / v1: επικόλλησε το πλήρες αρχείο public.key. Host και port προέρχονται από το config.yml. Κράτα debug: true όσο συνδέεις αυτή τη λίστα και μετά απενεργοποίησέ το.
host: YOUR_PUBLIC_IP
port: 8192
debug: true
Τα πακέτα αναγνωρίζουν αυτή τη λίστα ως: JoinGameServers
Το πρωτόκολλο v2 αντικαθιστά το RSA με κοινόχρηστο token και one-time challenge. Αντιστοίχισε token στο service name αυτής της λίστας ή χρησιμοποίησε το προεπιλεγμένο token.
tokens:
default: REPLACE_WITH_DEFAULT_TOKEN
"JoinGameServers": REPLACE_WITH_LIST_TOKENWire format: TCP connect → διάβασμα greeting VOTIFIER 2 <challenge> → JSON payload (username, serviceName, timestamp ms, address, challenge) → Base64(HMAC-SHA256(payload, token)) → magic 0x733A + length + JSON {signature, payload}. Περίμενε {"status":"ok"}.
| Σύμπτωμα | Πιθανή αιτία |
|---|---|
| Δεν είναι server NuVotifier v2 | Το greeting δεν έχει challenge — χρησιμοποίησε Classic ή αναβάθμισε το NuVotifier και ενεργοποίησε v2. |
| Μη έγκυρη υπογραφή / άγνωστο service | Λάθος token ή το service name δεν είναι mapped. Πρόσθεσε το service name της λίστας ή χρησιμοποίησε το default. |
| Αποτυχία σύνδεσης / timeout | Λάθος host/port, Votifier offline ή το firewall μπλοκάρει το IP αυτής της λίστας. |
| Καμία απάντηση | Παρέμβαση proxy/plugin· ενεργοποίησε NuVotifier debug και δοκίμασε ξανά. |
Οι προσπάθειες παράδοσης καταγράφονται στο vote_reward_logs (ok / fail / skipped). Ένα αποτυχημένο callback δεν αναιρεί ποτέ την ψήφο σε αυτή τη λίστα.
Όχι. Οι επισκέπτες μπορούν να ψηφίζουν. Οι συνδεδεμένοι λογαριασμοί μοιράζονται τους ίδιους κανόνες cooldown 24 ωρών για αποτροπή κατάχρησης.
Αν έχεις ρυθμίσει postback URL ή Votifier, χρειαζόμαστε παράμετρο για να σου πούμε ποιον να ανταμείψεις. Χωρίς ρυθμισμένα rewards, το όνομα χρήστη μένει προαιρετικό.
Ναι. Και τα δύο τρέχουν μετά από επιτυχημένη ψήφο. Οι αποτυχίες είναι ανεξάρτητες.
Πρέπει να είναι δημόσιο http(s) URL. Localhost, .local, ιδιωτικά IPs (π.χ. 10.*, 192.168.*) και URLs με ενσωματωμένα credentials μπλοκάρονται.
Επιβεβαίωσε ότι η ψήφος πέτυχε σε αυτή τη λίστα. Έλεγξε τα postback logs ή το NuVotifier debug output. Επαλήθευσε firewall allowlists και ότι το username ταιριάζει με in-game λογαριασμό. Το cooldown της λίστας είναι 24 ώρες· το δικό σου reward cooldown μπορεί να διαφέρει.
Μόνο A–Z, a–z, 0–9, _ και -. Οτιδήποτε άλλο αφαιρείται. Κράτα τις παραμέτρους ≤ 32 χαρακτήρες.