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	重置投票数据。

版本与兼容性

项目	参考
Version	v0.6 (官方已发布 release): release
TypeWriter	请使用此扩展所需的官方 TypeWriter release。
关联扩展	请参考详细页面中的依赖和关联扩展。