Vote System

Vote System 2.1.3 — guide

Ce guide concerne la version Codefling 2.1.3. La bêta 2.1.4 corrige le traitement des réponses fournisseurs ; choisissez la configuration de la version installée sur votre serveur.

Installation et export

1. Sauvegardez oxide/data/VoteSystem et la configuration existante.
2. Installez VoteSystem.cs.
3. Installez CustomRewards seulement pour son intégration de points/récompenses.
4. Installez Economics seulement pour les dépôts.
5. Installez VoteReward en dernier si vous souhaitez les commandes /vote et une interface de récompenses. Ce pont exige VoteSystem et CustomRewards.

Le configurateur exporte VoteSystem.json, à installer dans oxide/config/VoteSystem.json ou le dossier config Carbon, puis rechargez le plugin. Gardez les fichiers exportés privés : ils contiennent les tokens saisis. Le site ne sauvegarde pas vos configurations sur son serveur.

Fournisseurs et identité

Tous les fournisseurs sont désactivés par défaut. Obtenez les tokens auprès de chaque fournisseur et ne les incluez jamais dans un exemple ou message de support public.

TopServer et TopGames utilisent des pseudos qui ne prouvent pas l’identité Steam. Ajoutez pour chacun les entrées Nickname to Steam ID bindings avant d’attendre des points attribués à un joueur. RustServers utilise l’identifiant Steam authentifié renvoyé par son classement Steam ; un pseudo seul est rejeté.

Pour chaque fournisseur sous Vote Servers Settings, vérifiez l’URL API, API Token, Points by vote, les associations et l’intervalle dans Routine Settings, puis activez-le. Commencez avec un seul fournisseur.

Points et récompenses

Plugin Extensions contrôle deux intégrations facultatives :

• CustomRewards : le type partagé est VoteSystem par défaut. Le contrat et la capacité d’attribution de points sont vérifiés avant utilisation.
• Economics : le montant déposé est le nombre de nouveaux votes acceptés multiplié par Plugin Extensions → Economics → Multiplicator, pas les points gagnés pour ces votes. Points by vote règle les points VoteSystem séparément. Par exemple, trois nouveaux votes avec un multiplicateur Economics de 100 donnent un dépôt de 300, quel que soit le réglage de points du fournisseur. Le vote est enregistré avant le dépôt.

VoteSystem est le collecteur et compteur de points, pas un catalogue d’objets. Pour donner des objets, configurez les récompenses dans CustomRewards ; VoteReward peut fournir l’ouverture de cette interface. Désactivez explicitement les intégrations inutilisées. En cas d’effet externe incertain, examinez le diagnostic de réconciliation avant une correction manuelle.

Maintenance et récupération

votesystem.wipe et son alias historique votesystem_wipe demandent un administrateur Rust ou votesystem.admin. Cette commande crée une nouvelle génération de wipe : collecte suspendue pendant l’opération, anciens callbacks ignorés et nouveau point de départ RustServers si ce fournisseur est actif.

Sauvegardez tout le dossier data avant modification d’identité, mise à jour ou réinitialisation. Conservez ensemble les fichiers pseudos, Steam, joueurs et wipe. Un état illisible nécessite la réparation ou restauration d’une sauvegarde complète ; ne déplacez pas un solde en changeant son association.

Dépannage et limites

• Fournisseur inactif : vérifier URL, token, intervalle et points.
• Vote Top sans effet joueur : vérifier l’association sous le bon fournisseur.
• Ligne RustServers rejetée : vérifier vote Steam OpenID et classement Steam.
• Effet Economics incertain : utiliser le diagnostic, sans relance aveugle.
• Collecte bloquée après wipe : restaurer l’état et obtenir un point de départ valide.

L’opérateur gère les comptes, limites et conditions des fournisseurs. Le plugin leur transmet le token serveur et les paramètres de collecte, pas les catalogues CustomRewards ni les soldes Economics. Le parcours réel des votes et le comportement Carbon doivent être éprouvés sur votre serveur.