主题
这页汇总 HNMail 当前版本已经实现的 PlaceholderAPI 占位符。
如果你只想快速确认某个 %hnmail_*% 会返回什么，这页可以直接当速查表使用。
前提：
- 已安装
PlaceholderAPI placeholder-api.enabled: true- HNMail 已成功注册占位符扩展
玩家相关占位符
%hnmail_unread%：未读邮件数%hnmail_has_unread%：是否有未读邮件，返回yes/no%hnmail_has_unread_text%：是否有未读邮件，返回有未读/无未读%hnmail_total%：总邮件数%hnmail_allow_player_mail%：是否允许玩家来信，返回on/off%hnmail_allow_player_mail_text%：是否允许玩家来信，返回允许/拒收
全局相关占位符
%hnmail_template_count%：已加载模板数量%hnmail_broadcast_job_count%：广播任务总数%hnmail_cleanup_enabled%：自动清理是否开启，返回on/off%hnmail_expire_days%：邮件过期天数%hnmail_player_send_enabled%：玩家主动发信是否开启，返回on/off
最新广播任务占位符
%hnmail_latest_broadcast_job%：最近一次广播任务 ID%hnmail_latest_broadcast_template%：最近一次广播使用的模板 key%hnmail_latest_broadcast_status%：最近一次广播任务状态原始值%hnmail_latest_broadcast_status_text%：最近一次广播任务状态文本%hnmail_latest_broadcast_mode%：最近一次广播模式原始值%hnmail_latest_broadcast_mode_text%：最近一次广播模式文本%hnmail_latest_broadcast_total%：最近一次广播目标总数%hnmail_latest_broadcast_success%：最近一次广播成功数%hnmail_latest_broadcast_failed%：最近一次广播失败数%hnmail_latest_broadcast_processed%：最近一次广播已处理数量%hnmail_latest_broadcast_success_rate%：最近一次广播成功率数值，不带%%hnmail_latest_broadcast_success_rate_text%：最近一次广播成功率文本，带%%hnmail_latest_broadcast_failed_rate%：最近一次广播失败率数值，不带%%hnmail_latest_broadcast_failed_rate_text%：最近一次广播失败率文本，带%%hnmail_latest_broadcast_created_at%：最近一次广播创建时间%hnmail_latest_broadcast_finished_at%：最近一次广播完成时间
说明
- 如果当前没有广播任务，部分
latest_broadcast_*占位符会返回空字符串或0 - 玩家相关占位符依赖玩家上下文；在无玩家上下文的位置使用时，可能返回空值
- 同一组语义可能同时提供原始值和文本值，例如
status/status_text、mode/mode_text - 一些布尔语义字段会返回
on/off、yes/no或中文文本，这是当前实现的既定格式 - 当前实现对占位符查询做了约 1 秒缓存，短暂延迟通常属于正常现象