(LITE) ChatGames - 轻量聊天游戏

ChatGames 是一款为你的服务器聊天频道增添乐趣的插件，它提供了超过 18 种不同类型的迷你游戏，如解谜、数学、问答等，让玩家在等待或闲暇时也能互动娱乐。游戏可自动或手动触发，并支持高度自定义的奖励和消息。

💡核心特性

• 多种游戏类型：包含单词解谜（unscramble）、单词反转（unreverse）、快速反应（reaction）、填空（fillout）、随机字符（random）、数学运算（math）、变量求解（variable）、趣味问答（trivia）等。
• 全版本兼容：支持 Minecraft 1.8 至 1.21.X 版本。
• 自动与手动触发：可设置定时自动开始游戏，也可由管理员使用命令手动启动。
• 高度可配置：通过配置文件自定义游戏参数、奖励、消息和权限。
• 奖励系统：可为获胜者配置丰富的奖励，支持概率触发和权限检查。
• 数据统计：记录玩家获胜次数，并提供 PlaceholderAPI 占位符，方便在别处显示排行榜。
• 性能优化：专为高性能设计，不影响服务器运行。

🎮指令与权限

指令

• /chatgames (type) - 立即启动指定类型的游戏。
• /chatgames reload - 重载插件配置文件。
• /chatgames top - 查看游戏获胜点数排行榜。
• /chatgames toggle - 切换游戏自动开始功能。
• /chatgames help - 查看帮助信息。

权限节点

• chatgames.start.<type> - 允许启动特定类型的游戏（如 chatgames.start.math）。
• chatgames.start.* - 允许启动所有类型的游戏。
• chatgames.play - （可选）允许玩家参与游戏，取决于 config.yml 中的 use-permission-toplay 设置。
• chatgames.top - 允许使用 /chatgames top 指令。
• chatgames.toggle - 允许使用 /chatgames toggle 指令。
• chatgames.help - 允许查看帮助指令。
• chatgames.reload - 允许重载配置文件。

🔧配置概述

插件的主要配置通过以下几个 YAML 文件完成

config.yml

包含插件核心设置，例如

• disabled-worlds：禁用游戏的世界列表。
• prefix：插件消息前缀。
• min_players_online：触发游戏所需的最低在线玩家数。
• time_minutes：自动选择下一个游戏的间隔时间（分钟）。
• timeToGuess_seconds：玩家作答的时限（秒）。
• use-permission-toplay：是否启用 chatgames.play 权限来控制参与资格。
• 以及每个独立游戏的开关、难度、字符类型等详细设置。

words.yml

为部分单词类游戏（如 unscramble, unreverse）提供可用的单词库列表。

rewards.yml

配置玩家赢得游戏后获得的奖励。支持多种动作

• [playercmd]：以玩家身份执行命令。
• [consolecmd]：以控制台身份执行命令。
• [playermsg]：向玩家发送消息。
• [broadcast]：向全服广播消息。
• 可为奖励设置触发概率（如 10.0%~）和权限检查（如 has:test.permission）。

messages.yml

自定义游戏开始、玩家获胜、时间截止等所有情况下的提示消息。支持使用 <center> 标签使消息居中，并可使用如 %player%、%correct_answer% 等变量。

✨PlaceholderAPI 占位符

安装 PlaceholderAPI 后，可使用以下占位符：

• %chatgames_points% - 显示指定玩家的获胜点数。
• %chatgames_top_<1-10>% - 显示排行榜第 1-10 名玩家的名字。
• %chatgames_points_top_<1-10>% - 显示排行榜第 1-10 名玩家的点数。

例如，%chatgames_top_2% 将显示第二名玩家的名字。

❓常见问题与支持

• 如何新增游戏单词或问题？

在 words.yml 中对应游戏的 Words: 列表下添加新词，或在 config.yml 的 trivia 部分 data 下添加新的问答对。

• 如何设置只有特定玩家能获得高级奖励？

在 rewards.yml 中对应奖励命令的末尾添加权限检查，例如：- '[consolecmd] give %player% diamond_block 3 has:vip.reward'。

• 游戏不自动开始？

请检查 config.yml 中的 min_players_online 是否满足，以及游戏是否在 disabled-worlds 列出的世界中。

• 需要更多帮助或有新功能建议？

欢迎在插件发布页留下评论，或通过 Discord 获取支持。如果你喜欢这个插件，一个积极的评分将是对作者最大的鼓励！

请注意：本插件有免费版和高级版（Premium Version），高级版提供更多游戏和完整功能支持。