Aqbeż għall-kontenut

Setup ta’ NuVotifier fuq Paper, Velocity u BungeeCord

NuVotifier huwa l-biċċa bejn lista tas-servers u l-plugin tal-premjijiet tiegħek: il-lista tikkonnettja miegħu għal kull vot, u hu jgħaddi l-vot lil kwalunkwe plugin li jagħti l-premju. Din il-gwida twaqqfu fuq server Paper wieħed u fuq network ta’ Velocity jew BungeeCord, imbagħad tiċċekkja kollox b’vot tat-test.

Aġġornat:

Kif Votifier iwassal vot

  1. Plejer jivvota għas-server tiegħek f’lista.
  2. Il-lista tiftaħ konnessjoni TCP mas-server tiegħek fuq il-port ta’ Votifier u tibgħat l-isem tal-plejer, l-isem tas-servizz tagħha, indirizz u timestamp.
  3. NuVotifier jiċċekkja l-messaġġ (ċavetta RSA għal v1, token għal v2) u jqanqal vote event.
  4. Plugin tal-premjijiet bħal VotingPlugin jisma’ għal dak l-event u jagħti l-premju.

NuVotifier innifsu ma jagħti xejn. Jiġi mingħajr ebda listener, allura dejjem għandek bżonn it-tieni plugin għall-premjijiet.

Pass 1: Installa NuVotifier fuq Paper jew Spigot

Poġġi l-JAR ta’ NuVotifier fil-folder plugins u ixgħel is-server darba. Joħloq il-config tiegħu, par ta’ ċwievet RSA u token. Il-console tikteb it-token fl-ewwel bidu: Your default NuVotifier token is ….

plugins/Votifier/config.yml
host: 0.0.0.0
port: 8192
disable-v1-protocol: false
tokens:
  default: <generated token>
forwarding:
  method: none
  pluginMessaging:
    channel: nuvotifier:votes
  • host huwa l-indirizz li fuqu jisma’ NuVotifier. B’mod default jieħu l-IP li s-server tiegħek huwa kkonfigurat għalih, jew 0.0.0.0 għall-interfaces kollha.
  • port huwa l-port ta’ Votifier, 8192 b’mod default. M’għandux ikun il-port tal-Minecraft.
  • tokens.default jintuża għal kull lista sakemm ma żżidx token taħt l-isem tas-servizz ta’ lista.
  • Iċ-ċwievet għal v1 jinħolqu f’plugins/Votifier/rsa/ bħala public.key u private.key.

Pass 2: Agħmel il-port jintlaħaq

Il-listi jikkonnettjaw mill-internet, allura l-port ta’ Votifier irid ikun miftuħ għal konnessjonijiet TCP deħlin. Hawnhekk ifallu l-biċċa l-kbira tas-setups.

  • Shared hosting: ħafna panels jiftħu biss il-port tal-logħba. Żid port żejjed fil-panel u poġġi eżattament dak in-numru f’port. Xi hosts jassenjaw in-numru għalik.
  • VPS jew root server tiegħek: ippermetti l-port fil-firewall, pereżempju ufw allow 8192/tcp.
  • Id-dar: agħmel forward tal-port fir-router tiegħek lejn il-magna li tħaddem is-server.

Agħmel restart lis-server wara li tibdel il-config. NuVotifier għandu wkoll /nvreload, li jaħdem mill-console.

Pass 3: Agħżel v1 (public key) jew v2 (token)

Protokoll v1Protokoll v2
SigrietPar ta’ ċwievet RSAToken komuni
X’teħtieġ il-listaIl-kontenut ta’ rsa/public.keyIt-token minn tokens.default
AppoġġVotifier klassiku; il-biċċa l-kbira tal-listi jitkellmuhNuVotifier u listi li jappoġġawh

Qatt tagħti private.key lil ħadd. Jekk lista tappoġġa v2, it-token huwa l-għażla l-aktar sempliċi: linja waħda, l-ebda fajl taċ-ċavetta. BestMCServerList jappoġġa t-tnejn, allura agħżel dak li tixtieq fil-paġna ta’ Votifier tiegħek.

Żomm disable-v1-protocol: false fuq server wieħed. NuVotifier innifsu jwissi li ħafna listi jitkellmu biss v1.

Pass 4: Networks ta’ Velocity jew BungeeCord

F’network, il-lista tikkonnettja mal-proxy. NuVotifier jaħdem fuq il-proxy u jgħaddi l-voti lis-servers backend fejn jinsab il-plugin tal-premjijiet. Il-wiki ta’ NuVotifier tirrakkomanda plugin messaging għall-biċċa l-kbira tan-networks.

Proxy (Velocity)

plugins/nuvotifier/config.toml
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"

Fuq BungeeCord l-istess ċwievet jinsabu f’plugins/NuVotifier/config.yml f’forma YAML. cache = "file" iżomm il-voti għall-plejers li huma offline u jwassalhom aktar tard.

Kull server backend (Paper)

plugins/Votifier/config.yml
port: -1
forwarding:
  method: pluginMessaging
  pluginMessaging:
    channel: nuvotifier:votes

port: -1 jitfi l-listener fuq il-backend, biex il-proxy biss jirċievi l-voti. Kun żgur li l-backends tiegħek jistgħu jintlaħqu biss permezz tal-proxy, inkella xi ħadd jista’ jibgħat voti foloz.

L-għażla l-oħra, method = "proxy", tibgħat il-voti mill-proxy lejn port ta’ NuVotifier fuq kull backend, ikkonfigurat b’indirizz, port u token għal kull server taħt [forwarding.proxy.<name>]. M’għandhiex cache tal-voti, allura l-plugin messaging normalment jaqbel aħjar.

Pass 5: Daħħal id-dettalji u ibgħat vot tat-test

  1. L-ewwel ittestja lokalment: /testvote Steve serviceName=BestMCServerList fuq Paper, jew /ptestvote bl-istess argumenti fuq il-proxy. Jekk il-plugin tal-premjijiet tiegħek jirreaġixxi, il-parti ta’ ġewwa taħdem.
  2. Fuq BestMCServerList, iftaħ is-server tiegħek fid-dashboard u mur fuq Votifier. Daħħal l-indirizz pubbliku tas-server jew tal-proxy, il-port u t-token (v2) jew il-public key (v1), imbagħad issejvja.
  3. Agħfas Ibgħat vot tat-test. Nibagħtu vot għal TestVote li ma jgħoddx għall-klassifika, u l-log tal-kunsinni juri fi ftit sekondi jekk wasalx.

Il-voti minn BestMCServerList iġorru l-isem tas-servizz BestMCServerList. Il-plejers Bedrock li jidħlu permezz ta’ Geyser u Floodgate jivvotaw bl-isem tagħhom bil-prefix, pereżempju .Steve, u l-isem jasal għand NuVotifier kif inhu. Kull isem tal-Minecraft jista’ jivvota darba għal kull server għal kull jum kalendarju, magħdud fil-ħin ta’ Europe/Berlin.

Għadek mhux fil-lista? L-ewwel żid is-server tiegħek, imbagħad erġa’ lura għal dan il-pass.

Żbalji komuni u soluzzjonijiet

ProblemaX’għandek tiċċekkja
Connection refusedNuVotifier mhux qed jaħdem jew qed jisma’ fuq port ieħor. Qabbel il-port fil-config ma’ dak li daħħalt.
Timed outFirewall jew il-host qed iwaqqa’ t-traffiku. Iftaħ il-port għal TCP jew staqsi lill-host għal port żejjed.
It-test jasal, il-plejers ma jieħdu xejnL-ebda plugin tal-premjijiet. Il-console tikteb A vote was received, but you don't have any listeners available to listen for it.
Vot miċħud b’v2It-token ma jaqbilx. Erġa’ kkopja tokens.default, mingħajr spazji jew virgoletti.
Jaħdem fuq il-proxy, mhux fuq il-backendIl-backend mhux issettjat għal pluginMessaging, jew l-ismijiet taċ-channels huma differenti.
Daħħalt il-port il-ħażinIl-port tal-Minecraft iwieġeb minflok NuVotifier. Uża l-port ta’ Votifier.

Ladarba l-voti jaslu, waqqaf il-premjijiet: il-gwida tagħna dwar il-premjijiet tal-vot b’VotingPlugin tkopri l-isem tas-servizz, VoteSites.yml u l-limiti ta’ kuljum. Għall-istampa sħiħa, ara kif issib plejers għal server ġdid.

Mistoqsijiet frekwenti

Liema port juża NuVotifier?

Il-port 8192 b’mod default. Tista’ tibdlu fil-config, iżda jrid ikun port separat mill-port tal-Minecraft u jintlaħaq mill-internet fuq TCP.

Fejn insib it-token ta’ NuVotifier?

F’plugins/Votifier/config.yml taħt tokens → default. Il-console tiktbu wkoll fl-ewwel bidu.

Għandi bżonn NuVotifier fuq kull server tan-network tiegħi?

Bil-plugin messaging, iva: fuq il-proxy biex jirċievi l-voti, u fuq kull backend b’forwarding.method: pluginMessaging u port: -1 biex jgħaddihom lill-plugin tal-premjijiet.

Għandi nuża v1 jew v2?

Uża v2 b’token meta l-lista tappoġġah. V1 bil-public key RSA jeżisti għal setups eqdem. BestMCServerList jappoġġa t-tnejn.

NuVotifier jagħti l-premjijiet waħdu?

Le. Jirċievi biss il-voti. Plugin tal-premjijiet bħal VotingPlugin irid jisma’ għalihom.

Sorsi

Iċċekkjat mad-dokumentazzjoni uffiċjali: