NuVotifierin asennus Paperiin, Velocityyn ja BungeeCordiin

Miten Votifier toimittaa äänen

1. Pelaaja äänestää palvelintasi listalla.
2. Lista avaa TCP-yhteyden palvelimesi Votifier-porttiin ja lähettää pelaajan nimen, oman service-nimensä, osoitteen ja aikaleiman.
3. NuVotifier tarkistaa viestin (v1:ssä RSA-avain, v2:ssa token) ja laukaisee vote-eventin.
4. Palkintoplugin, kuten VotingPlugin, kuuntelee tätä eventtiä ja antaa palkinnon.

NuVotifier ei itse anna mitään. Siinä ei ole yhtään kuuntelijaa valmiina, joten tarvitset aina toisen pluginin palkintoja varten.

Vaihe 1: Asenna NuVotifier Paperiin tai Spigotiin

Laita NuVotifierin JAR plugins-kansioon ja käynnistä palvelin kerran. Se luo configinsa, RSA-avainparin ja tokenin. Konsoli tulostaa tokenin ensimmäisellä käynnistyksellä: Your default NuVotifier token is ….

host: 0.0.0.0
port: 8192
disable-v1-protocol: false
tokens:
  default: <generated token>
forwarding:
  method: none
  pluginMessaging:
    channel: nuvotifier:votes

• host on osoite, jota NuVotifier kuuntelee. Oletuksena se käyttää IP:tä, jolle palvelimesi on määritetty, tai 0.0.0.0 kaikille verkkoliitännöille.
• port on Votifier-portti, oletuksena 8192. Se ei saa olla Minecraftin portti.
• tokens.default on käytössä jokaiselle listalle, ellet lisää tokenia listan service-nimen alle.
• v1:n avaimet luodaan kansioon plugins/Votifier/rsa/ nimillä public.key ja private.key.

Vaihe 2: Tee portista tavoitettava

Listat yhdistävät internetistä, joten Votifier-portin täytyy olla auki saapuville TCP-yhteyksille. Tähän useimmat asennukset kaatuvat.

• Jaettu hostaus: monet paneelit avaavat vain peliportin. Lisää paneelissa ylimääräinen portti ja laita täsmälleen se numero kohtaan port. Jotkin hostit antavat numeron puolestasi.
• Oma VPS tai root-palvelin: salli portti palomuurissa, esimerkiksi ufw allow 8192/tcp.
• Kotona: ohjaa portti reitittimessäsi koneelle, jolla palvelin pyörii.

Käynnistä palvelin uudelleen configin muuttamisen jälkeen. NuVotifierissa on myös /nvreload, joka toimii konsolista.

Vaihe 3: Valitse v1 (julkinen avain) tai v2 (token)

Älä koskaan anna kenellekään tiedostoa private.key. Jos lista tukee v2:ta, token on yksinkertaisempi valinta: yksi rivi, ei avaintiedostoa. BestMCServerList tukee molempia, joten valitse mieleisesi Votifier-sivullasi.

Pidä yksittäisellä palvelimella disable-v1-protocol: false. NuVotifier itse varoittaa, että monet listat puhuvat vain v1:tä.

Vaihe 4: Velocity- tai BungeeCord-verkostot

Verkostossa lista yhdistää proxyyn. NuVotifier pyörii proxyssa ja välittää äänet backend-palvelimille, joilla palkintoplugin on. NuVotifierin wiki suosittelee useimmille verkostoille plugin messagingia.

Proxy (Velocity)

host = "0.0.0.0"
port = 8192
disable-v1-protocol = false

[tokens]
default = "<generated token>"

[forwarding]
method = "pluginMessaging"

[forwarding.pluginMessaging]
channel = "nuvotifier:votes"
cache = "file"

BungeeCordissa samat avaimet ovat YAML-muodossa tiedostossa plugins/NuVotifier/config.yml. cache = "file" säilyttää offline-pelaajien äänet ja toimittaa ne myöhemmin.

Jokainen backend-palvelin (Paper)

port: -1
forwarding:
  method: pluginMessaging
  pluginMessaging:
    channel: nuvotifier:votes

port: -1 sammuttaa backendin kuuntelijan, joten vain proxy vastaanottaa ääniä. Varmista, että backendeihisi pääsee vain proxyn kautta, tai joku voisi lähettää väärennettyjä ääniä.

Toinen vaihtoehto, method = "proxy", lähettää äänet proxystä jokaisen backendin NuVotifier-porttiin, ja se määritetään osoitteella, portilla ja tokenilla palvelinkohtaisesti kohdassa [forwarding.proxy.<name>]. Siinä ei ole äänivälimuistia, joten plugin messaging sopii yleensä paremmin.

Vaihe 5: Syötä tiedot ja lähetä testiääni

1. Testaa ensin paikallisesti: /testvote Steve serviceName=BestMCServerList Paperissa tai /ptestvote samoilla argumenteilla proxyssa. Jos palkintopluginisi reagoi, sisäpuoli toimii.
2. Avaa BestMCServerListissä palvelimesi hallintapaneelissa ja mene kohtaan Votifier. Syötä palvelimen tai proxyn julkinen osoite, portti ja token (v2) tai julkinen avain (v1) ja tallenna.
3. Paina Lähetä testiääni. Lähetämme äänen nimelle TestVote, joka ei vaikuta rankingiin, ja toimitusloki näyttää sekunneissa, saapuiko se perille.

BestMCServerListin äänissä on service-nimi BestMCServerList. Geyserin ja Floodgaten kautta liittyvät Bedrock-pelaajat äänestävät etuliitteellisellä nimellään, esimerkiksi .Steve, ja nimi saapuu NuVotifierille muuttamattomana. Jokainen Minecraft-nimi voi äänestää kerran palvelinta ja kalenteripäivää kohden Europe/Berlin-ajassa laskettuna.

Etkö ole vielä listalla? Lisää palvelimesi ensin ja palaa sitten tähän vaiheeseen.

Yleiset virheet ja korjaukset

Kun äänet saapuvat, määritä palkinnot: oppaamme äänestyspalkinnoista VotingPluginilla käy läpi service-nimen, VoteSites.yml:n ja päivittäiset rajat. Isomman kuvan saat oppaasta miten saat pelaajia uudelle palvelimelle.