/// PIMPMYRUST PLUGIN

VoteCommands

Guide des réglages de VoteCommands pour cette version. Vérifiez la fiche du plugin avant de l'utiliser sur votre serveur.

Version: 1.0.1
Framework: oxide, carbon
Fichier principal: oxide/config/VoteCommands/Example_SkipNight.json

Configurer →Fiche du plugin →

Préparer votre fichier

Vérifiez la version installée
Ce guide décrit VoteCommands 1.0.1. Le configurateur doit utiliser cette même version.
Récupérez les réglages
Cliquez sur Importer, puis Depuis mon serveur. Choisissez les fichiers et confirmez leur chargement. Sélectionner un serveur ne remplace pas le document ouvert. Vous pouvez aussi importer des fichiers de cet appareil ou une configuration depuis Mes projets.
Modifiez et envoyez
Ajustez les réglages, corrigez les erreurs, puis utilisez Envoyer pour transmettre les fichiers au serveur choisi. Un conflit bloque l’envoi jusqu’à votre décision. Vous pouvez toujours exporter seulement les fichiers dont vous avez besoin.

Les envois au serveur disposent de sauvegardes privées. Enregistrer conserve votre travail dans Mes projets ; cette action n’envoie rien au serveur. Un téléchargement permet aussi de reprendre sans connexion.

Réglages de cette version

Général 11

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

SchemaVersion

Valeurs possibles : 3

Nombre minimum de votes

Nombre entier · obligatoire

Nombre minimum de bulletins nécessaire pour exécuter les actions gagnantes. Même avec 0, une session sans aucun vote n’exécute rien.

Chemin JSON

MinimumParticipation

Minimum : 0 · Maximum : 10000

Résultat en cas d’égalité

Choix · obligatoire

cancel annule le résultat en cas d’égalité ; first retient le premier choix à égalité dans la liste. Sans aucun vote, aucune action n’est exécutée.

Chemin JSON

TieRule

Valeurs possibles : cancel, first

Afficher les résultats pendant le vote

Activé / désactivé · obligatoire

Afficher le nombre de votes pendant la session. Désactivez pour ne pas montrer les scores en cours aux joueurs.

Chemin JSON

ShowLiveResults

Activer

Activé / désactivé · obligatoire

Activer ce contrôleur de vote. Chaque fichier de configuration correspond à un contrôleur indépendant, avec ses propres choix et commandes.

Chemin JSON

Enabled

Démarrage automatique

Activé / désactivé · obligatoire

Lancer le premier vote après le chargement ou rechargement de ce contrôleur, en respectant DelayBeforeAutomaticStart. Désactivé, il faut le lancer manuellement ; la répétition se règle séparément.

Chemin JSON

AutomaticStart

Répéter les sessions de vote

Activé / désactivé · obligatoire

Après le premier démarrage manuel ou automatique, relancer un vote à chaque TimeBetweenSessions. Désactivé, le démarrage n’ouvre qu’une seule session.

Chemin JSON

AutomaticSessions

Délai avant le démarrage automatique (secondes)

Nombre entier · obligatoire

Attente en secondes après le chargement du contrôleur avant le premier vote automatique. Utilisé seulement si le démarrage automatique est activé.

Chemin JSON

DelayBeforeAutomaticStart

Commande de démarrage du vote

Texte · obligatoire

Alias chat réservé au démarrage de ce contrôleur par un administrateur Rust, sans / initial. Choisissez un alias unique et différent de la commande d’ouverture du bulletin.

Chemin JSON

CommandForStartSessions

Commande d’ouverture du vote

Texte · obligatoire

Alias chat qui ouvre le bulletin pendant une session, sans / initial. Voter reste soumis à VoteCommands.<nom du fichier>.Vote (ou au statut administrateur) ; ouvrir le bulletin ne lance pas une session.

Chemin JSON

CommandForUi

Intervalle entre les débuts de session (secondes)

Nombre · obligatoire

Temps entre les débuts de votes répétés, pas délai après le résultat. N’agit que si AutomaticSessions est activé et doit dépasser VoteDurationSeconds.

Chemin JSON

TimeBetweenSessions

Minimum : 0

Déroulement et choix du vote 2

Durée du vote (secondes)

Nombre entier · obligatoire

Temps laissé aux joueurs pour voter, en secondes. À la fin, le contrôleur calcule le gagnant ; l’intervalle de répétition doit dépasser cette durée.

Chemin JSON

CommandsConfiguration → VoteDurationSeconds

Minimum : 10 · Maximum : 3600

Choix proposés au vote

Liste d’objets · obligatoire

Choix proposés sur le bulletin, dans l’ordre de la liste. Chaque entrée contient son nom, son image et ses actions gagnantes ; l’image et le nom ne sont pas eux-mêmes des commandes.

Chemin JSON

CommandsConfiguration → VoteCommands

Bouton de fermeture 2

Taille: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → CloseButtonConfiguration → Size
Adresse de l’image: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → CloseButtonConfiguration → ImageUrl

Compte à rebours 4

Ancrage minimum: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → CountDownConfiguration → AnchorMin
Ancrage maximum: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → CountDownConfiguration → AnchorMax
Décalage minimum: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → CountDownConfiguration → OffsetMin
Décalage maximum: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → CountDownConfiguration → OffsetMax

Titre du vote 1

Hauteur: Nombre · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → TitleConfiguration → Height

Présentation des choix 4

Marge verticale: Nombre · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → MarginHeight
Marge horizontale: Nombre · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → MarginWidth
Couleur de fond: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → BackgroundColor
Espacement entre les choix: Nombre · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → MarginBetweenCommands

Fenêtre du vote 4

Largeur: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → WindowConfiguration → Width
Hauteur: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → WindowConfiguration → Height
Adresse de l’image de fond: Valeur JSON · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → WindowConfiguration → BackgroundImageUrl
Couleur de fond: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → WindowConfiguration → BackgroundColor

Compte à rebours · Style du texte 4

Taille du texte: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → CountDownConfiguration → LabelConfiguration → FontSize
Couleur du texte: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → CountDownConfiguration → LabelConfiguration → Color
Police de caractères: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → CountDownConfiguration → LabelConfiguration → Font
Alignement du texte: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → CountDownConfiguration → LabelConfiguration → TextAnchor

Titre du vote · Style du texte 4

Taille du texte: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → TitleConfiguration → LabelConfiguration → FontSize
Couleur du texte: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → TitleConfiguration → LabelConfiguration → Color
Police de caractères: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → TitleConfiguration → LabelConfiguration → Font
Alignement du texte: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → TitleConfiguration → LabelConfiguration → TextAnchor

Apparence d’un choix 4

Marge intérieure: Nombre · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → Padding
Couleur de fond: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → BackgroundColor
Taille de la zone du nombre de votes: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → VotesCountSize
Hauteur de l’image: Nombre · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → ImageHeight

Style du nom du choix 4

Taille du texte: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → NameLabelConfiguration → FontSize
Couleur du texte: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → NameLabelConfiguration → Color
Police de caractères: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → NameLabelConfiguration → Font
Alignement du texte: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → NameLabelConfiguration → TextAnchor

Style du nombre de votes 4

Taille du texte: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → VotesCountLabelConfiguration → FontSize
Couleur du texte: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → VotesCountLabelConfiguration → Color
Police de caractères: Texte · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → VotesCountLabelConfiguration → Font
Alignement du texte: Nombre entier · obligatoire
Réglage de l’ancienne interface conservé dans le fichier, mais non utilisé par VoteCommands 1.0.1 : le modifier n’a pas d’effet visuel. Réglez l’interface de cette bêta dans PimpMyCUI Editor.
Chemin JSON
UIConfiguration → VoteCommandsConfiguration → VoteCommandConfiguration → VotesCountLabelConfiguration → TextAnchor

Instructions du plugin

VoteCommands 1.0.1 bêta — installation et votes

VoteCommands permet aux joueurs de choisir entre les actions que vous définissez, puis exécute celle qui gagne. Cette bêta affiche son interface avec PimpMyCUI : installez ce plugin séparément dans une version compatible. EventManager n’est nécessaire que si une de vos actions s’adresse à ce plugin.

Configurer les choix du vote

Dans Vote, le tableau présente chaque choix et le nombre de commandes ou d’appels de plugins actifs. Cliquez sur son nom pour modifier sa présentation, ou sur Actions pour définir ce qui s’exécute si ce choix gagne. Ajouter un choix crée une nouvelle option. Une action ajoutée reste désactivée tant que vous ne l’activez pas ; vérifiez ses paramètres avant de l’utiliser.

Installer et lancer le premier vote

Sauvegardez oxide/config/VoteCommands/, puis installez PimpMyCUI.cs et VoteCommands.cs dans le dossier plugins du serveur.
Dans le configurateur, importez le vote à modifier ou choisissez un exemple. Gardez le démarrage automatique désactivé pour le premier test. Vérifiez chaque commande du gagnant avant de l’activer.
Exportez le fichier dans le chemin indiqué, par exemple oxide/config/VoteCommands/Example.json. Chaque fichier définit un vote avec ses propres commandes et permissions.
Rechargez VoteCommands depuis la console serveur. Pour un fichier Example.json, accordez les permissions ci-dessous : .Vote aux participants et .Start seulement aux joueurs autorisés à lancer un vote.

oxide.reload VoteCommands
oxide.grant group default VoteCommands.Example.Vote
oxide.grant user <STEAM64_ID> VoteCommands.Example.Start

Remplacez Example par le nom exact de votre fichier sans .json. Le groupe default permet à tous les joueurs de participer ; n’accordez pas .Start à tous sans le vouloir.

Dans le chat en jeu, utilisez la Commande de lancement du vote, précédée de /. Ouvrez sa Commande d’affichage, votez puis attendez la fin de la session. La commande administrateur /votecommands status affiche les votes chargés ; elle demande le rôle admin Rust ou votecommands.admin.
Si le résultat convient, définissez le démarrage automatique voulu. Sans vote, aucune action du gagnant ne s’exécute. Un test peut modifier le monde si vous activez une vraie commande de victoire : utilisez un serveur privé.

Délais et actions du gagnant

La bêta 1.0.1 poursuit les votes répétitifs après la deuxième session. L’intervalle se mesure entre les débuts de session ; annuler un vote conserve la planification, tandis qu’un déchargement/rechargement arrête les timers. Dans l’exemple, Day passe au matin et Night ne change pas l’heure. Le Hub laisse l’action Day désactivée jusqu’à votre choix de l’activer.

Un fichier JSON sous oxide/config/VoteCommands/ définit un contrôleur de vote. Son nom entre dans celui des permissions ; gardez des noms de fichiers et de commandes de chat uniques. À la première installation, le plugin crée Example.json avec démarrage manuel et toutes les commandes de victoire désactivées. Modifiez-le puis rechargez le plugin avant un vrai vote.

SchemaVersion doit valoir 3. Choisissez CuiTemplate parmi operations-console, civic-ballot, relay-grid, arctic-council, field-terminal ou broadcast-panel ; choisissez CuiPresentation (windowed/fullscreen) et CuiDecoration (rich/light). CuiDocument est un document runtime PimpMyCUI facultatif pour ce profil intégré précis. Omettez-le ou mettez null pour utiliser le document intégré. Un document non nul incompatible bloque l’ouverture, sans repli. Les autres réglages et les actions de victoire restent dans ce fichier.

L’éditeur peut modifier l’aspect visuel, ajouter des éléments décoratifs ou des boutons de fermeture et supprimer des éléments. Les éléments d’action existants doivent conserver leurs identifiants, leur type et leurs liaisons ; les chemins de modèle doivent provenir du document intégré. Exportez le JSON complet vers le nom du contrôleur. Installer seulement un projet ou package PimpMyCUI ne change pas VoteCommands.

Lorsque ShowContextImage est activé avec CuiDecoration: "rich", chaque choix doit fournir une ImageUrl HTTPS valide et une ImageAspectRatio positive et finie : la largeur de l’image divisée par sa hauteur. Une illustration de 1600 × 900 pixels a par exemple un ratio de 1.7777777777777777. Ajoutez cette valeur aux contrôleurs existants qui utilisent une image personnalisée ; aucun ratio n’est deviné. Les profils light ou sans images de contexte utilisent l’illustration intégrée mesurée, sans exiger de ratio personnalisé. Les délais, les votes et les actions de victoire ne changent pas.

Mise à jour depuis la version native 0.2.0 ou une ancienne version 0.1.x ou un ancien contrat de contrôleur : conservez une sauvegarde, partez d’un exemple actuel en schéma 3 et reportez manuellement les délais, les choix et les actions du gagnant. Les anciens JSON sont rejetés, sans migration automatique. Si un fichier intermédiaire du schéma 2 contient CuiTheme et CuiLayoutTemplate, remplacez-les par un CuiTemplate choisi après vérification. Sans vote, aucune action du gagnant ne s’exécute, même avec TieRule à first et MinimumParticipation à zéro. CuiDocument est facultatif et nécessite une prise en charge compatible dans VoteCommands et PimpMyCUI.

Installer les fichiers

Avec un serveur connecté, cliquez sur Envoyer dans le configurateur. Le résultat indique si les fichiers ont été envoyés et si le plugin a été rechargé. Sans RCON, rechargez le plugin depuis votre panneau serveur après l’envoi.

Sans serveur connecté : Conservez une copie des fichiers actuels. Placez chaque fichier exporté dans le dossier indiqué avant l’export, ou reprenez les chemins du ZIP. Ne placez pas les données ou les traductions dans le dossier config.

Suivez les instructions du plugin ci-dessus pour ses dépendances et son rechargement. L’export ne connecte pas le site à votre serveur.

Guide de configuration et d’envoi →