Paano mag-set up ng vote rewards (Votifier, VotingPlugin, at iba pa)

Kailangan ng bawat reward plugin ng dalawang bagay mula sa iyo: paraan para malaman na may bumoto, at may gagawin kapag nangyari iyon. Tatalakayin dito ang parehong bagay - ang kasamang plugin na inilalabas ng site na ito, ang Votifier para sa instant na pagbibigay, at kung ano ang gagawin kung meron ka nang VotingPlugin, SuperVotes, o ibang reward plugin.

Option A: ang VoxelRank plugin (inirerekomenda)

Direktang kausap ng kasamang plugin ang API ng site na ito. Hindi kailangan ang Votifier - gumagana ito sa pamamagitan ng pag-poll ng mga hindi pa na-claim na boto paminsan-minsan, kaya gumagana pa rin ito kahit nasa likod ng NAT at naaabutan pa rin nito ang mga nakaligtaan habang naka-down ang server. Available din ang Votifier bilang opsyonal na add-on para sa instant na pagbibigay (tingnan ang Option B).

1. I-download ang jar mula sa iyong Dashboard (may Download button ang card ng server mo sa sandaling may build na), o direkta mula sa /download/plugin.
2. Ilagay ito sa plugins/ at i-start ang server nang isang beses. Gagawa ito ng plugins/VotingSite/config.yml.
3. Buksan ang Edit page ng server mo → tab na Rewards & voting at kopyahin ang API key na nakalagay doon.
4. I-paste ito sa site.api-key sa config.yml (i-double-check din na tumutukoy ang site.url sa site na ito), tapos patakbuhin ang /votingsite reload.
5. Desisyunan kung paano dapat umabot sa iyo ang mga boto sa pamamagitan ng pag-set ng mode sa config.yml:
   • poll (default) - kinukuha mismo ng plugin ang mga hindi pa na-claim na boto. Wala nang kailangang i-install.
   • votifier - ipinapadala ng site ang bawat boto sa mismong sandaling ibinoto ito. Kailangan ng NuVotifier o ibang Votifier listener (Option B sa ibaba).
   • both - Votifier push kasama ang polling bilang safety net, walang duplicate salamat sa id ng boto.
6. Punan ang rewards.commands (at kung gusto mo, ang milestones at vote-party) ng mga console command na dapat tumakbo kapag may boto.
7. Subukan mo: si-nisimulate ng /votingsite testvote <player> ang isang boto nang hindi na naghihintay ng totoo. Ipinapakita ng /votingsite status ang mode, kung tinatanggap ang API key, at ilang boto na ang naihatid sa ngayon.

Nakukuha ng mga player ang vote link at bilang ng boto nila gamit ang /voxelrank vote - hindi /vote, na sinasadyang hindi kailanman ino-own ng plugin na ito (dalawang plugin na nag-aagawan sa parehong command ang eksaktong dahilan kung paano tahimik na tumitigil ang isang reward - tingnan ang sariling note tungkol dito sa config.yml).

Option B: instant na pagbibigay gamit ang NuVotifier

Laktawan mo ito kung sapat na sa iyo ang poll mode - hindi ito required. Idagdag mo ito kapag mahalaga sa iyo ang ilang minutong delay ng polling, o kung mas gusto mong magpatakbo ng dedicated na reward plugin kaysa sa sarili ng site na ito.

Ang NuVotifier ay ang aktibong minementena na fork ng orihinal na Votifier - halos hindi na minementena ang orihinal na proyekto ngayon, kaya sa praktika, ang "pag-install ng Votifier" ay nangangahulugang pag-install ng NuVotifier (o compatible na fork tulad ng VotifierPlus).

1. Ilagay ang jar ng NuVotifier sa plugins/ at i-restart ang server. Sa Bukkit/Spigot/Paper server, pinapanatili nito ang klasikong pangalan ng folder na plugins/Votifier/ para sa backward compatibility - sarili itong folder ng NuVotifier, hindi latak ng lumang plugin - at gagawa ito ng config.yml kasama ang key pair sa rsa/ sa loob nito sa unang pagkakataong mag-start ito.
2. Kunin ang credentials mo mula sa plugins/Votifier/config.yml: awtomatikong gagawin ang v2 token (inirerekomenda) sa ilalim ng default key sa tokens: section - kopyahin mo ito nang eksakto. Kung mas gusto mo ang mas lumang paraan, ang v1 public key ay nasa plugins/Votifier/rsa/public.key; panatilihin ang kaparehang private.key sa parehong folder sa server at huwag itong ibahagi kahit kanino.
3. I-check ang port na pinakikinggan ng NuVotifier (8192 ang default) at tiyaking bukas ito sa firewall mo o sa hosting panel - iba ito sa normal na Minecraft port, at karamihan sa mga host ay hindi ito awtomatikong binubuksan.
4. Sa Edit page ng server mo → tab na Rewards & voting, punan ang Votifier host (address ng server mo) at ang port na iyon, tapos i-paste ang v2 token o v1 key mula sa step 2. Kung parehong napunan, isa lang ang gagamitin - ang v2 ang mananalo.
5. I-click ang Send test vote mismo sa tab na iyon. Magpapadala ito ng totoong Votifier packet sa host/port/key/token na kasalukuyang nasa form - hindi kailangang i-save muna - at agad na mag-uulat kung tinanggap ito ng NuVotifier. Kung mabigo, ipapakita ng sariling console log ng NuVotifier (debug: true ang default) kung naabot man ng connection ang plugin, na mabilis na naghihiwalay ng "mali ang key" sa "naka-block ang port".
6. I-save, tapos bumoto nang totoo at kumpirmahin na dumating agad ang reward sa halip na sa susunod na polling.

Sa likod, nagpapadala ang site na ito ng standard na VOTIFIER 2 handshake na may HMAC-signed JSON payload kapag naka-set ang v2 token, at babalik sa klasikong RSA-encrypted na v1 block kung wala - parehong protocol na kausap na ng anumang Votifier-compatible na listener, walang partikular sa site na ito.

Gumagamit ka na ba ng VotingPlugin?

Kung tumatakbo na ang VotingPlugin sa server mo, hindi mo na kailangang i-install ang sa amin - at hindi mo na kailangang idagdag nang manual ang site na ito dito, dahil may minementenang preset ang VotingPlugin para dito.

Patakbuhin ito sa loob ng laro bilang operator (o may VotingPlugin.Commands.AdminVote.VotePresets permission):

/av VotePresets

Dina-download ng VotingPlugin ang kasalukuyang listahan ng preset mula sa sarili nitong VotingPlugin-Presets repository, hinahayaan kang pumili ng isa - kasama na ang VoxelRank - tapos tinatanong ang mga value na kailangan ng preset na iyon: display name, vote URL ng listing mo, delay ng boto, at katulad nito. O kaya diretso kang lumaktaw gamit ang sarili mong vote link:

/av VotePresets https://voxelrank.com/server/your-slug/vote

Isama ang https://; awtomatikong itutugma ng VotingPlugin ang hostname sa tamang preset sa halip na pahanapin ka pa sa listahan.

Kahit anong paraan, isusulat o iu-update nito ang katugmang entry sa ilalim ng VoteSites: sa VoteSites.yml - ServiceSite, VoteURL, makatwirang default na delay, at isang placeholder na display item o thank-you message kung wala pa nito ang site - tapos irre-reload nito ang vote sites para sa iyo. Hindi magagalaw ang anumang nasa file na - iiwan itong ganoon. I-back up muna ang VoteSites.yml kung binabago mo ang matagal nang setup sa halip na magdagdag ng bago, at suriin ang isinulat nito - lalo na ang mga reward, dahil ang preset ay panimulang punto lang, hindi tapos na configuration - bago ito i-advertise sa mga player.

Kailangan pa rin ng VotingPlugin ng sarili nitong Votifier connection para talagang makatanggap ng boto - ituro ito sa parehong NuVotifier setup mula sa Option B sa itaas. Kailangan din nitong maabot ng server ang GitHub (raw.githubusercontent.com) para makakuha ng mga preset; kung nagsabi ang /av VotePresets na walang available na preset, network o firewall issue iyon sa server, hindi nawawalang preset. Gumagana pa rin bilang fallback ang /av gui, o direktang pag-edit ng VoteSites.yml - kailangang eksaktong VoxelRank.com ang mababasa sa ServiceSite, na makukumpirma mo gamit ang /av servicesites matapos ang totoo o admin test vote.

Ibang reward plugin

Gumagamit ka ba ng mas magaan kaysa sa VotingPlugin? Ang SuperVotes at SuperbVote ay parehong magaan na Votifier listener na may sariling vote-party at reward command system. Wala sa dalawa ang nagtatrack ng per-site na preset tulad ng VotingPlugin - ituro ang alinman sa dalawa sa parehong Votifier host, port, at v2 token (o v1 key) mula sa Rewards & voting tab sa itaas at i-configure ang mga reward nito tulad ng gagawin mo para sa kahit anong boto.

Pag-troubleshoot

• Walang nangyayari sa /votingsite testvote. I-check muna ang /votingsite status - kung hindi tinatanggap ang API key, walang mapupuntahan ang mga boto (totoo man o test). Kopyahin ulit ito mula sa Edit page at tiyaking walang natitirang space sa dulo.
• Hindi kailanman dumarating ang Votifier push pero gumagana ang polling. Karaniwang ang Votifier port ang naka-block, hindi ang API - karamihan sa mga host ay bukas ang outbound HTTP by default pero hindi ang kahit anong extra na inbound port. Makatwirang permanent na fallback ang mode: both (o pagpapatakbo ng listener ng ibang reward plugin) kaysa makipaglaban sa firewall.
• Nag-trigger ang reward pero walang lumalabas sa laro. Tumatakbo ang mga reward command sa console, kaya tahimik na mabibigo ang command na gumagana lamang kapag na-type ng player (walang permission, walang op). Subukan muna ang eksaktong command mula sa console.
• Nagla-log ang VotingPlugin ng "invalid service site" o hindi kailanman natutugma ang boto. Kailangang eksaktong magkatugma ang value ng ServiceSite character by character, maliban sa capitalization. I-check ito gamit ang /av servicesites sa halip na hulaan mula sa domain name ng site na ito.
• Sinasabi ng /av VotePresets na walang available na preset, o walang katugma ang isang URL. Dina-download nito ang preset list mula sa GitHub sa runtime, kaya halos palaging ang sariling network ng server - firewall, proxy, DNS, o GitHub outage - ang bumabara sa raw.githubusercontent.com, hindi tanda na tinanggal ang VoxelRank sa listahan. Kailangan din ng URL match ng buong address kasama ang https://; hindi makikilala ang bare hostname lamang.
• Parang hindi nase-save ang mga setting sa Rewards & voting tab. Para lang ito sa listing na claimed - tingnan ang Claimed filter sa listahan ng server. Wala pang owner ang na-import, unclaimed na entry para i-configure ang mga reward; i-claim muna ito.

Mabilisang sagot

Kailangan ko ba talaga ng Votifier?

Hindi. Gumagana ang poll mode (default para sa VoxelRank plugin) nang walang kailangang i-install pa - pinaiikli lang ng Votifier ang delay sa pagitan ng boto at reward, at ito ang tanging daan papasok kung mas gusto mong magpatakbo ng VotingPlugin, SuperVotes, o SuperbVote sa halip.

Puwede ko bang gamitin ang plugin namin at ang VotingPlugin nang sabay?

Hindi para sa parehong reward - pumili ng isa na talagang magpapatakbo ng mga reward command, kung hindi baka mabayaran nang dalawang beses ang isang boto. Kayang i-notify mismo ng Votifier ang higit sa isang listener, kaya ito ay panuntunang "huwag i-configure ang parehong reward nang dalawang beses", hindi teknikal na limitasyon.

Hindi ako pinapayagan ng hosting ko na magbukas ng extra port para sa Votifier.

Gamitin ang poll mode kasama ang VoxelRank plugin. Outbound request lang ang ginagawa nito, kaya wala nang kailangang buksan. Wala ang VotingPlugin at katulad na reward plugin ng katumbas ng polling mode - kailangan nila ng inbound Votifier port.

Kailangan mo ba ng tulong?

Naiipit ka ba sa isa sa mga hakbang sa itaas, o may hindi ba tumutugma sa talagang ipinapadala ng server mo? Makipag-ugnayan sa amin - nakalista mismo doon ang pinakamabilis na paraan para sa tanong tungkol sa boto/reward.