CoinFlipper - 一掷千金

💡简介

CoinFlipper 是一款允许玩家进行“猜硬币”赌博游戏的插件。一名玩家下注一定金额并猜测硬币的朝向（正面或反面），另一名玩家可以接受挑战。胜者将赢得所有赌注，这意味着你可能会使赌注翻倍，也可能输掉一切。

🎮核心功能

• 投注与挑战：玩家可以创建投注，其他玩家则可通过点击游戏内界面（GUI）来发起挑战。
• 胜负判定：通过虚拟的抛硬币动画随机决定胜负，胜者获得全部赌注。
• 数据统计：插件会记录每位玩家的游戏历史与胜负统计。
• 自定义动画：支持创建和编辑独特的抛硬币动画效果。
• 权限与保护：集成权限系统，并兼容主流战斗标签插件，防止玩家在PVP时打开GUI。
• 数据库支持：支持使用 MySQL 或 SQLite 来存储玩家数据。

🔧命令与权限

注意：可使用 /cf 或 /coinflip 替代 /coinflipper。在命令中，可用 h 代表“heads”（正面），t 代表“tails”（反面）。

主要命令

• /coinflipper - 打开游戏主界面。
• 权限：coinflipper.gui
• 也可使用 /coinflipper gui
• /coinflipper help - 显示帮助信息。
• 权限：coinflipper.help
• /coinflipper [金额] [heads/tails] - 创建一个猜硬币游戏。
• 权限：coinflipper.create
• /coinflipper clear - 清除所有已创建的投注。
• 权限：coinflipper.clear
• /coinflipper stats - 查看自己的统计数据。
• 权限：coinflipper.stats
• 查看他人数据需额外权限：coinflipper.stats.other
• /coinflipper history - 查看自己的游戏历史。
• 权限：coinflipper.history
• 查看他人历史需额外权限：coinflipper.history.other
• /coinflipper animation - 创建、编辑或删除自定义动画。
• 权限：coinflipper.animation
• /coinflipper reload - 重新加载插件配置。
• 权限：coinflipper.reload
• /coinflipper config - 打开GUI配置编辑器。
• 权限：coinflipper.config

其他权限

• coinflipper.remove.self - 允许玩家在GUI中右键点击移除自己的投注。
• coinflipper.remove.other - 允许玩家在GUI中右键点击移除他人的投注。
• coinflipper.boost.percentage - 将玩家的获胜概率设置为指定数值（而非默认的50%）。例如，coinflipper.boost.70 会赋予该玩家70%的胜率。
• coinflipper.animations.name - 允许你设置该玩家投注时使用的动画效果。请将 name 替换为你想要的动画名称。

✨使用方法

• 创建投注：使用命令 /coinflipper [金额] [heads/tails] 来下注。
• 接受挑战：在游戏内打开GUI界面，左键点击一个投注即可发起挑战。
• 移除投注：

- 拥有 `coinflipper.remove.self` 权限的玩家，可在GUI中右键点击移除自己的投注。

- 拥有 `coinflipper.remove.other` 权限的玩家，可在GUI中右键点击移除他人的投注。

⭐概率加成系统

管理员可以通过权限为玩家设置获胜概率加成，其计算规则如下：

• 双方均无加成：双方获胜概率均为 50%。
• 仅一方有加成：有加成的玩家按其加成概率获胜，另一方的获胜概率则为 100% - 加成概率。
• 例如：玩家A有70%加成，玩家B无加成。则玩家A胜率为70%，玩家B胜率为30%。
• 双方均有加成：每位玩家的胜率为 自身加成值 / 双方加成值总和。
• 例如：玩家A加成70%，玩家B加成100%。则玩家A胜率为 70/(70+100) ≈ 41.2%，玩家B胜率为 100/(70+100) ≈ 58.8%。

⭐动画系统

玩家动画

通过授予玩家 coinflipper.animations.(动画名称) 权限，可以指定该玩家投注时使用的特定动画。

自定义动画

自版本 1.5 起，CoinFlipper 支持创建自定义抛硬币动画。

• 打开编辑器：使用命令 /coinflipper animation。
• 编辑器说明：
• 左键点击进入动画编辑器。
• 右键点击可将动画设为默认（默认动画在列表中会以粘土块而非火焰球图标显示）。
• 动画结构：每个动画由 50 帧组成。在第 30 帧时，会向获胜玩家播放胜利音效并发送胜利消息。
• 导入动画：将动画文件放入插件目录下的 animations 文件夹中，然后重启或重载服务器即可。

❓依赖与兼容性

必需依赖

• Vault：插件运行所必需的经济系统接口。点击此处获取

插件兼容性

CoinFlipper 兼容以下战斗标签插件，确保玩家在PVP时不会打开投注GUI：

• CombatTagPlus
• PvPManager (及其免费版本，目前2.7及以下版本可用)
• CombatLogX (10.x+ 版本)

可选支持

• Sign GUI：若想在 Minecraft 1.8-1.9 版本中使用告示牌GUI而非聊天栏输入，需要安装 ProtocolLib。

🔧安装指南

• 确保服务器已安装 Vault。
• 将 CoinFlipper 插件文件拖放至服务器的 plugins 文件夹。
• 重启服务器（注意：不是重载 /reload，否则可能导致 messages.yml 文件创建失败）。
• 插件将开始运行，你可以根据需要修改配置文件。

🔧MySQL 配置

自版本 1.84 起，插件支持使用 MySQL 存储统计数据。

• 在 config.yml 中，将 mysql_enabled 设置为 true。
• 编辑 mysql.yml 文件，填写你的数据库信息：

    server: '0.0.0.0:3306' # MySQL 服务器地址（及端口）
    database: 'coinflipper' # 插件使用的数据库名
    user: '用户名' # 数据库用户名
    password: '密码' # 对应用户的密码

• 插件需要数据库用户拥有在 coinflipper_stats 表上创建和写入的权限。
• 统计数据会被缓存以减轻服务器负载。
• 如果未启用 MySQL，自版本 2.2 起，插件将默认使用 SQLite。

⭐配置与消息文件

• 你可以使用 /coinflipper config 命令通过GUI编辑配置。
• 主配置文件参考：点击查看
• 消息文件参考：点击查看
• 自版本 2.81 起：在聊天消息中可以使用 %newline% 来换行（此功能不适用于标题，因为Minecraft标题仅支持一行副标题）。

💡注意事项

• 首次安装后必须重启服务器，仅使用 /reload 可能导致消息文件创建失败。
• 概率加成系统基于权限节点实现，请仔细配置。
• 自定义动画文件需放置于正确的 animations 文件夹内。

❓常见问题

Q：插件需要什么前置？

A：必须安装 Vault 以连接经济系统。

Q：如何防止玩家在打架时赌博？

A：插件已兼容主流战斗标签插件（如 CombatTagPlus, CombatLogX），会自动阻止在PVP状态打开GUI。

Q：支持哪些 Minecraft 版本？

A：插件致力于支持从 1.8 到最新版的主流服务端。

Q：数据统计存在哪里？

A：默认使用 SQLite，也可在配置中启用 MySQL。

Q：如何反馈BUG或寻求帮助？

A：请在插件讨论区发帖，请不要在评论区内报告错误，开发者不会在那里回复。

🔧其他信息

统计数据收集 (Metrics)

CoinFlipper 使用 bStats 收集匿名的服务器运行数据。你可以通过 plugins/bStats/config.yml 文件禁用此功能。要了解具体收集哪些数据，请访问：https://bstats.org/plugin/bukkit/CoinFlipper

开源与支持

• 源代码：https://github.com/gronnmann/CoinFlipper
• 捐赠支持：如果你觉得这个插件帮助了你的服务器，并希望支持其持续开发（包括向下兼容旧版本和修复漏洞），欢迎进行捐赠。捐赠链接

如果你喜欢这个插件，别忘了在发布页留下积极的评价！