Näin otat käyttöön äänestyspalkkiot (Votifier, VotingPlugin ja muut)

Jokainen palkintoplugin tarvitsee sinulta kaksi asiaa: keinon saada tietää, että ääni annettiin, ja jotain, mikä käynnistyy silloin. Tämä artikkeli käy läpi molemmat - tämän sivuston julkaiseman oheispluginin, Votifierin välitöntä toimitusta varten, sekä sen, mitä tehdä, jos sinulla on jo käytössä VotingPlugin, SuperVotes tai muu palkintoplugin.

Vaihtoehto A: VoxelRank-plugin (suositeltu)

Oheisplugin keskustelee suoraan tämän sivuston API:n kanssa. Votifieria ei tarvita - plugin toimii kyselemällä noutamattomia ääniä säännöllisin väliajoin, joten se toimii myös NAT:n takana ja kerää kiinni kaiken, mikä jäi väliin palvelimen ollessa pois päältä. Votifier on silti saatavilla valinnaisena lisänä välitöntä toimitusta varten (katso vaihtoehto B).

1. Lataa jar-tiedosto Kojelaudastasi (palvelimesi kortissa on latauspainike heti, kun build on olemassa), tai suoraan osoitteesta /download/plugin.
2. Pudota se plugins/-kansioon ja käynnistä palvelin kerran. Tämä luo tiedoston plugins/VotingSite/config.yml.
3. Avaa palvelimesi Muokkaa-sivu → välilehti Palkinnot ja äänestäminen ja kopioi siellä näkyvä API-avain.
4. Liitä se config.yml-tiedoston kohtaan site.api-key (tarkista myös, että site.url osoittaa tähän sivustoon), ja aja sitten /votingsite reload.
5. Päätä, miten äänten pitäisi saapua sinulle asettamalla mode tiedostossa config.yml:
   • poll (oletus) - plugin hakee noutamattomat äänet itse. Muuta ei tarvitse asentaa.
   • votifier - sivusto lähettää jokaisen äänen heti, kun se annetaan. Vaatii NuVotifierin tai muun Votifier-kuuntelijan (vaihtoehto B alla).
   • both - Votifier-työntö kyselyn ollessa varmistuksena, ilman kaksoiskappaleita äänen id:n ansiosta.
6. Täytä rewards.commands (ja halutessasi milestones ja vote-party) konsolikomennoilla, joiden pitäisi käynnistyä äänestettäessä.
7. Testaa se: /votingsite testvote <player> simuloi äänen odottamatta oikeaa. /votingsite status näyttää tilan, hyväksytäänkö API-avain ja kuinka monta ääntä on toimitettu tähän mennessä.

Pelaajat saavat äänestyslinkkinsä ja äänimääränsä komennolla /voxelrank vote - ei komennolla /vote, jota tämä plugin ei tarkoituksella koskaan omi (kaksi pluginia, jotka kilpailevat samasta komennosta, on juuri se tapa, jolla palkinto lakkaa toimimasta huomaamatta - katso asiasta oma huomautus tiedostossa config.yml).

Vaihtoehto B: välitön toimitus NuVotifierilla

Ohita tämä osio, jos poll-tila toimii jo riittävän hyvin - se ei ole pakollinen. Lisää se, kun kyselyn muutaman minuutin viive on merkityksellinen, tai kun haluat mieluummin käyttää erillistä palkintopluginia tämän sivuston omaan sijaan.

NuVotifier on alkuperäisen Votifierin aktiivisesti ylläpidetty haara - alkuperäinen projekti on nykyään käytännössä ilman ylläpitoa, joten "Votifierin asentaminen" tarkoittaa käytännössä NuVotifierin (tai yhteensopivan haaran, kuten VotifierPlusin) asentamista.

1. Pudota NuVotifierin jar-tiedosto plugins/-kansioon ja käynnistä palvelin uudelleen. Bukkit-/Spigot-/Paper-palvelimella se säilyttää perinteisen plugins/Votifier/-kansionimen taaksepäin yhteensopivuuden vuoksi - se on NuVotifierin oma kansio, ei jäänne vanhasta pluginista - ja luo sinne ensimmäisellä käynnistyskerralla config.yml-tiedoston sekä avainparin rsa/-kansioon.
2. Hae tunnuksesi tiedostosta plugins/Votifier/config.yml: v2-token (suositeltu) luodaan automaattisesti avaimen default alle osiossa tokens: - kopioi se sellaisenaan. Jos haluat mieluummin vanhemman menetelmän, v1-julkinen avain löytyy tiedostosta plugins/Votifier/rsa/public.key; pidä vastaava private.key samassa kansiossa palvelimella äläkä koskaan jaa sitä.
3. Tarkista port, jota NuVotifier kuuntelee (oletuksena 8192), ja varmista, että se on auki palomuurissasi tai hosting-paneelissa - se on eri portti kuin tavallinen Minecraft-portti, eivätkä useimmat hostit avaa sitä automaattisesti.
4. Palvelimesi Muokkaa-sivulla → välilehdellä Palkinnot ja äänestäminen täytä Votifier-isäntä (palvelimesi osoite) ja tämä portti, liitä sitten vaiheen 2 v2-token tai v1-avain. Jos molemmat on täytetty, käytetään vain toista - v2 voittaa.
5. Napsauta Lähetä testiäänestys suoraan kyseisellä välilehdellä. Tämä lähettää oikean Votifier-paketin isäntään/porttiin/avaimeen/tokeniin, joka lomakkeessa on juuri sillä hetkellä - mitään ei tarvitse tallentaa ensin - ja kertoo heti, hyväksyikö NuVotifier sen. Jos se epäonnistuu, NuVotifierin oma konsolilokitus (oletuksena debug: true) näyttää, saavuttiko yhteys edes pluginin, mikä erottaa nopeasti "väärän avaimen" "estetystä portista".
6. Tallenna, anna sitten oikea ääni ja varmista, että palkinto saapuu heti seuraavan kyselyn sijaan.

Konepellin alla tämä sivusto lähettää tavallisen VOTIFIER 2 -kättelyn HMAC-allekirjoitetulla JSON-hyötykuormalla, kun v2-token on asetettu, ja palaa muuten klassiseen, RSA-salattuun v1-lohkoon - sama protokolla, jota mikä tahansa Votifier-yhteensopiva kuuntelija jo puhuu, ei mitään sivustokohtaista.

Käytätkö jo VotingPluginia?

Jos palvelimellasi on jo käytössä VotingPlugin, sinun ei tarvitse asentaa omaamme - eikä sinun tarvitse lisätä tätä sivustoa siihen käsin, koska VotingPluginissa on sille ylläpidetty valmisasetus.

Suorita tämä pelissä operaattorina (tai oikeudella VotingPlugin.Commands.AdminVote.VotePresets):

/av VotePresets

VotingPlugin lataa nykyisen valmisasetusluettelon omasta VotingPlugin-Presets-repositoriostaan, antaa sinun valita yhden - VoxelRank on niiden joukossa - ja kysyy sitten arvoja, joita kyseinen valmisasetus tarvitsee: näyttönimi, ilmoituksesi äänestys-URL, äänten välinen viive ja vastaavat. Tai siirry suoraan asiaan omalla äänestyslinkilläsi:

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

Sisällytä https://; VotingPlugin sovittaa isäntänimen automaattisesti oikeaan valmisasetukseen sen sijaan, että joutuisit etsimään sitä luettelosta.

Joka tapauksessa se kirjoittaa tai päivittää vastaavan merkinnän kohdassa VoteSites: tiedostossa VoteSites.yml - ServiceSite, VoteURL, järkevät oletusviiveet sekä paikkaa pitävän näyttöesineen tai kiitosviestin, jos sivustolla ei vielä ole sellaista - ja lataa sitten äänestyssivustot uudelleen puolestasi. Kaikki muu, mikä tiedostossa jo on, jätetään koskematta. Ota ensin varmuuskopio tiedostosta VoteSites.yml, jos muutat vakiintunutta asetusta uuden lisäämisen sijaan, ja tarkista, mitä kirjoitettiin - erityisesti palkinnot, koska valmisasetus on lähtökohta, ei valmis konfiguraatio - ennen kuin mainostat sitä pelaajille.

VotingPlugin tarvitsee silti oman Votifier-yhteytensä äänten tosiasialliseen vastaanottamiseen - osoita se samaan NuVotifier-asetukseen kuin yllä olevassa vaihtoehdossa B. Se tarvitsee myös, että palvelin pääsee GitHubiin (raw.githubusercontent.com) hakeakseen valmisasetuksia ylipäätään; jos /av VotePresets ilmoittaa, ettei valmisasetuksia ole saatavilla, kyse on palvelimen verkko- tai palomuuriongelmasta, ei puuttuvasta valmisasetuksesta. /av gui, tai tiedoston VoteSites.yml suora muokkaaminen, toimii yhä varajärjestelynä - ServiceSite-arvon on oltava täsmälleen VoxelRank.com, minkä voit varmistaa komennolla /av servicesites oikean tai ylläpitäjän testiäänen jälkeen.

Muut palkintopluginit

Käytätkö jotain VotingPluginia kevyempää? SuperVotes ja SuperbVote ovat molemmat kevyitä Votifier-kuuntelijoita, joilla on omat vote-party- ja palkintokomentojärjestelmänsä. Kumpikaan ei seuraa sivustokohtaisia valmisasetuksia niin kuin VotingPlugin - osoita kumpi tahansa niistä samaan Votifier-isäntään, porttiin ja v2-tokeniin (tai v1-avaimeen) yllä olevalta välilehdeltä Palkinnot ja äänestäminen ja määritä sen palkinnot samalla tavalla kuin minkä tahansa muun äänestyksen kohdalla.

Vianmääritys

• Komennolla /votingsite testvote ei tapahdu mitään. Tarkista ensin /votingsite status - jos API-avainta ei hyväksytä, äänillä (oikeilla tai testeillä) ei ole minne mennä. Kopioi se uudelleen Muokkaa-sivulta ja varmista, ettei lopussa ole ylimääräistä välilyöntiä.
• Votifier-työntö ei koskaan saavu perille, mutta kysely toimii. Yleensä juuri Votifier-portti on estetty, ei API - useimmat hostit avaavat lähtevän HTTP-liikenteen oletuksena, mutta eivät mielivaltaista ylimääräistä saapuvaa porttia. mode: both (tai jonkin toisen palkintopluginin kuuntelijan ajaminen erikseen) on järkevä pysyvä varajärjestely sen sijaan, että taistelisit palomuuria vastaan.
• Palkinto laukeaa, mutta pelissä ei näy mitään. Palkintokomennot ajetaan konsolista, joten komento, joka toimii vain pelaajan kirjoittamana (ei oikeutta, ei op-tilaa), epäonnistuu huomaamatta. Testaa tarkka komento ensin konsolista.
• VotingPlugin kirjaa "invalid service site" tai ei koskaan täsmää ääntä. Arvon ServiceSite on täsmättävä merkki merkiltä, kirjainkokoa lukuun ottamatta. Tarkista se komennolla /av servicesites sen sijaan, että arvaisit sen tämän sivuston verkkotunnuksen perusteella.
• /av VotePresets sanoo, ettei valmisasetuksia ole saatavilla, tai URL ei täsmää mihinkään. Se lataa valmisasetusluettelon GitHubista ajon aikana, joten kyse on lähes aina palvelimen omasta verkosta - palomuurista, välityspalvelimesta, DNS:stä tai GitHub-katkoksesta - joka estää osoitteen raw.githubusercontent.com, ei merkki siitä, että VoxelRank olisi poistettu listalta. URL-täsmäys vaatii myös koko osoitteen, mukaan lukien https://; pelkkiä isäntänimiä ei tunnisteta.
• Välilehden Palkinnot ja äänestäminen asetukset eivät näytä tallentuvan. Ne koskevat vain vaadittua ilmoitusta - katso Vaatii-suodatin palvelinlistalta. Tuodulla, vaatimattomalla merkinnällä ei vielä ole omistajaa, jolle palkintoja voisi määrittää; vaadi se ensin.

Nopeat vastaukset

Tarvitsenko Votifieria ylipäätään?

En. poll-tila (VoxelRank-pluginin oletus) toimii asentamatta mitään muuta - Votifier vain lyhentää viivettä äänen ja palkinnon välillä, ja se on ainoa reitti sisään, jos haluat sen sijaan käyttää VotingPluginia, SuperVotesia tai SuperbVotea.

Voinko käyttää pluginiamme ja VotingPluginia samanaikaisesti?

En saman palkinnon kohdalla - valitse yksi, joka todella ajaa palkintokomennot, tai ääni saatetaan maksaa kahdesti. Votifier itse voi ilmoittaa useammalle kuin yhdelle kuuntelijalle, joten kyse on säännöstä "älä määritä samaa palkintoa kahdesti", ei teknisestä rajoituksesta.

Hostingini ei anna minun avata ylimääräisiä portteja Votifieria varten.

Käytä poll-tilaa VoxelRank-pluginin kanssa. Se tekee vain lähteviä pyyntöjä, joten mitään ei tarvitse avata. VotingPluginilla ja vastaavilla palkintopluginilla ei ole vastinetta kyselytilalle - ne tarvitsevat saapuvan Votifier-portin.

Tarvitsetko apua?

Jäitkö jumiin jonkin yllä olevan vaiheen kohdalla, tai eikö jokin täsmää siihen, mitä palvelimesi todella lähettää? Ota meihin yhteyttä - nopeimmat reitit äänestys-/palkintokysymykselle on listattu juuri siellä.