VoteNetwork

VoteNetwork
Systeme de vote reseau complet pour Velocity + Spigot/Paper

Par Sar_Tron — Licence MIT — Code source : https://gitea.louconnect.fr/Sar_Tron/VoteNetwork

⚠ Ce plugin necessite les DEUX modules du zip (proxy Velocity + serveurs Spigot) et une base MySQL. Il ne fonctionne PAS en le mettant seul sur un serveur solo sans proxy.

[hr]

Pourquoi VoteNetwork ?

La plupart des plugins de vote forcent un choix : soit le joueur doit etre connecte au bon moment, soit tout passe par une base de donnees meme quand ce n'est pas necessaire. VoteNetwork fait les deux intelligemment :

• Joueur connecte -> recompense instantanee sur son serveur actuel, sans toucher a la base de donnees.
• Joueur deconnecte -> vote stocke automatiquement, recuperable plus tard via /claim (en commande ou visuellement via un GUI).
• VoteParty independant par serveur (chaque mode de jeu a son propre objectif et ses propres recompenses).
• Mode maintenance pour bloquer /claim pendant un reset sans desinstaller le plugin.

[hr]

Fonctionnalites

• Vote direct en jeu via Plugin Messaging (canal custom, aucune latence de base de donnees si le joueur est en ligne).
• Votes en attente stockes en MySQL (partage reseau) ou en YAML local, au choix.
• Portee configurable des votes en attente : un compteur partage entre tous les serveurs, OU un compteur independant par serveur (le joueur peut claim ses votes du serveur A sans toucher a ceux du serveur B).
• VoteParty local par serveur : seuil, commandes et messages 100% personnalisables, persistant au redemarrage.
• Menu principal en jeu (/votemenu) : tete du joueur + progression VoteParty en un coup d'oeil, avec acces direct au menu de vote, a la reclamation visuelle et (pour les ops) a l'administration.
• Menu de vote (/votegui) : liste des sites de vote configures sous forme d'items cliquables, ouvre le lien dans le navigateur via un message chat cliquable.
• Menu de reclamation visuel : equivalent GUI de /claim, affiche le nombre de votes en attente (resolu en asynchrone) et les reclame d'un clic.
• Menu d'administration en jeu : bascule le mode maintenance d'un clic, sans commande a taper.
• Liste de commandes entierement configurable pour chaque vote et pour le declenchement du VoteParty.
• Message broadcast optionnel a chaque vote/claim, personnalisable.
• Mode maintenance (/vote stop|start) pour bloquer /claim proprement pendant un reset.
• Commande de diagnostic (/vote testdb) pour verifier la connexion MySQL ou l'acces au fichier YAML sans redemarrer.
• API Java publique (+ enregistrement ServicesManager Bukkit) pour lire l'etat du vote depuis un autre plugin.
• Support PlaceholderAPI natif : %votenetwork_voteparty_current%, %votenetwork_voteparty_required%, %votenetwork_voteparty_remaining%, %votenetwork_maintenance%, %votenetwork_pending% — pour scoreboard, tab, GUI, sans coder une ligne.
• Merge automatique de config : les nouvelles options ajoutees par une mise a jour n'ecrasent jamais tes reglages existants.
• Compatible Java 17, du 1.18 aux versions les plus recentes (API additive, testee en production).

[hr]

Installation

1. VoteNetwork-Velocity.jar -> dossier plugins/ du proxy Velocity.
2. VoteNetwork-Spigot.jar -> dossier plugins/ de CHAQUE serveur de jeu (aucune limite de nombre).
3. Demarrer une fois pour generer les configs, puis editer :
   • Proxy : plugins/votenetwork/config.properties
   • Serveur : plugins/votenetwork/config.yml (y compris la section gui: pour personnaliser les menus et les liens des sites de vote)
4. Renseigner les memes identifiants MySQL partout (proxy + tous les serveurs) — c'est cette base commune qui permet a un joueur de voter hors ligne puis de recuperer ses votes n'importe ou.
5. Redemarrer. La table est creee automatiquement, aucun script SQL a lancer a la main.

[hr]

Commandes & permissions

Commande	Ou	Qui	Description
votenetwork vote <pseudo>	Velocity	Console uniquement	Enregistre un vote pour le joueur
/claim	Spigot	Joueurs	Recupere les votes en attente
/votemenu	Spigot	Joueurs	Ouvre le menu principal (profil, reclamation, administration)
/votegui	Spigot	Joueurs	Ouvre le menu de vote avec les liens cliquables
/vote stop|start	Spigot	votenetwork.admin (op)	Bascule le mode maintenance
/vote testdb	Spigot	votenetwork.admin (op)	Teste le stockage configure

[hr]

Pre-requis

• Un proxy Velocity + au moins un serveur Spigot/Paper 1.18+.
• Une base MySQL accessible depuis le proxy ET tous les serveurs (ou stockage YAML local pour un usage solo/test uniquement).
• Java 17 minimum.
• Optionnel : PlaceholderAPI pour les placeholders de scoreboard.

[hr]

Code source complet et documentation detaillee (config avancee, portee per-server, API) disponibles sur le depot Git : https://gitea.louconnect.fr/Sar_Tron/VoteNetwork

Bugs / suggestions -> ouvrez une issue sur le depot.

Licence MIT — libre d'utilisation, modification et redistribution avec attribution.