Vote System
Расширение Vote System позволяет проводить опросы в масштабах всего сервера. Создавайте голосования с произвольными вариантами, задавайте сроки и позволяйте игрокам подавать голоса.
- Исходный код — Посмотреть исходники на GitHub.
- Скачать релизы — Получить свежие JAR-файлы.
Возможности
- Произвольные опросы — До 10 вариантов на голосование.
- Сроки — Автоматическое закрытие по дате.
- Постоянство — Голосования переживают перезапуски.
- Результаты в реальном времени — Данные плейсхолдеров в реальном времени.
Записи
Расширение построено вокруг центрального VoteService, по одной записи на каждую задачу:
| Entry | Type | Описание |
|---|---|---|
vote_definition | Manifest | Настройка опроса: варианты, срок, сообщения. |
vote_config | Manifest | Глобальные настройки системы голосования. |
vote_action | Action | Подаёт голос за игрока, вызвавшего действие. |
vote_message | Action | Отправляет сообщения о статусе/результатах голосования. |
vote_data | Artifact | Постоянные голоса и результаты. |
vote_fact | Fact | Открывает состояние голоса игрока для критериев (ограничение контента по факту голосования). |
vote_cast_event | Event | Срабатывает при подаче голоса — подключайте к нему последующие триггеры. |
Быстрый старт
- 1. Определите — Добавьте записи-определения: vote_definition. Они задают структуры, сущности или правила, с которыми работает расширение. → vote_definition
- 2. Создайте хранилище — Добавьте записи-артефакты для сохранения данных: vote_data. → vote_data
- 3. Запускайте действия — Используйте записи-действия для взаимодействия с расширением: vote_action. Запускайте их из команд, NPC, событий или других записей. → vote_action
Команды
Префикс: /tw vote
| Команда | Описание |
|---|---|
/tw vote <id> <option> | Подать голос. |
/tw vote stats <id> | Посмотреть результаты. |
/tw vote reset <id> | Очистить голоса. |
Плейсхолдеры
Префикс: %typewriter_vote_*%
| Плейсхолдер | Описание |
|---|---|
%typewriter_vote_display_<id>% | Название опроса. |
%typewriter_vote_total_<id>% | Всего голосов. |
%typewriter_vote_stats_<id>_<option>% | Количество по варианту. |
Права
| Permission | Описание |
|---|---|
typewriter.vote | Базовый доступ к командам голосования. |
typewriter.vote.cast | Подать голос. |
typewriter.vote.stats | Просматривать статистику голосования. |
typewriter.vote.reset | Сбрасывать данные голосования. |