/// PIMPMYRUST PLUGIN
Vote System
Guide des réglages de Vote System pour cette version. Vérifiez la fiche du plugin avant de l'utiliser sur votre serveur.
Préparer votre fichier
- Vérifiez la version installée
Ce guide décrit Vote System 2.1.3. Le configurateur doit utiliser cette même version.
- Importez votre configuration
Ouvrez le configurateur et importez le JSON actuel. Pour une nouvelle installation, vous pouvez partir de l’exemple proposé.
- Modifiez et téléchargez
Ajustez les réglages, corrigez les erreurs signalées et téléchargez le JSON. Gardez une copie de votre ancien fichier avant de le remplacer.
Votre configuration n’est pas sauvegardée sur le site. Conservez le fichier exporté ; il permet aussi de reprendre plus tard.
Réglages de cette version
Général 1
- Version du format de configuration
- Choix · obligatoire
Repère interne du format de configuration. Conservez la valeur fournie pour cette version du plugin.
Chemin JSON
Data VersionValeurs possibles : 2
CustomRewards 2
- Activer
- Activé / désactivé · obligatoire
Transmettre les points de vote au type de récompense CustomRewards configuré. CustomRewards doit être installé ; cette intégration est optionnelle.
Chemin JSON
Plugin Extensions → CustomRewards → Enabled - Type de récompense CustomRewards
- Texte · obligatoire
Nom exact du type de récompense utilisé par l’intégration, sans .json.
Chemin JSON
Plugin Extensions → CustomRewards → Custom Rewards Template Name
Economics 2
- Activer
- Activé / désactivé · obligatoire
Déposer un montant Economics à partir des points de vote et du multiplicateur. Economics doit être installé ; désactivez si vous n’utilisez pas cette monnaie.
Chemin JSON
Plugin Extensions → Economics → Enabled - Multiplicateur du dépôt Economics
- Nombre entier · obligatoire
Convertit les points de vote acceptés en montant à déposer.
Chemin JSON
Plugin Extensions → Economics → MultiplicatorMinimum : 1 · Maximum : 1000000
RustServers 5
- Activer
- Activé / désactivé · obligatoire
Interroger RustServers pour les nouveaux votes. Activez seulement après avoir renseigné les identifiants de votre serveur sur ce site.
Chemin JSON
Vote Servers Settings → RustServers → Enabled - Adresse de l’API du site de vote
- Texte · obligatoire
Adresse de l’API RustServers utilisée pour vérifier les votes. Conservez l’adresse prévue pour ce fournisseur, pas l’adresse publique de votre fiche serveur.
Chemin JSON
Vote Servers Settings → RustServers → API Url - Token API
- Texte · obligatoire
Secret fourni par le service de vote. Il est masqué dans le formulaire.
Chemin JSON
Vote Servers Settings → RustServers → API Token - Points attribués par vote
- Nombre entier · obligatoire
Points internes attribués pour chaque nouveau vote accepté sur ce site. Les intégrations utilisent ces points ; ce n’est pas directement une quantité d’objets.
Chemin JSON
Vote Servers Settings → RustServers → Points by voteMinimum : 1 · Maximum : 1000000
- Associations pseudo → identifiant Steam
- Valeur JSON · obligatoire
Associez chaque pseudo à l’identifiant Steam du joueur concerné. Ne modifiez pas une association pour déplacer un solde.
Chemin JSON
Vote Servers Settings → RustServers → Nickname to Steam ID bindings
TopGames 5
- Activer
- Activé / désactivé · obligatoire
Interroger TopGames pour les nouveaux votes. Activez seulement après avoir renseigné les identifiants de votre serveur sur ce site.
Chemin JSON
Vote Servers Settings → TopGames → Enabled - Adresse de l’API du site de vote
- Texte · obligatoire
Adresse de l’API TopGames utilisée pour vérifier les votes. Conservez l’adresse prévue pour ce fournisseur, pas l’adresse publique de votre fiche serveur.
Chemin JSON
Vote Servers Settings → TopGames → API Url - Token API
- Texte · obligatoire
Secret fourni par le service de vote. Il est masqué dans le formulaire.
Chemin JSON
Vote Servers Settings → TopGames → API Token - Points attribués par vote
- Nombre entier · obligatoire
Points internes attribués pour chaque nouveau vote accepté sur ce site. Les intégrations utilisent ces points ; ce n’est pas directement une quantité d’objets.
Chemin JSON
Vote Servers Settings → TopGames → Points by voteMinimum : 1 · Maximum : 1000000
- Associations pseudo → identifiant Steam
- Valeur JSON · obligatoire
Associez chaque pseudo à l’identifiant Steam du joueur concerné. Ne modifiez pas une association pour déplacer un solde.
Chemin JSON
Vote Servers Settings → TopGames → Nickname to Steam ID bindings
TopServer 5
- Activer
- Activé / désactivé · obligatoire
Interroger TopServer pour les nouveaux votes. Activez seulement après avoir renseigné les identifiants de votre serveur sur ce site.
Chemin JSON
Vote Servers Settings → TopServer → Enabled - Adresse de l’API du site de vote
- Texte · obligatoire
Adresse de l’API TopServer utilisée pour vérifier les votes. Conservez l’adresse prévue pour ce fournisseur, pas l’adresse publique de votre fiche serveur.
Chemin JSON
Vote Servers Settings → TopServer → API Url - Token API
- Texte · obligatoire
Secret fourni par le service de vote. Il est masqué dans le formulaire.
Chemin JSON
Vote Servers Settings → TopServer → API Token - Points attribués par vote
- Nombre entier · obligatoire
Points internes attribués pour chaque nouveau vote accepté sur ce site. Les intégrations utilisent ces points ; ce n’est pas directement une quantité d’objets.
Chemin JSON
Vote Servers Settings → TopServer → Points by voteMinimum : 1 · Maximum : 1000000
- Associations pseudo → identifiant Steam
- Valeur JSON · obligatoire
Associez chaque pseudo à l’identifiant Steam du joueur concerné. Ne modifiez pas une association pour déplacer un solde.
Chemin JSON
Vote Servers Settings → TopServer → Nickname to Steam ID bindings
RustServers · Vérification des votes 1
- Intervalle de vérification (secondes)
- Nombre entier · obligatoire
Délai en secondes entre les vérifications de nouveaux votes sur ce site. Un intervalle plus court augmente les appels à son API et peut dépasser ses limites.
Chemin JSON
Vote Servers Settings → RustServers → Routine Settings → Check Interval (seconds)Minimum : 15 · Maximum : 86400
TopGames · Vérification des votes 1
- Intervalle de vérification (secondes)
- Nombre entier · obligatoire
Délai en secondes entre les vérifications de nouveaux votes sur ce site. Un intervalle plus court augmente les appels à son API et peut dépasser ses limites.
Chemin JSON
Vote Servers Settings → TopGames → Routine Settings → Check Interval (seconds)Minimum : 15 · Maximum : 86400
TopServer · Vérification des votes 1
- Intervalle de vérification (secondes)
- Nombre entier · obligatoire
Délai en secondes entre les vérifications de nouveaux votes sur ce site. Un intervalle plus court augmente les appels à son API et peut dépasser ses limites.
Chemin JSON
Vote Servers Settings → TopServer → Routine Settings → Check Interval (seconds)Minimum : 15 · Maximum : 86400
Instructions du plugin
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
- Sauvegardez
oxide/data/VoteSystemet la configuration existante. - Installez
VoteSystem.cs. - Installez CustomRewards seulement pour son intégration de points/récompenses.
- Installez Economics seulement pour les dépôts.
- Installez VoteReward en dernier si vous souhaitez les commandes
/voteet 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
VoteSystempar défaut. Le contrat et la capacité d’attribution de points sont vérifiés avant utilisation. - Economics : le multiplicateur convertit les points acceptés en montant à déposer. 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.
Installer le fichier
Après avoir conservé une copie de l’ancien fichier, placez le JSON exporté à cet emplacement sur votre serveur :
oxide/config/VoteSystem.jsonSuivez les instructions du plugin ci-dessus pour ses dépendances et son rechargement. L’export ne connecte pas le site à votre serveur.