koishi-plugin-game-mini 0.0.1

package/lib/index.d.ts

@@ -0,0 +1,18 @@
+import { Context, Schema } from 'koishi';
+declare module 'koishi' {
+    interface Context {
+        console?: {
+            createConfig: (config: any) => void;
+        };
+    }
+}
+export declare const name = "game-mini";
+export interface Config {
+    guessNumber: {
+        min: number;
+        max: number;
+        botParticipateInGroup: boolean;
+    };
+}
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -0,0 +1,166 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = exports.name = void 0;
+exports.apply = apply;
+const koishi_1 = require("koishi");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const loadLocales = (ctx) => {
+    const localesDir = path_1.default.join(__dirname, 'locales');
+    if (fs_1.default.existsSync(localesDir)) {
+        const files = fs_1.default.readdirSync(localesDir);
+        for (const file of files) {
+            if (file.endsWith('.yml')) {
+                const lang = file.replace('.yml', '');
+                try {
+                    const localeData = require(path_1.default.join(localesDir, file));
+                    ctx.i18n.define(lang, localeData);
+                }
+                catch (error) {
+                    console.warn(`Failed to load locale file ${file}:`, error);
+                }
+            }
+        }
+    }
+};
+exports.name = 'game-mini';
+exports.Config = koishi_1.Schema.object({
+    guessNumber: koishi_1.Schema.object({
+        min: koishi_1.Schema.number()
+            .min(0)
+            .default(0)
+            .description('猜数字最小值（最低为0）'),
+        max: koishi_1.Schema.number()
+            .min(1)
+            .default(100)
+            .description('猜数字最大值'),
+        botParticipateInGroup: koishi_1.Schema.boolean()
+            .default(true)
+            .description('群聊中Bot是否参与猜数字（私聊强制参与）'),
+    }).description('猜数字游戏配置'),
+});
+function apply(ctx, config) {
+    loadLocales(ctx);
+    if (ctx.console) {
+        ctx.console.createConfig({
+            schema: exports.Config,
+            ui: {
+                form: [
+                    {
+                        key: 'guessNumber.min',
+                        label: '猜数字最小值',
+                        type: 'number',
+                        attrs: {
+                            min: 0,
+                            placeholder: '输入最小值（最低为0）'
+                        }
+                    },
+                    {
+                        key: 'guessNumber.max',
+                        label: '猜数字最大值',
+                        type: 'number',
+                        attrs: {
+                            min: 1,
+                            placeholder: '输入最大值'
+                        }
+                    },
+                    {
+                        key: 'guessNumber.botParticipateInGroup',
+                        label: '群聊中Bot参与猜数字',
+                        type: 'switch',
+                        description: '私聊时Bot强制参与，不受此配置影响'
+                    }
+                ]
+            }
+        });
+    }
+    const guessNumberStates = new Map();
+    const getSessionKey = (session) => {
+        return session.channelId ? `group:${session.channelId}` : `private:${session.userId}`;
+    };
+    ctx.command('guess-number <action:string>', '猜数字小游戏')
+        .usage('guess-number start - 开始游戏\nguess-number <num> - 猜数字\nguess-number stop - 停止游戏')
+        .example('guess-number start')
+        .example('guess-number 50')
+        .example('guess-number stop')
+        .action(async ({ session }, action) => {
+        if (!session)
+            return;
+        if (!action)
+            return session.text('guessNumber.usage');
+        const key = getSessionKey(session);
+        let state = guessNumberStates.get(key) || {
+            target: 0,
+            min: config.guessNumber.min,
+            max: config.guessNumber.max,
+            started: false,
+            botGuess: []
+        };
+        if (action === 'start') {
+            state.target = koishi_1.Random.int(config.guessNumber.min, config.guessNumber.max);
+            state.started = true;
+            state.botGuess = [];
+            guessNumberStates.set(key, state);
+            let reply = session.text('guessNumber.start', [config.guessNumber.min, config.guessNumber.max]);
+            const isPrivate = !session.channelId;
+            const botShouldParticipate = isPrivate || config.guessNumber.botParticipateInGroup;
+            if (botShouldParticipate) {
+                const botFirstGuess = koishi_1.Random.int(config.guessNumber.min, config.guessNumber.max);
+                state.botGuess.push(botFirstGuess);
+                guessNumberStates.set(key, state);
+                reply += '\n' + session.text('guessNumber.botFirstGuess', [botFirstGuess]);
+            }
+            return reply;
+        }
+        if (action === 'stop') {
+            state.started = false;
+            guessNumberStates.set(key, state);
+            return session.text('guessNumber.stop', [state.target]);
+        }
+        const num = parseInt(action);
+        if (isNaN(num))
+            return session.text('guessNumber.invalid');
+        if (!state.started)
+            return session.text('guessNumber.notStarted');
+        if (num < state.min || num > state.max) {
+            return session.text('guessNumber.outOfRange', [state.min, state.max]);
+        }
+        let reply = '';
+        if (num < state.target) {
+            reply = session.text('guessNumber.tooSmall');
+        }
+        else if (num > state.target) {
+            reply = session.text('guessNumber.tooBig');
+        }
+        else {
+            state.started = false;
+            guessNumberStates.set(key, state);
+            return session.text('guessNumber.correct', [state.target]);
+        }
+        const isPrivate = !session.channelId;
+        const botShouldParticipate = isPrivate || config.guessNumber.botParticipateInGroup;
+        if (botShouldParticipate && state.started) {
+            let botGuess;
+            do {
+                botGuess = koishi_1.Random.int(config.guessNumber.min, config.guessNumber.max);
+            } while (state.botGuess.includes(botGuess));
+            state.botGuess.push(botGuess);
+            guessNumberStates.set(key, state);
+            if (botGuess === state.target) {
+                reply += '\n' + session.text('guessNumber.botWin', [botGuess]);
+                state.started = false;
+                guessNumberStates.set(key, state);
+            }
+            else if (botGuess < state.target) {
+                reply += '\n' + session.text('guessNumber.botGuessTooSmall', [botGuess]);
+            }
+            else {
+                reply += '\n' + session.text('guessNumber.botGuessTooBig', [botGuess]);
+            }
+        }
+        return reply;
+    });
+}

package/lib/locales/locales/zh-CN.yml

@@ -0,0 +1,26 @@
+commands:
+  guess-number:
+    description: 猜数字小游戏
+    usage: |-
+      guess-number start - 开始猜数字游戏
+      guess-number <数字> - 输入数字进行猜测
+      guess-number stop - 停止猜数字游戏
+    examples: |-
+      guess-number start
+      guess-number 50
+      guess-number stop
+
+guessNumber:
+  usage: 用法错误！正确用法：guess-number start/stop 或 输入数字
+  start: 猜数字游戏开始！数字范围是 {0} 到 {1}，快来猜猜看～
+  stop: 猜数字游戏已停止，正确答案是 {0}
+  invalid: 请输入有效的数字！
+  notStarted: 游戏还未开始，请先发送 guess-number start 开始游戏
+  outOfRange: 数字超出范围！请输入 {0} 到 {1} 之间的数字
+  tooSmall: 猜小啦，再试试更大的数字～
+  tooBig: 猜大啦，再试试更小的数字～
+  correct: 恭喜你猜对了！正确答案就是 {0} 🎉
+  botFirstGuess: 我先来猜一个：{0}，该你啦～
+  botWin: 哈哈我猜对了！答案就是 {0}，我赢啦 🎉
+  botGuessTooSmall: 我猜 {0}，好像猜小了～
+  botGuessTooBig: 我猜 {0}，好像猜大了～

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "koishi-plugin-game-mini",
+  "version": "0.0.1",
+  "description": "Koishi猜数字小游戏插件",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Minecraft-1314/koishi-plugin-game-mini.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Minecraft-1314/koishi-plugin-game-mini/issues"
+  },
+  "homepage": "https://github.com/Minecraft-1314/koishi-plugin-game-mini#readme",
+  "koishi": {
+    "description": {
+      "zh-CN": "Koishi猜数字小游戏插件"
+    },
+    "locales": [
+      "zh-CN"
+    ],
+    "service": {
+      "required": [
+        "console"
+      ]
+    }
+  },
+  "dependencies": {
+    "@koishijs/plugin-console": "^5.0.0",
+    "koishi": "^4.0.0",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "copyfiles": "^2.4.1"
+  },
+  "scripts": {
+    "build": "tsc && copyfiles -u 1 src/locales/*.yml lib/locales/",
+    "dev": "tsc -w && copyfiles -u 1 src/locales/*.yml lib/locales/ -w"
+  }
+}

package/readme.md

@@ -0,0 +1,70 @@
+# koishi-plugin-game-mini
+
+## 项目介绍 (Project Introduction)
+
+### 中文
+这是一个为 Koishi 聊天机器人框架开发的猜数字小游戏插件。该插件具有以下特点：
+- 支持自定义猜数字的数值范围（最小值最低为0）
+- 区分群聊/私聊模式：私聊时 Bot 强制参与，群聊可配置 Bot 是否参与
+- 提供可视化控制台配置页面，支持汉化
+- Bot 参与时会智能猜数，且不会重复猜测同一数字
+
+### English
+This is a number guessing game plugin developed for the Koishi chatbot framework. This plugin has the following features:
+- Support customizing the numerical range of the number guessing game (minimum value is 0)
+- Distinguish between group chat/private chat modes: Bot participates compulsorily in private chats, and Bot participation in group chats is configurable
+- Provide a visual console configuration page with Chinese localization support
+- When the Bot participates, it will guess numbers intelligently and will not guess the same number repeatedly
+
+## 使用说明 (Usage)
+
+### 中文
+| 命令 (Command) | 功能说明 (Description) |
+| --- | --- |
+| guess-number start | 启动猜数字游戏，Bot（配置参与时）会先猜一个数字 |
+| guess-number <数字> | 输入数字进行猜测，系统会提示猜大/猜小或猜对 |
+| guess-number stop | 停止当前猜数字游戏，并公布正确答案 |
+
+### English
+| Command | Description |
+| --- | --- |
+| guess-number start | Start the number guessing game, and the Bot (if configured to participate) will guess a number first |
+| guess-number <number> | Enter a number to guess, and the system will prompt if it's too big/too small or correct |
+| guess-number stop | Stop the current number guessing game and announce the correct answer |
+
+## 配置说明 (Configuration)
+
+### 中文
+| 配置项 (Config Item) | 说明 (Description) | 默认值 (Default) |
+| --- | --- | --- |
+| guessNumber.min | 猜数字最小值（最低为0） | 0 |
+| guessNumber.max | 猜数字最大值 | 100 |
+| guessNumber.botParticipateInGroup | 群聊中 Bot 是否参与猜数字（私聊强制参与） | true |
+
+### English
+| Config Item | Description | Default |
+| --- | --- | --- |
+| guessNumber.min | Minimum value for number guessing (minimum 0) | 0 |
+| guessNumber.max | Maximum value for number guessing | 100 |
+| guessNumber.botParticipateInGroup | Whether the Bot participates in number guessing in group chats (compulsory in private chats) | true |
+
+## 项目贡献者 (Contributors)
+| 贡献者 (Contributor) | 贡献内容 (Contribution) |
+| --- | --- |
+| （您的名字/昵称） | 插件完整开发 (Complete plugin development) |
+| （欢迎提交 PR 加入贡献者列表） | （Welcome to submit PR to join the contributor list） |
+
+## 许可协议 (License)
+本项目采用 MIT 许可证，详情参见 LICENSE 文件。
+
+This project is licensed under the MIT License, see the LICENSE file for details.
+
+## 支持我们 (Support Us)
+如果这个项目对您有帮助，欢迎点亮右上角的 Star ⭐ 支持我们，这将是对所有贡献者最大的鼓励！
+
+If this project is helpful to you, please feel free to star it in the upper right corner ⭐ to support us, which will be the greatest encouragement to all contributors!
+
+## 问题反馈 (Feedback)
+如有问题或建议，可通过 Issues 提交反馈。
+
+If you have any questions or suggestions, please submit feedback via Issues.