From ff1afd58fe37851d73af3b8a75898967e5b6c7b9 Mon Sep 17 00:00:00 2001 From: SarTron-NorthBlue Date: Sun, 12 Jul 2026 18:56:47 +0400 Subject: [PATCH] Ajoute la description SpigotMC (BBCode) pour la publication de la ressource Co-Authored-By: Claude Sonnet 5 --- docs/spigotmc-description.bbcode.txt | 78 ++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 docs/spigotmc-description.bbcode.txt diff --git a/docs/spigotmc-description.bbcode.txt b/docs/spigotmc-description.bbcode.txt new file mode 100644 index 0000000..579bbe1 --- /dev/null +++ b/docs/spigotmc-description.bbcode.txt @@ -0,0 +1,78 @@ +[CENTER][SIZE=5][B]VoteNetwork[/B][/SIZE] +Systeme de vote reseau complet pour Velocity + Spigot/Paper +Par [B]Sar_Tron[/B] — Licence MIT — Code source : https://gitea.louconnect.fr/Sar_Tron/VoteNetwork[/CENTER] + +[CENTER][B]⚠ 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.[/B][/CENTER] + +[HR][/HR] +[SIZE=4][B]Pourquoi VoteNetwork ?[/B][/SIZE] + +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 : + +[LIST] +[*]Joueur connecte -> recompense [B]instantanee[/B] sur son serveur actuel, sans toucher a la base de donnees. +[*]Joueur deconnecte -> vote stocke automatiquement, recuperable plus tard via [B]/claim[/B]. +[*]VoteParty [B]independant par serveur[/B] (chaque mode de jeu a son propre objectif et ses propres recompenses). +[*]Mode maintenance pour bloquer /claim pendant un reset sans desinstaller le plugin. +[/LIST] + +[HR][/HR] +[SIZE=4][B]Fonctionnalites[/B][/SIZE] + +[LIST] +[*][B]Vote direct en jeu[/B] via Plugin Messaging (canal custom, aucune latence de base de donnees si le joueur est en ligne). +[*][B]Votes en attente[/B] stockes en MySQL (partage reseau) ou en YAML local, au choix. +[*][B]Portee configurable[/B] 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). +[*][B]VoteParty local[/B] par serveur : seuil, commandes et messages 100% personnalisables, persistant au redemarrage. +[*][B]Liste de commandes[/B] entierement configurable pour chaque vote et pour le declenchement du VoteParty. +[*][B]Message broadcast[/B] optionnel a chaque vote/claim, personnalisable. +[*][B]Mode maintenance[/B] (/vote stop|start) pour bloquer /claim proprement pendant un reset. +[*][B]Commande de diagnostic[/B] (/vote testdb) pour verifier la connexion MySQL ou l'acces au fichier YAML sans redemarrer. +[*][B]API Java publique[/B] (+ enregistrement ServicesManager Bukkit) pour lire l'etat du vote depuis un autre plugin. +[*][B]Support PlaceholderAPI[/B] natif : %votenetwork_voteparty_current%, %votenetwork_voteparty_required%, %votenetwork_voteparty_remaining%, %votenetwork_maintenance%, %votenetwork_pending% — pour scoreboard, tab, GUI, sans coder une ligne. +[*][B]Merge automatique de config[/B] : les nouvelles options ajoutees par une mise a jour n'ecrasent jamais tes reglages existants. +[*]Compatible [B]Java 17[/B], du [B]1.18[/B] aux versions les plus recentes (API additive, testee en production). +[/LIST] + +[HR][/HR] +[SIZE=4][B]Installation[/B][/SIZE] + +[LIST=1] +[*][B]VoteNetwork-Velocity.jar[/B] -> dossier plugins/ du proxy Velocity. +[*][B]VoteNetwork-Spigot.jar[/B] -> dossier plugins/ de CHAQUE serveur de jeu (aucune limite de nombre). +[*]Demarrer une fois pour generer les configs, puis editer : + [LIST] + [*]Proxy : plugins/votenetwork/config.properties + [*]Serveur : plugins/votenetwork/config.yml + [/LIST] +[*]Renseigner [B]les memes identifiants MySQL[/B] 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. +[*]Redemarrer. La table est creee automatiquement, aucun script SQL a lancer a la main. +[/LIST] + +[HR][/HR] +[SIZE=4][B]Commandes & permissions[/B][/SIZE] + +[TABLE] +[TR][TD][B]Commande[/B][/TD][TD][B]Ou[/B][/TD][TD][B]Qui[/B][/TD][TD][B]Description[/B][/TD][/TR] +[TR][TD]votenetwork vote [/TD][TD]Velocity[/TD][TD]Console uniquement[/TD][TD]Enregistre un vote pour le joueur[/TD][/TR] +[TR][TD]/claim[/TD][TD]Spigot[/TD][TD]Joueurs[/TD][TD]Recupere les votes en attente[/TD][/TR] +[TR][TD]/vote stop|start[/TD][TD]Spigot[/TD][TD]votenetwork.admin (op)[/TD][TD]Bascule le mode maintenance[/TD][/TR] +[TR][TD]/vote testdb[/TD][TD]Spigot[/TD][TD]votenetwork.admin (op)[/TD][TD]Teste le stockage configure[/TD][/TR] +[/TABLE] + +[HR][/HR] +[SIZE=4][B]Pre-requis[/B][/SIZE] + +[LIST] +[*]Un proxy [B]Velocity[/B] + au moins un serveur [B]Spigot/Paper 1.18+[/B]. +[*]Une base [B]MySQL[/B] accessible depuis le proxy ET tous les serveurs (ou stockage YAML local pour un usage solo/test uniquement). +[*][B]Java 17[/B] minimum. +[*][I]Optionnel[/I] : PlaceholderAPI pour les placeholders de scoreboard. +[/LIST] + +[HR][/HR] +[CENTER]Code source complet et documentation detaillee (config avancee, portee per-server, API) disponibles sur le depot Git : [B]https://gitea.louconnect.fr/Sar_Tron/VoteNetwork[/B] + +Bugs / suggestions -> ouvrez une issue sur le depot. + +Licence MIT — libre d'utilisation, modification et redistribution avec attribution.[/CENTER]