常见问题

下面汇总了使用 JoyMart 时的常见问题与解答。点击问题展开查看答案。

Q: 玩家进游戏后背包被清空了？

A: 这是设计行为——进入 JoyMart 时会保存并清空背包，离开时自动还原。如果服务器异常崩溃导致背包没还原，重启后玩家重新进一次 JoyMart 再离开即可恢复。

Q: 双人邀请发出去对方没收到？

A: 检查 config.yml 的 invitations.style 设置（json / actionbar / title），以及对方是否在同一个服务器（跨服邀请需要 MySQL 模式 + BungeeCord 事件转发，本版本暂不内置跨服邀请转发）。

Q: 商店商品点击没反应？

A: 检查 tokenShop.yml 缩进是否正确，以及商品的 buyPermission 是否被权限插件正确分配。

Q: 上架 / 下架时光标物品消失了？

A: 早期版本在 InventoryClickEvent 内同步修改光标，会和客户端预测冲突导致物品"卡没"。本版本已将所有光标修改和 build() 调用包裹在 Bukkit.getScheduler().runTask() 中延迟到下一 tick 执行，彻底解决该问题。如果你仍遇到，请确认 jar 文件已替换为最新构建版本。

详见 配置文件说明 - 商店管理 GUI 中的"上架 / 下架修复说明"。

Q: 彩票 / 抽奖机的奖项怎么改？

A: 管理员执行 /gba games → 选择对应游戏 → 点击 奖项池 按钮，在 GUI 中可视化增删奖项、调整权重和奖励即可，保存后自动写入对应游戏 config.yml，无需手改文件。

奖项池的配置文件格式见 配置文件说明 - 彩票 / 抽奖机的奖项池配置。

Q: 迷宫太简单 / 太难？

A: 迷宫大小写死为 9×9（递归回溯法保证唯一通路）。如需调整，可修改 MazeSession.java 中的 n 常量并重新构建。

Q: 如何添加自己的语言？

A: 复制 plugins/JoyMart/language/language_en.yml 为 language_xx.yml，翻译所有键值，然后在 config.yml 设置 language.default: xx。游戏专用语言文件位于 language/game_<游戏名>/language_xx.yml，同样复制翻译即可。

Q: 设置了中文但游戏内还是英文？

A: 确保 config.yml 中 language.default: zh，然后执行 /gba reload。插件会自动将 language_zh.yml 和各游戏的 language_zh.yml 复制到 plugins/JoyMart/language/ 目录。