Vote System
Vote System 拡張はサーバー全体でのアンケート実施を可能にします。任意の選択肢を持つ投票を作成し、締め切りを設定し、プレイヤーに一票を投じてもらえます。
- ソースコード — GitHub でソースを見る。
- リリースをダウンロード — 最新の JAR を入手する。
機能
- カスタムアンケート — 1 回の投票につき最大 10 択。
- 締め切り — 自動終了の日時。
- 永続性 — 投票は再起動後も保持されます。
- リアルタイム結果 — プレースホルダーによるリアルタイムのデータ。
エントリー
この拡張は中心となる VoteService を軸に構成され、関心事ごとに 1 つのエントリーがあります：
| 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 | 投票データをリセットする。 |