Mga may-ari at gumawa ng plugin
Mga Dokumento
Bigyan ng gantimpala ang mga manlalaro kapag bumoto sila, at suriin kung may bumoto na ngayon — nang hindi kailangang hukayin ang mga jargon.
Mga gantimpala sa pagboto (Votifier)
Kapag may bumoto sa iyong listahan, MineBuff ay maaaring ipaalam agad sa iyong Minecraft server upang ang iyong reward plugin ay makapagbigay ng mga item, ranggo, o susi.
- Botante ng manlalaro Binubuksan nila ang iyong MineBuff pahina ng boto at inilalagay ang kanilang Minecraft pangalan.
- Ipinapaalam namin sa iyong server Ang MineBuff ay kumokonekta sa iyong Votifier port at naghahatid ng boto.
- Binibigyan ng gantimpala ang apoy NuVotifier / Classic Votifier / GAListener (o katulad nito) ang humahawak sa gantimpala.
Isaayos ito sa apat na hakbang
-
I-install ang Votifier sa iyong Minecraft server
Gamitin ang Classic Votifier o NuVotifier. Buksan ang port 8192 (o ang napiling port) sa firewall / host panel upang maabot ito ng pampublikong internet.
-
Kopyahin ang iyong key o token
v1: i-paste ang plugins/Votifier/rsa/public.key (o NuVotifier rsa/public.key). v2: kopyahin ang isang token mula sa NuVotifier config.yml (karaniwan ay default).
-
Paganahin ito sa iyong listahan
Dashboard → i-edit ang server → Votifier. I-on ang forwarding, itakda ang host (iwanang blangko para gamitin ang iyong Java IP), port, at protocol, pagkatapos ay i-paste ang key/token at i-save.
-
Magpadala ng subok na boto
Gamitin ang “Send test vote” sa parehong form. Kung gagana iyon, gagana rin ang totoong boto.
Awtomatik (inirerekomenda)
Pinipili ang NuVotifier v2 kapag magagamit ang isang hamon + token; kung hindi, bumabalik sa v1 RSA.
v1 — Susi ng RSA
Klasikong Votifier at NuVotifier RSA. Kailangan ang nilalaman ng public key file.
v2 — Token
NuVotifier HMAC token mula sa config.yml. Mabilis at simple kung ginagamit mo na ang NuVotifier.
Dapat payagan ng mga reward plugin na nagfi-filter ayon sa listahan ng site ang pangalan ng serbisyo na “MineBuff”. Kung nabigo ang paghahatid, bibilang pa rin ang boto sa site — suriin ang iyong firewall at mga kredensyal.
Suriin ang boto API
Itanong “nakaboto na ba ang IP para sa aking server ngayon?” Libre, pampubliko, walang API key.
Ang mga manlalaro ay bumoboto pa rin sa pahina ng MineBuff na boto. Ang mga URL na ito ay nagbabasa lamang kung may umiiral nang boto para sa araw na ito (UTC).
Karaniwang teksto
Pinakamainam para sa simpleng mga plugin — ang buong tugon ay isang karakter lamang.
https://minebuff.com/api/vote/{slug}/{ip}
1- Bumoto na ngayong araw
0- Hindi pa bumoto (o hindi kilala / hindi nailathalang server)
curl -s "https://minebuff.com/api/vote/your-server/203.0.113.10"
JSON
Parehong sagot, pati na rin kung kailan sila bumoto at gaano katagal hanggang sa araw-araw na pag-reset.
https://minebuff.com/api/vote/{slug}/{ip}/json
| Luparan | Kahulugan |
|---|---|
vote |
“1” o “0” (mga string) — bumoto ba ngayon o hindi. |
voted_at |
UTC oras ng pagboto ngayon, o wala. |
reset_at_midnight |
Laging totoo — ang pang-araw-araw na bintana para sa pag-check ng boto ay nire-reset sa 00:00 UTC (hiwalay ang kabuuan ng ranggo at nire-reset halos buwan-buwan). |
time_until_next_vote |
Segundos bago ang susunod na UTC hatinggabi kung nakaboto na sila; kung hindi, 0. |
{
"vote": "1",
"voted_at": "2026-09-12T14:32:01Z",
"reset_at_midnight": true,
"time_until_next_vote": 34199
}
Ano ang ilalagay sa URL
| Sa URL | Kahulugan |
|---|---|
{slug} |
Ang slug ng iyong server mula sa listing URL (hal. /servers/iyong-slug). |
{ip} |
Ang IP address ng manlalaro. Hahahash namin ito; isang boto bawat server bawat IP bawat UTC araw. |
Gumagana rin mula sa mga browser (CORS). Ang mga hindi kilalang server ay nagbabalik ng 0 sa plain text, o HTTP 404 JSON na may error na server_not_found.
Mga patakaran sa pagboto
Isang maikling listahan ng tsek para tugma ang oras ng iyong plugin sa sa amin.
- Maaari kang bumoto ng isang beses bawat server bawat IP bawat UTC araw (00:00 UTC). Ang kabuuang bilang ng boto sa ranggo ay bine-reset halos isang beses bawat buwan.
- Isang boto bawat nailathalang server bawat IP address bawat UTC araw.
- Ang mga boto ay nangangailangan ng Minecraft username sa MineBuff form (kinakailangan para sa Votifier).
- Ang tseke API ay hindi kailanman lumilikha ng boto; iniulat lamang nito ang katayuan ngayon.
tulong
Karaniwang mga problema kapag ang mga gantimpala o ang API ay hindi kumikilos nang maayos.
Nabibigo ang test vote o walang dumarating sa laro
Kumpirmahin na ang port 8192 (o ang iyong port) ay bukas sa internet, ang host ay tumutugma sa isang maabot na address, at ang key/token ay eksaktong tumutugma sa mga file ng plugin (walang dagdag na spaces).
Aling protocol ang dapat kong piliin?
Magsimula sa Auto. Gamitin ang v2 kung mayroon ka lamang NuVotifier na token. Gamitin ang v1 kung mayroon ka lamang RSA public key.
Ang API ay laging nagbabalik ng 0
Suriin na nailathala ang listahan, eksakto ang slug, at ipinapasa mo ang totoong IP ng manlalaro (hindi 127.0.0.1 maliban kung bumoto sila mula sa parehong makina).
Nakakansela ba ang mga nabigong Votifier paghahatid ng boto?
Hindi. Ang boto na MineBuff ay mahalaga pa rin. Ayusin ang koneksyon at subukan muli ang dashboard test vote.
Maaari ba akong bumoto sa pamamagitan ng API?
Hindi. Ang pagboto ay isinasagawa sa pampublikong pahina ng boto. Ang API ay para lamang basahin upang suriin ang botong ginawa ngayon.
