Vote System

VoteSystem

VoteSystem vérifie les votes de votre serveur sur Top-Serveurs, Top-Games et RustServers. Il conserve les points de vote de chaque joueur et peut les transmettre à CustomRewards ou verser une récompense avec Economics. Ces deux intégrations sont optionnelles.

Version 2.1.5. Installez deploy/VoteSystem.cs dans oxide/plugins/. N’installez pas séparément les fichiers du dossier src/.

Dans le configurateur

Sites de vote résume les trois fournisseurs : état et points par vote. Cliquez sur Configurer pour renseigner le token et la page de vote du site choisi. L’adresse technique de l’API reste repliée ; modifiez-la uniquement si le fournisseur le demande. Les intégrations et la fréquence de vérification se règlent dans les autres onglets.

Configurer les votes

Tous les sites sont désactivés au départ. Dans oxide/config/VoteSystem.json, choisissez les sites utilisés, renseignez leurs tokens API, réglez les points par vote, puis activez-les. Gardez les tokens privés. L’intervalle de vérification doit être d’au moins 15 secondes.

Sur TopServer et TopGames, les joueurs saisissent leur SteamID64 dans le champ pseudo/nom du joueur du site de vote. Les points sont automatiquement attribués à ce compte Steam. Aucun dictionnaire de pseudos à remplir par l’administrateur n’est nécessaire.

Pour permettre plutôt les votes avec le pseudo du serveur, activez `Enable nickname votes` pour le site concerné. VoteSystem cherche le nom exact d’un joueur connu du serveur Rust, sans recherche partielle. Si deux comptes portent ce nom, le vote attend au lieu d’en choisir un. Les nouveaux votes non résolus sont conservés et réévalués lors de la prochaine vérification ou à la connexion du joueur.

Les votes par pseudo sont moins fiables : un pseudo librement saisi ne prouve pas qui a voté. Quelqu’un peut voter au nom d’un autre joueur. Gardez les votes par SteamID64 si vous ne voulez pas cette ambiguïté. Aucun des deux modes ne prouve une authentification Steam OpenID sur Top-Serveurs ou Top-Games.

RustServers conserve son fonctionnement par classement SteamID. Son API nécessite l’authentification Steam OpenID du site de vote ; les lignes avec un pseudo seul sont rejetées. Aucun nouveau réglage n’est nécessaire pour ce site.

Récompenses

• CustomRewards fournit le catalogue et les récompenses en objets ou commandes. VoteSystem fournit les points, avec le type VoteSystem par défaut.
• Economics est optionnel. Désactivez son intégration si vous ne l’utilisez pas ; Multiplicator règle le dépôt pour chaque vote accepté.
• D’autres plugins peuvent utiliser les API de points et les hooks VoteSystem existants. La version de contrat 1 et la capacité vote-points-api ne changent pas.

Mise à jour depuis 2.1.3 ou 2.1.4

Sauvegardez la configuration et les dossiers oxide/data/VoteSystem/ et oxide/data/VoteSystem_nodelete/ avant de remplacer le plugin.

Les anciennes associations explicites de pseudos sont lues une fois pour transférer leurs soldes enregistrés au compte Steam indiqué. Les identifiants des votes historiques sont inclus pour ne pas créditer ces votes à nouveau. Les associations migrées avec succès sont retirées de la configuration. Les fichiers de pseudos d’origine restent intacts ; aucun ancien paiement Economics ni hook de récompense n’est rejoué.

Les anciens soldes de pseudos sans association ne sont pas attribués automatiquement, même si un joueur utilise maintenant ce nom. Les fichiers bruts des versions antérieures à V2 sont également conservés, sans import ni attribution supposée. Si la migration signale une erreur, ce site reste bloqué jusqu’à l’examen des données d’origine ; ne supprimez pas des fichiers pour faire disparaître l’erreur.

Wipes et récupération

votesystem.wipe démarre une nouvelle génération de wipe persistante. votesystem_wipe reste son alias historique. Les deux nécessitent un administrateur Rust ou votesystem.admin. OnNewSave demande la même opération. Les anciennes réponses réseau sont rejetées et les vérifications RustServers reprennent après l’enregistrement de leur nouveau point de départ. Les API de points et les attributions CustomRewards restent indisponibles tant que cette étape n’est pas terminée.

TopServer et TopGames conservent leurs totaux cumulés. Le propriétaire d’un nouveau vote Top est journalisé avant l’écriture du compteur Steam. Les répétitions, changements de pseudo et redémarrages ne peuvent pas déplacer ce vote vers un autre compte. Un vote inachevé d’un wipe précédent reste conservé mais n’est pas crédité dans le nouveau wipe ; les soldes déjà enregistrés ne changent pas.

Les votes Top et leurs compteurs sont enregistrés atomiquement avant les hooks ou dépôts. RustServers ne publie son nouvel état en mémoire qu’après la réussite des deux écritures requises ; ce n’est pas une transaction atomique entre fichiers. Si ces fichiers divergent après un redémarrage, ses points restent indisponibles jusqu’à la prochaine vérification réussie. Les effets des plugins externes ne sont pas non plus transactionnels : un crash après l’enregistrement du compteur peut faire manquer une notification ou un paiement. Ils ne sont pas rejoués automatiquement, pour éviter les doubles paiements. Les hooks et les dépôts Economics nécessitent toujours que le joueur soit connecté au moment où le vote est accepté ; ses points enregistrés restent disponibles à son retour. Examinez une erreur journalisée avant toute correction manuelle.

Pour modifier ou restaurer les données, déchargez VoteSystem, intervenez sur les fichiers, puis rechargez-le. Le plugin garde un état en mémoire ; modifier les fichiers pendant son fonctionnement n’est pas pris en charge. Un registre Steam manquant, corrompu ou remplacé ne peut pas être reconstruit en devinant son contenu à partir des journaux de propriété.

La compilation hors ligne et les tests ciblés couvrent les fichiers de cette version. Les réponses réelles des sites, les appels aux plugins optionnels, les hooks de wipe et les effets en jeu restent à vérifier sur un serveur.