koishi-plugin-game-mini

项目介绍 (Project Introduction)

中文

这是一款为 Koishi 聊天机器人框架开发的轻量级多功能小游戏插件，包含经典猜数字、猜王者荣耀英雄、看图猜成语、成语接龙、算24点五款趣味游戏

English

This is a lightweight, multi-functional mini-game plugin developed for the Koishi chatbot framework. It includes five fun games: Guess the Number, Guess the King of Glory Hero, Guess the Idiom from the Picture, Idiom Chain, and 24 Points.

使用说明 (Usage)

中文

| 命令 (Command) | 功能说明 (Description) | | --- | --- | | 猜数字游戏 | | | 猜数字 开始 | 启动猜数字游戏，初始范围为配置的最小值-最大值 | | 直接输入数字 | 游戏运行时输入纯数字即可猜测，系统会实时提示“猜大了/猜小了”并缩小范围，或提示“猜对了”并开始新回合 | | 猜数字 结束 | 停止当前猜数字游戏 | | 王者英雄猜谜 | | | 猜王者英雄 开始 | 启动王者英雄猜谜游戏，使用配置的默认难度 | | 输入英雄名称 | 游戏运行时输入英雄名猜测答案，系统会返回结果提示 | | 输入“提示” | 获取当前英雄的线索提示（有次数限制） | | 猜王者英雄 结束 | 停止当前王者英雄猜谜游戏 | | 看图猜成语 | | | 看图猜成语 开始 | 启动看图猜成语游戏，获取初始题目和图片链接 | | 输入成语 | 游戏运行时输入猜测的成语答案 | | 输入“提示” | 获取当前题目的提示（使用配置的默认提示级别） | | 看图猜成语 结束 | 停止当前看图猜成语游戏 | | 成语接龙 | | | 成语接龙 开始 | 启动成语接龙游戏，Bot 先出第一个成语 | | 输入成语 | 直接输入成语参与接龙 | | 成语接龙 结束 | 停止当前成语接龙游戏 | | 算24点 | | | 算24点 开始 | 启动算24点游戏，使用配置的默认难度 | | 输入算式 | 输入算式如 (6-2)*(8-2)，支持小括号、中括号、大括号 | | 输入“换题” | 更换当前题目 | | 算24点 结束 | 停止当前算24点游戏 |

English

| Command | Description | | --- | --- | | Number Guessing Game | | | 猜数字 开始 | Start the number guessing game with the initial range of configured min-max values | | Enter number directly | Enter a pure number during the game to guess; the system will prompt "too big/too small" in real time and narrow the range, or prompt "correct" and start a new round | | 猜数字 结束 | Stop the current number guessing game | | King of Glory Hero Guessing | | | 猜王者英雄 开始 | Start the King of Glory hero guessing game, using the configured default difficulty | | Enter hero name | Enter the hero name to guess the answer during the game, the system will return result prompts | | Enter "提示" | Get clue hints for the current hero (limited times) | | 猜王者英雄 结束 | Stop the current King of Glory hero guessing game | | Idiom Guessing from Pictures | | | 看图猜成语 开始 | Start the idiom guessing game from pictures, get initial question and image link | | Enter idiom | Enter the guessed idiom answer during the game | | Enter "提示" | Get hints for the current question (using configured default hint level) | | 看图猜成语 结束 | Stop the current idiom guessing game from pictures | | Idiom Solitaire | | | 成语接龙 开始 | Start the idiom solitaire game, Bot will give the first idiom | | Enter idiom | Directly enter an idiom to participate in solitaire | | 成语接龙 结束 | Stop the current idiom solitaire game | | 24-Point Calculation | | | 算24点 开始 | Start the 24-point calculation game, using the configured default difficulty | | Enter formula | Enter formula like (6-2)*(8-2), supports parentheses, square brackets, curly braces | | Enter "换题" | Change current question | | 算24点 结束 | Stop the current 24-point calculation game |

配置说明 (Configuration)

中文

| 配置项 | 说明 | 默认值 | | --- | --- | --- | | ⚙️ 游戏开关 | | | | enableNumberGuess | 启用猜数字游戏 | true | | enableWzHero | 启用王者英雄猜谜 | true | | enableChengyuImage | 启用看图猜成语 | true | | enableChengyuJielong | 启用成语接龙 | true | | enableCalc24 | 启用算24点 | true | | 💬 私聊游戏开关 | | | | privateGame.enableNumberGuess | 允许私聊玩猜数字 | true | | privateGame.enableWzHero | 允许私聊玩王者英雄 | true | | privateGame.enableChengyuImage | 允许私聊玩看图猜成语 | true | | privateGame.enableChengyuJielong | 允许私聊玩成语接龙 | true | | privateGame.enableCalc24 | 允许私聊玩算24点 | true | | 📊 排行榜配置 | | | | rank.enableCommand | 启用排行榜指令 | true | | rank.maxDisplay | 排行榜最多显示人数 | 10 | | rank.clearDataPermission | 清零数据所需权限等级 | 5 | | rank.messages.title | 排行榜标题 | "📊 群游戏总排行榜" | | rank.messages.empty | 排行榜为空提示 | "暂无玩家数据" | | rank.messages.playerInfo | 玩家信息格式 | "{0}. {1} - 得分：{2}分 | 答对：{3}题 | 游玩：{4}次" | | rank.messages.totalStats | 总统计信息 | "\n📈 总统计：共 {0} 位玩家 | 总得分：{1} | 总答对：{2} | 总游玩：{3}" | | rank.messages.noPermission | 无权限提示 | "❌ 你没有权限执行此操作" | | rank.messages.clearSuccess | 清零成功提示 | "✅ 本群所有玩家数据已清零" | | rank.messages.showTotalStats | 是否显示总统计数据 | true | | 🔧 调试配置 | | | | debug.enableLog | 启用调试日志输出 | false | | 💬 通用游戏消息配置 | | | | gameMessages.enabled | 启用自定义通用消息 | true | | gameMessages.usage | 用法错误提示 | "用法错误！正确用法：{0}" | | gameMessages.start | 游戏开始提示 | "比赛开始！本次共 {0} 回合～" | | gameMessages.stop | 游戏停止提示 | "比赛已停止" | | gameMessages.notStarted | 游戏未开始提示 | "比赛尚未开始，请输入 {0} 开始 开始游戏" | | gameMessages.apiError | API错误提示 | "API请求失败，请稍后再试" | | gameMessages.correct | 答对提示 | "答对啦！你获得 {0} 分～" | | gameMessages.wrong | 答错提示 | "答错啦～正确答案是：{0}，你不得分" | | gameMessages.roundEnd | 回合结束提示 | "第 {0} 回合结束！剩余回合：{1}" | | gameMessages.gameEnd | 游戏结束提示 | "🎉 比赛结束！🎉" | | gameMessages.rankTitle | 本局排行榜标题 | "🏆 本局排行榜 🏆" | | gameMessages.rankEmpty | 本局排行榜为空提示 | "暂无参与记录～" | | gameMessages.disabled | 功能禁用提示 | "该功能已关闭，请联系管理员开启" | | gameMessages.autoStop | 自动停止提示 | "太久没人玩啦，比赛自动结束～" | | 💬 猜数字专用消息 | | | | guessNumberMessages.outOfRange | 数字超出范围提示 | "数字超出当前范围 [{0}-{1}]，请重新输入！" | | guessNumberMessages.tooSmall | 猜小了提示 | "猜小啦！当前范围更新为 [{0}-{1}]" | | guessNumberMessages.tooBig | 猜大了提示 | "猜大啦！当前范围更新为 [{0}-{1}]" | | guessNumberMessages.correctDetail | 猜中详细提示 | "恭喜你猜中数字！\n猜中者扣 {0} 分，其他玩家各加 {1} 分" | | 💬 王者英雄专用消息 | | | | wzHeroMessages.hint | 提示命令 | "提示" | | 💬 看图猜成语专用消息 | | | | chengyuImageMessages.next | 下一题提示 | "第 {0} 题来啦！" | | chengyuImageMessages.hintGet | 获取提示成功 | "【提示】{0}" | | chengyuImageMessages.hintError | 获取提示失败 | "获取提示失败，请稍后再试" | | 💬 成语接龙专用消息 | | | | chengyuJielongMessages.botTurn | 机器人回合提示 | "该我了！我接：{0}" | | chengyuJielongMessages.botWin | 机器人赢提示 | "哈哈我接不上了！本轮结束～" | | chengyuJielongMessages.autoPlayTooMany | 自动参与次数过多提示 | "自动参与次数已达上限 {0}" | | chengyuJielongMessages.notIdiom | 非成语提示 | "请输入4字成语" | | 💬 算24点专用消息 | | | | calc24Messages.generate | 生成题目提示 | "📝 第 {0} 题（{1}）：用 {2} 通过加减乘除和括号算出24！" | | calc24Messages.solved | 已解决提示 | "这组数已经被答对啦，换一组数字～" | | 💬 通用消息配置 | | | | commonMessages.gameRunning | 游戏运行中提示 | "当前已有游戏在运行中，请先结束当前游戏后再开始新游戏！" | | commonMessages.paramError | 参数错误提示 | "❌ 参数错误！请检查输入格式" | | 🎲 猜数字游戏配置 | | | | guessNumber.min | 最小值 | 0 | | guessNumber.max | 最大值 | 100 | | guessNumber.botParticipateInGroup | 群聊中机器人是否参与 | true | | guessNumber.totalRounds | 总回合数 | 10 | | guessNumber.showRank | 游戏结束后显示本局排行榜 | true | | guessNumber.autoPlayDelay | 机器人自动操作延迟（秒） | 10 | | guessNumber.autoPlayMaxCount | 机器人最大自动操作次数 | 5 | | guessNumber.autoStopInactiveTime | 游戏无操作自动停止时间（秒） | 60 | | guessNumber.enablePenalty | 启用惩罚机制（猜中者扣分，其他人加分） | true | | guessNumber.penaltyScore | 猜中者扣除分数 | -1 | | guessNumber.rewardScore | 其他人奖励分数 | 1 | | ⚔️ 王者英雄猜谜配置 | | | | wzHero.totalRounds | 总回合数 | 10 | | wzHero.showRank | 游戏结束后显示本局排行榜 | true | | wzHero.defaultDifficulty | 默认难度 | 简单 | | wzHero.autoStopInactiveTime | 游戏无操作自动停止时间（秒） | 60 | | wzHero.rewardScore | 答对奖励分数 | 1 | | 🖼️ 看图猜成语配置 | | | | chengyuImage.totalRounds | 总回合数 | 10 | | chengyuImage.showRank | 游戏结束后显示本局排行榜 | true | | chengyuImage.defaultHintLevel | 默认提示级别 | 1 | | chengyuImage.autoStopInactiveTime | 游戏无操作自动停止时间（秒） | 60 | | chengyuImage.rewardScore | 答对奖励分数 | 1 | | 🐉 成语接龙配置 | | | | chengyuJielong.totalRounds | 总回合数 | 10 | | chengyuJielong.showRank | 游戏结束后显示本局排行榜 | false | | chengyuJielong.autoPlayDelay | 机器人自动操作延迟（秒） | 10 | | chengyuJielong.autoPlayMaxCount | 机器人最大自动操作次数 | 5 | | chengyuJielong.autoStopInactiveTime | 游戏无操作自动停止时间（秒） | 60 | | chengyuJielong.maxRounds | 最大接龙回合数（0为无限） | 10 | | chengyuJielong.botParticipate | 机器人是否参与接龙 | false | | 🧮 算24点配置 | | | | calc24.totalRounds | 总回合数 | 5 | | calc24.showRank | 游戏结束后显示本局排行榜 | true | | calc24.defaultDifficulty | 默认难度 | 中等 | | calc24.difficultyLevels.easy.min | 简单难度最小值 | 1 | | calc24.difficultyLevels.easy.max | 简单难度最大值 | 8 | | calc24.difficultyLevels.medium.min | 中等难度最小值 | 1 | | calc24.difficultyLevels.medium.max | 中等难度最大值 | 10 | | calc24.difficultyLevels.hard.min | 困难难度最小值 | 1 | | calc24.difficultyLevels.hard.max | 困难难度最大值 | 13 | | calc24.autoStopInactiveTime | 游戏无操作自动停止时间（秒） | 60 | | calc24.rewardScore | 答对奖励分数 | 1 | | 🌐 API接口配置 | | | | apiConfig.timeout | API请求超时时间（毫秒，0为不超时） | 30000 |

English

| Config Item | Description | Default | | --- | --- | --- | | ⚙️ Game Switches | | | | enableNumberGuess | Enable number guessing game | true | | enableWzHero | Enable King of Glory hero guessing | true | | enableChengyuImage | Enable idiom guessing from pictures | true | | enableChengyuJielong | Enable idiom solitaire | true | | enableCalc24 | Enable 24-point calculation | true | | 💬 Private Chat Switches | | | | privateGame.enableNumberGuess | Allow private chat for number guessing | true | | privateGame.enableWzHero | Allow private chat for King of Glory hero guessing | true | | privateGame.enableChengyuImage | Allow private chat for idiom guessing from pictures | true | | privateGame.enableChengyuJielong | Allow private chat for idiom solitaire | true | | privateGame.enableCalc24 | Allow private chat for 24-point calculation | true | | 📊 Rank Configuration | | | | rank.enableCommand | Enable rank command | true | | rank.maxDisplay | Maximum display count in rank | 10 | | rank.clearDataPermission | Authority level required to clear data | 5 | | rank.messages.title | Rank title | "📊 Group Game Total Rank" | | rank.messages.empty | Empty rank prompt | "No player data" | | rank.messages.playerInfo | Player info format | "{0}. {1} - Score: {2} | Correct: {3} | Played: {4}" | | rank.messages.totalStats | Total statistics | "\n📈 Total Stats: {0} players | Total Score: {1} | Total Correct: {2} | Total Played: {3}" | | rank.messages.noPermission | No permission prompt | "❌ You don't have permission to do this" | | rank.messages.clearSuccess | Clear success prompt | "✅ All player data in this group has been cleared" | | rank.messages.showTotalStats | Whether to show total statistics | true | | 🔧 Debug Configuration | | | | debug.enableLog | Enable debug log output | false | | 💬 Common Game Messages Configuration | | | | gameMessages.enabled | Enable custom common messages | true | | gameMessages.usage | Usage error prompt | "Usage error! Correct usage: {0}" | | gameMessages.start | Game start prompt | "Game starts! Total {0} rounds～" | | gameMessages.stop | Game stop prompt | "Game stopped" | | gameMessages.notStarted | Game not started prompt | "Game not started yet, please enter {0} start to begin" | | gameMessages.apiError | API error prompt | "API request failed, please try again later" | | gameMessages.correct | Correct answer prompt | "Correct! You get {0} points～" | | gameMessages.wrong | Wrong answer prompt | "Wrong～The correct answer is: {0}, you get no points" | | gameMessages.roundEnd | Round end prompt | "Round {0} ends! Remaining rounds: {1}" | | gameMessages.gameEnd | Game end prompt | "🎉 Game Over! 🎉" | | gameMessages.rankTitle | Round rank title | "🏆 Round Ranking 🏆" | | gameMessages.rankEmpty | Round rank empty prompt | "No participants～" | | gameMessages.disabled | Disabled prompt | "This feature is disabled, please contact administrator" | | gameMessages.autoStop | Auto stop prompt | "Too long no activity, game auto ended～" | | 💬 Number Guessing Specific Messages | | | | guessNumberMessages.outOfRange | Number out of range prompt | "Number out of current range [{0}-{1}], please enter again!" | | guessNumberMessages.tooSmall | Too small prompt | "Too small! Current range updated to [{0}-{1}]" | | guessNumberMessages.tooBig | Too big prompt | "Too big! Current range updated to [{0}-{1}]" | | guessNumberMessages.correctDetail | Correct detail prompt | "Congratulations on guessing the number!\nGuesser loses {0} points, other players each gain {1} points" | | 💬 King of Glory Hero Specific Messages | | | | wzHeroMessages.hint | Hint command | "hint" | | 💬 Idiom Guessing from Pictures Specific Messages | | | | chengyuImageMessages.next | Next question prompt | "Question {0} is here!" | | chengyuImageMessages.hintGet | Hint success prompt | "【Hint】{0}" | | chengyuImageMessages.hintError | Hint error prompt | "Failed to get hint, please try again later" | | 💬 Idiom Solitaire Specific Messages | | | | chengyuJielongMessages.botTurn | Bot turn prompt | "My turn! I answer: {0}" | | chengyuJielongMessages.botWin | Bot win prompt | "Haha I can't continue! Round ends～" | | chengyuJielongMessages.autoPlayTooMany | Auto play too many prompt | "Auto participation count has reached limit {0}" | | chengyuJielongMessages.notIdiom | Not idiom prompt | "Please enter a 4-character idiom" | | 💬 24-Point Calculation Specific Messages | | | | calc24Messages.generate | Generate question prompt | "📝 Question {0} ({1}): Use {2} with +-*/ and parentheses to calculate 24!" | | calc24Messages.solved | Solved prompt | "This set of numbers has been solved, switching to another set～" | | 💬 Common Messages Configuration | | | | commonMessages.gameRunning | Game running prompt | "A game is already running, please end it first before starting a new one!" | | commonMessages.paramError | Parameter error prompt | "❌ Parameter error! Please check input format" | | 🎲 Number Guessing Configuration | | | | guessNumber.min | Minimum value | 0 | | guessNumber.max | Maximum value | 100 | | guessNumber.botParticipateInGroup | Whether bot participates in group | true | | guessNumber.totalRounds | Total rounds | 10 | | guessNumber.showRank | Show rank after game ends | true | | guessNumber.autoPlayDelay | Bot auto operation delay (seconds) | 10 | | guessNumber.autoPlayMaxCount | Bot maximum auto operation count | 5 | | guessNumber.autoStopInactiveTime | Auto stop time due to inactivity (seconds) | 60 | | guessNumber.enablePenalty | Enable penalty mechanism (guesser loses points, others gain) | true | | guessNumber.penaltyScore | Points deducted from guesser | -1 | | guessNumber.rewardScore | Points rewarded to others | 1 | | ⚔️ King of Glory Hero Configuration | | | | wzHero.totalRounds | Total rounds | 10 | | wzHero.showRank | Show rank after game ends | true | | wzHero.defaultDifficulty | Default difficulty | easy | | wzHero.autoStopInactiveTime | Auto stop time due to inactivity (seconds) | 60 | | wzHero.rewardScore | Reward score for correct answer | 1 | | 🖼️ Idiom Guessing from Pictures Configuration | | | | chengyuImage.totalRounds | Total rounds | 10 | | chengyuImage.showRank | Show rank after game ends | true | | chengyuImage.defaultHintLevel | Default hint level | 1 | | chengyuImage.autoStopInactiveTime | Auto stop time due to inactivity (seconds) | 60 | | chengyuImage.rewardScore | Reward score for correct answer | 1 | | 🐉 Idiom Solitaire Configuration | | | | chengyuJielong.totalRounds | Total rounds | 10 | | chengyuJielong.showRank | Show rank after game ends | false | | chengyuJielong.autoPlayDelay | Bot auto operation delay (seconds) | 10 | | chengyuJielong.autoPlayMaxCount | Bot maximum auto operation count | 5 | | chengyuJielong.autoStopInactiveTime | Auto stop time due to inactivity (seconds) | 60 | | chengyuJielong.maxRounds | Maximum solitaire rounds (0 for unlimited) | 10 | | chengyuJielong.botParticipate | Whether bot participates in solitaire | false | | 🧮 24-Point Calculation Configuration | | | | calc24.totalRounds | Total rounds | 5 | | calc24.showRank | Show rank after game ends | true | | calc24.defaultDifficulty | Default difficulty | medium | | calc24.difficultyLevels.easy.min | Easy difficulty minimum value | 1 | | calc24.difficultyLevels.easy.max | Easy difficulty maximum value | 8 | | calc24.difficultyLevels.medium.min | Medium difficulty minimum value | 1 | | calc24.difficultyLevels.medium.max | Medium difficulty maximum value | 10 | | calc24.difficultyLevels.hard.min | Hard difficulty minimum value | 1 | | calc24.difficultyLevels.hard.max | Hard difficulty maximum value | 13 | | calc24.autoStopInactiveTime | Auto stop time due to inactivity (seconds) | 60 | | calc24.rewardScore | Reward score for correct answer | 1 | | 🌐 API Configuration | | | | apiConfig.timeout | API request timeout (milliseconds, 0 for no timeout) | 30000 |

项目贡献者 (Contributors)

| 贡献者 | 贡献内容 | | --- | --- | | Minecraft-1314 | 插件完整开发 | | 慕名API | 慕名API 支持 | | 月下独酌API | 月下独酌API 支持 | | （欢迎提交 PR 加入贡献者列表） | |

许可协议 (License)

本项目采用 MIT 开源许可证，您可自由使用、修改和分发，详情参见项目根目录的 LICENSE 文件。

This project is licensed under the MIT Open Source License. You are free to use, modify and distribute it. For details, see the LICENSE file in the project root directory.

支持我们 (Support Us)

如果这个项目对您有帮助，欢迎点亮仓库右上角的 Star ⭐ 支持我们，这将是对所有贡献者最大的鼓励！

If this project is helpful to you, please feel free to star the repository in the upper right corner ⭐ to support us, which will be the greatest encouragement to all contributors!