集成与挂钩
JoyMart 与多款流行的 Spigot/Paper 插件集成。所有集成为可选 —— JoyMart 会在启动时自动检测它们。
PlaceholderAPI
安装 PlaceholderAPI 后，JoyMart 会注册以下占位符：
| 占位符 | 说明 |
|---|---|
%gamebox_tokens% | 当前玩家的代币余额 |
%gamebox_highscore_<id>% | 当前玩家在某款游戏中的最高分（例如 %gamebox_highscore_2048%） |
%gamebox_ingame% | 当前玩家是否在游戏中（true/false） |
实现位于 GameBoxPlaceholders.java。检测到 PlaceholderAPI 时会自动注册占位符。
Vault 经济
当 Vault 存在且 config.yml 中 economy.vault: true 时：
- 游戏可在发放代币的同时奖励金钱（金币）
- 代币商店可以收取金币
- 抽奖 / 老虎机奖池可包含金钱奖励
- 所有金钱操作都通过 Vault 的 Economy API 进行
注意
未安装 Vault 时，仅使用 JoyMart 内部的代币系统。
CalendarEvents
JoyMart 通过 CalendarEvents 实现季节性彩蛋。检测到 CalendarEvents 时：
- 节假日期间可能会出现特殊的主题游戏图标或消息
- 挂钩位于
CalendarEventsHook.java，会自动检测 —— 无需任何配置
bStats
JoyMart 使用 bStats 收集匿名使用统计：
- 默认启用（可在 config.yml 中通过
bstats: false禁用） - 上报内容：服务器版本、插件版本、游戏使用情况、存储类型
- 数据发送至 bStats.org，且完全匿名
提示
bStats 仅收集聚合的、匿名化的指标数据，不包含任何玩家个人信息或服务器敏感配置。
软依赖汇总
| 插件 | 是否必需 | 用途 |
|---|---|---|
| Vault | 可选 | 经济挂钩（金币） |
| PlaceholderAPI | 可选 | 占位符变量 |
| CalendarEvents | 可选 | 季节性彩蛋 |
| bStats | 内置 | 匿名指标 |