koishi-plugin-game-mini

项目介绍 (Project Introduction)

中文

这是一款为 Koishi 聊天机器人框架开发的轻量级多功能小游戏插件，包含经典猜数字、猜王者荣耀英雄、看图猜成语、成语接龙四款趣味游戏，兼具易用性与可配置性：

• 猜数字：支持自定义数值范围（默认 0-100），区分群聊/私聊模式控制 Bot 参与状态
• 猜王者英雄：基于诗词/提示猜王者荣耀英雄，支持简单/中等/困难三种难度
• 看图猜成语：根据图片和备选字猜成语，支持提示功能和切换题目
• 成语接龙：与 Bot 进行成语接龙对战，自动返回成语拼音和释义

English

This is a lightweight multi-functional game plugin developed for the Koishi chatbot framework, including four fun games: classic number guessing, King of Glory hero guessing, idiom guessing from pictures, and idiom solitaire, with both ease of use and configurability:

• Number Guessing: Supports customizable number range (default 0-100), controls Bot participation status by distinguishing group chat/private chat modes
• King of Glory Hero Guessing: Guess King of Glory heroes based on poems/hints, supports three difficulty levels: easy/medium/hard
• Idiom Guessing from Pictures: Guess idioms based on pictures and candidate characters, supports hint function and question switching
• Idiom Solitaire: Compete with Bot in idiom solitaire, automatically return pinyin and meaning of idioms

使用说明 (Usage)

中文

| 命令 (Command) | 功能说明 (Description) | | --- | --- | | 猜数字游戏 | | | guess start | 启动猜数字游戏，初始范围为配置的最小值-最大值 | | 直接输入数字 | 游戏运行时输入纯数字即可猜测，系统会实时提示“猜大了/猜小了”并缩小范围，或提示“猜对了”并结束游戏 | | guess stop | 停止当前猜数字游戏，并公布正确数字 | | 王者英雄猜谜 | | | wzhero start <难度> | 启动王者英雄猜谜游戏，难度可选：简单/中等/困难 | | 输入英雄名称 | 游戏运行时输入英雄名猜测答案，系统会返回结果提示 | | 输入“提示” | 获取当前英雄的线索提示（有次数限制） | | wzhero stop | 停止当前王者英雄猜谜游戏 | | 看图猜成语 | | | cyimage start | 启动看图猜成语游戏，获取初始题目和图片链接 | | 输入成语 | 游戏运行时输入猜测的成语答案 | | 输入“提示 [等级]” | 获取当前题目的提示（等级1-5，默认1级） | | 输入“下一题” | 切换到下一个猜成语题目 | | cyimage stop | 停止当前看图猜成语游戏 | | 成语接龙 | | | cyjl start | 启动成语接龙游戏，Bot 先出第一个成语 | | 输入“我接<成语>” | 接Bot的成语进行接龙（如：我接一帆风顺） | | cyjl stop | 停止当前成语接龙游戏 |

English

| Command | Description | | --- | --- | | Number Guessing Game | | | guess start | 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 end the game | | guess stop | Stop the current number guessing game and announce the correct number | | King of Glory Hero Guessing | | | wzhero start <difficulty> | Start the King of Glory hero guessing game, difficulty options: easy/medium/hard | | 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) | | wzhero stop | Stop the current King of Glory hero guessing game | | Idiom Guessing from Pictures | | | cyimage start | Start the idiom guessing game from pictures, get initial question and image link | | Enter idiom | Enter the guessed idiom answer during the game | | Enter "提示 [level]" | Get hints for the current question (level 1-5, default level 1) | | Enter "下一题" | Switch to the next idiom guessing question | | cyimage stop | Stop the current idiom guessing game from pictures | | Idiom Solitaire | | | cyjl start | Start the idiom solitaire game, Bot will give the first idiom | | Enter "我接" | Respond to Bot's idiom for solitaire (e.g.: 我接一帆风顺) | | cyjl stop | Stop the current idiom solitaire game |

配置说明 (Configuration)

中文

| 配置项 (Config Item) | 说明 (Description) | 默认值 (Default) | | --- | --- | --- | | 基础功能开关 | | | | enableNumberGuess | 是否开启猜数字游戏功能 | true | | enableWzHero | 是否开启王者英雄猜谜游戏功能 | true | | enableChengyuImage | 是否开启看图猜成语游戏功能 | true | | enableChengyuJielong | 是否开启成语接龙游戏功能 | true | | 猜数字配置 | | | | guessNumber.min | 猜数字最小值 | 0 | | guessNumber.max | 猜数字最大值 | 100 | | guessNumber.botParticipateInGroup | 群聊中 Bot 是否参与猜数字（私聊场景下 Bot 强制参与） | true | | 王者英雄猜谜配置 | | | | wzHero.botParticipateInGroup | 群聊中 Bot 是否参与王者英雄猜谜（私聊场景下 Bot 强制参与） | true | | 看图猜成语配置 | | | | chengyuImage.botParticipateInGroup | 群聊中 Bot 是否参与看图猜成语（私聊场景下 Bot 强制参与） | true | | 成语接龙配置 | | | | chengyuJielong.botParticipateInGroup | 群聊中 Bot 是否参与成语接龙（私聊场景下 Bot 强制参与） | true | | API配置 | | | | apiConfig.wzHeroUserId | 王者英雄猜谜API的用户区分ID | 1828222534 | | apiConfig.cyjlUserId | 成语接龙API的用户区分ID | 1828222534 | | apiConfig.timeout | 第三方API请求超时时间（毫秒） | 5000 |

English

| Config Item | Description | Default | | --- | --- | --- | | Basic Function Switch | | | | enableNumberGuess | Whether to enable the number guessing game function | true | | enableWzHero | Whether to enable the King of Glory hero guessing game function | true | | enableChengyuImage | Whether to enable the idiom guessing from pictures game function | true | | enableChengyuJielong | Whether to enable the idiom solitaire game function | true | | Number Guessing Configuration | | | | guessNumber.min | Minimum value for number guessing | 0 | | guessNumber.max | Maximum value for number guessing | 100 | | guessNumber.botParticipateInGroup | Whether the Bot participates in number guessing in group chats (Bot is forced to participate in private chat scenarios) | true | | King of Glory Hero Guessing Configuration | | | | wzHero.botParticipateInGroup | Whether the Bot participates in King of Glory hero guessing in group chats (Bot is forced to participate in private chat scenarios) | true | | Idiom Guessing from Pictures Configuration | | | | chengyuImage.botParticipateInGroup | Whether the Bot participates in idiom guessing from pictures in group chats (Bot is forced to participate in private chat scenarios) | true | | Idiom Solitaire Configuration | | | | chengyuJielong.botParticipateInGroup | Whether the Bot participates in idiom solitaire in group chats (Bot is forced to participate in private chat scenarios) | true | | API Configuration | | | | apiConfig.wzHeroUserId | User ID for King of Glory hero guessing API | 1828222534 | | apiConfig.cyjlUserId | User ID for idiom solitaire API | 1828222534 | | apiConfig.timeout | Timeout time for third-party API requests (milliseconds) | 5000 |

项目贡献者 (Contributors)

| 贡献者 (Contributor) | 贡献内容 (Contribution) | | --- | --- | | Minecraft-1314 | 插件完整开发、功能迭代与问题修复 (Complete plugin development, function iteration and bug fixing) | | （欢迎提交 PR 加入贡献者列表） | （Welcome to submit PR to join the contributor list） |

许可协议 (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!