koishi-plugin-ggcevo 1.1.6 → 1.1.7

package/lib/index.d.ts

@@ -19,6 +19,8 @@ export interface Config {
     banNotifyGroups: string[];
     handleInactiveUnbindEnabled: boolean;
     handleInactiveUnbindDays: number;
+    /** 活动兑换管理员名字, 填写后兑换成功及兑换列表会提示向该管理员登记; 不填则不提醒 */
+    exchangeAdminName: string;
 }
 export declare const Config: Schema<Config>;
 export declare const inject: {

package/lib/index.js

@@ -42,6 +42,9 @@ var Config = import_koishi.Schema.intersect([
   import_koishi.Schema.object({
     curfewEnabled: import_koishi.Schema.boolean().description("是否启用宵禁(启用后每晚17点-24点禁止抽奖和挖矿, 签到不受限制)").default(false)
   }).description("宵禁设置"),
+  import_koishi.Schema.object({
+    exchangeAdminName: import_koishi.Schema.string().description("活动兑换管理员名字(填写后, 兑换成功及兑换列表会提示向该管理员私聊登记, 不填则不提醒)").default("")
+  }).description("活动兑换"),
   import_koishi.Schema.object({
     tencentDocsEnabled: import_koishi.Schema.boolean().description("是否启用腾讯文档功能").default(false),
     tencentDocsClientId: import_koishi.Schema.string().description("腾讯文档开放平台应用 Client ID(应用ID)").default(""),
@@ -811,6 +814,8 @@ ${message}`;
   });
   ctx.command("ggcevo/兑换 <name:string>").action(async (argv, name2) => {
     const session = argv.session;
+    const adminRegistTip = config.exchangeAdminName ? `
+📝 请在私聊中联系活动管理员 ${config.exchangeAdminName} 登记本次兑换信息。` : "";
     const handle = await getHandle(session);
     if (!handle) {
       return "🔒 需要先绑定游戏句柄。\n💡 使用 `绑定句柄` 命令进行绑定。";
@@ -910,7 +915,7 @@ ${message}`;
       return `🎁 兑换成功！
 消耗 ${costCount} 张兑换券
 获得 ${exchangeItem.name}
-💡 使用 \`使用 赎罪券\` 来消耗此道具`;
+💡 使用 \`使用 赎罪券\` 来消耗此道具${adminRegistTip}`;
     }
     await ctx.database.create("ggcevo_exchange_log", {
       user_id: handle,
@@ -920,7 +925,7 @@ ${message}`;
     });
     return `🎁 兑换成功！
 消耗 ${costCount} 张兑换券
-获得 ${exchangeItem.name}（${exchangeItem.quality} - ${exchangeItem.type}）`;
+获得 ${exchangeItem.name}（${exchangeItem.quality} - ${exchangeItem.type}）${adminRegistTip}`;
   });
   ctx.command("ggcevo/抽奖").option("poolId", "-p <poolId:number> 抽奖池ID").option("count", "-c <count:number> 抽奖次数").action(async (argv) => {
     const session = argv.session;
@@ -1773,8 +1778,10 @@ ${message}`;
 `;
     message += `⚠️ 兑换功能仅限工作日使用（周一至周五兑换，周六/周日实装进咕咕虫）
 `;
-    message += `⚠️ 兑换完成后请找活动管理员登记
+    if (config.exchangeAdminName) {
+      message += `⚠️ 兑换完成后请在私聊中联系活动管理员 ${config.exchangeAdminName} 登记
 `;
+    }
     return message;
   });
   ctx.command("ggcevo/创建活动", { authority: 3 }).option("name", "-n <name:string> 活动名称").option("description", "-d <description:string> 活动描述").option("rewardItem", "-r <rewardItem:number> 奖励物品ID").option("rewardAmount", "-a <rewardAmount:number> 奖励数量").option("startTime", "-s <startTime:string> 开始时间 (格式: YYYY-MM-DD)").option("endTime", "-e <endTime:string> 结束时间 (格式: YYYY-MM-DD)").option("maxClaims", "-m <maxClaims:number> 总领取上限 (0=无限制)").option("requiredGroup", "-g <requiredGroup:string> 限制领取的群聊ID (空=无限制)").action(async (argv) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-ggcevo",
   "description": "GGCEVO 综合插件：星际争霸2游戏句柄绑定 + 签到/抽奖/兑换/背包/活动系统等虚拟物品玩法",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -78,6 +78,12 @@ npm install koishi-plugin-ggcevo
 - 功能上线前已绑定的旧句柄无时间记录，首次检查时以当前时间作为绑定时间补齐。
 - 定时任务每天检查一次（启动后延迟 5 秒首次检查），删除超过阈值天数未使用且非当前使用的句柄。
 
+### 活动兑换
+
+| 配置项 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `exchangeAdminName` | `string` | `''` | 活动兑换管理员名字。填写后，用户 `兑换` 成功时会提示向该管理员私聊登记，`兑换列表` 底部也会附带该提醒；**不填则不提醒** |
+
 ## 指令列表
 
 ### 星际争霸2 句柄（sc2arcade）
@@ -98,14 +104,14 @@ npm install koishi-plugin-ggcevo
 | --- | --- | --- | --- |
 | `签到` | — | — | 每日签到，获取奖励并发放签到券/补签券等。每月首次签到时，若签到者QQ号与句柄同时匹配管理员福利文档记录，额外发放 50 咕咕币津贴 |
 | `挖矿` | — | — | 领取挂机挖矿收益（咕咕之战玩法）。每半小时收益 4 金币，单次存储上限 24 小时，领取后立即进入下一轮挖矿。累计挖矿总时长与累计收益金币数会被记录统计。受宵禁影响：17:00-24:00 禁止领取 |
-| `兑换 <name>` | — | — | 使用兑换券兑换指定物品。消耗兑换券数量随物品品质而定（T3皮肤=3、T2=4、T1=5、T3宠物=3、T2=4、T1=5、T0宠物=6、入场特效=5、角色冠名权=10、赎罪券=2） |
+| `兑换 <name>` | — | — | 使用兑换券兑换指定物品。消耗兑换券数量随物品品质而定（T3皮肤=3、T2=4、T1=5、T3宠物=3、T2=4、T1=5、T0宠物=6、入场特效=5、角色冠名权=10、赎罪券=2）。兑换成功后会提示登记（若配置了 `exchangeAdminName`，则提示向该活动管理员私聊登记） |
 | `抽奖` | — | — | 抽奖。选项：`-p <poolId>` 奖池ID，`-c <count>` 抽奖次数。各池消耗：金币池=100金币/次、普通池=1咕咕币/次、皮肤池/宠物池=3兑换券/次 |
 | `背包` | — | — | 查看自己的物品背包 |
 | `个人信息` | — | — | 查看自己的签到统计与个人信息 |
 | `给予 <targetId> <itemId> <count>` | — | 3 | 给予指定用户物品（管理指令） |
 | `抽奖概率` | — | — | 查看各奖池的抽奖概率与保底说明 |
 | `签到奖励` | — | — | 查看签到奖励规则说明 |
-| `兑换列表` | 兑换表 | — | 查看可兑换物品列表（含皮肤、宠物、入场特效、角色冠名权、赎罪券及各自兑换券消耗） |
+| `兑换列表` | 兑换表 | — | 查看可兑换物品列表（含皮肤、宠物、入场特效、角色冠名权、赎罪券及各自兑换券消耗）。底部会附带登记提醒（若配置了 `exchangeAdminName`） |
 | `创建活动` | — | 3 | 创建活动。选项：`-n 名称 -d 描述 -r 奖励物品ID -a 数量 -s 开始时间 -e 结束时间 -m 领取上限 -g 限制群聊ID` |
 | `领取活动 [activityId]` | — | — | 领取指定（或最新）活动奖励 |
 | `活动列表 [showAll]` | — | — | 查看活动列表。默认只显示进行中与未开始的活动，携带参数（如"全部"）显示含已过期在内的全部活动 |
@@ -163,6 +169,12 @@ npm install koishi-plugin-ggcevo
 
 ## 更新日志
 
+### v1.1.7
+
+新增活动兑换管理员登记提醒。
+
+- **新增配置项 `exchangeAdminName`**：填写活动兑换管理员名字后，用户 `兑换` 成功后会在消息末尾追加提示，指引向该管理员私聊登记本次兑换信息；`兑换列表` 指令底部也会附带同样的登记提醒。**不填写则不提醒**。
+
 ### v1.1.6
 
 取消封禁记录查询的展示条数限制。