Vote System
L'extension Vote System permet d'organiser des sondages à l'échelle du serveur. Créez des votes avec des options personnalisées, fixez des échéances et laissez les joueurs déposer leur bulletin.
- Code source — Voir les sources sur GitHub.
- Télécharger les releases — Obtenir les derniers JAR.
Fonctionnalités
- Sondages personnalisés — Jusqu'à 10 options par vote.
- Échéances — Dates de clôture automatique.
- Persistance — Les votes survivent aux redémarrages.
- Résultats en direct — Données de placeholders en temps réel.
Entrées
L'extension s'organise autour d'un VoteService central, avec une entrée par responsabilité :
| Entry | Type | Description |
|---|---|---|
vote_definition | Manifest | Configuration du sondage : options, échéance, messages. |
vote_config | Manifest | Paramètres globaux du système de vote. |
vote_action | Action | Dépose un bulletin pour le joueur déclencheur. |
vote_message | Action | Envoie les messages de statut/résultat du vote. |
vote_data | Artifact | Bulletins et résultats persistants. |
vote_fact | Fact | Expose l'état de vote d'un joueur aux critères (conditionner du contenu au fait d'avoir voté). |
vote_cast_event | Event | Se déclenche au dépôt d'un bulletin — branchez-y des déclencheurs de suivi. |
Démarrage rapide
- 1. Définir — Ajoutez les entrées de définition : vote_definition. Elles définissent les structures, entités ou règles sur lesquelles l'extension opère. → vote_definition
- 2. Créer le stockage — Ajoutez des entrées d'artefact pour persister les données : vote_data. → vote_data
- 3. Déclencher des actions — Utilisez les entrées d'action pour interagir avec l'extension : vote_action. Déclenchez-les depuis des commandes, des PNJ, des événements ou d'autres entrées. → vote_action
Commandes
Préfixe : /tw vote
| Commande | Description |
|---|---|
/tw vote <id> <option> | Déposer un vote. |
/tw vote stats <id> | Consulter les résultats. |
/tw vote reset <id> | Effacer les votes. |
Placeholders
Préfixe : %typewriter_vote_*%
| Placeholder | Description |
|---|---|
%typewriter_vote_display_<id>% | Titre du sondage. |
%typewriter_vote_total_<id>% | Nombre total de votes. |
%typewriter_vote_stats_<id>_<option>% | Décompte d'une option. |
Permissions
| Permission | Description |
|---|---|
typewriter.vote | Accès de base aux commandes de vote. |
typewriter.vote.cast | Déposer un vote. |
typewriter.vote.stats | Consulter les statistiques de vote. |
typewriter.vote.reset | Réinitialiser les données de vote. |