koishi-plugin-ggcevo-game 1.1.3 → 1.1.4

package/lib/index.js

@@ -29,20 +29,38 @@ module.exports = __toCommonJS(src_exports);
 var import_koishi = require("koishi");
 var import_koishi_plugin_sc2arcade_search = require("koishi-plugin-sc2arcade-search");
 var name = "ggcevo-game";
-var Config = import_koishi.Schema.object({
-  proxyAgent: import_koishi.Schema.string().description("代理服务器地址"),
-  ggcqun: import_koishi.Schema.string().description("开启咕咕虫排行榜的群组").required(),
-  rankseason: import_koishi.Schema.string().description("当前赛季").required(),
-  signrequire: import_koishi.Schema.boolean().description("是否开启签到要求进行一场游戏").default(true),
-  autorank: import_koishi.Schema.boolean().description("是否开启每小时自动同步rank数据").default(true),
-  ignoreGlobalLimit: import_koishi.Schema.boolean().description("是否开启无限制兑换").default(false),
-  admins: import_koishi.Schema.array(import_koishi.Schema.string()).description("管理员QQ号列表，支持配置多个").default([]).role("table"),
-  groupId: import_koishi.Schema.array(import_koishi.Schema.string()).description("游戏大厅黑名单通知群组，例如 onebot:123456").default([]).role("table"),
-  checkInterval: import_koishi.Schema.number().default(60).description("检查间隔（秒）"),
-  dailyPKLimit: import_koishi.Schema.number().description("每人每天可发起PK次数").default(3),
-  sameOpponentLimit: import_koishi.Schema.boolean().description("是否开启同玩家每日单次PK限制").default(true),
-  maxDailyBeChallenged: import_koishi.Schema.number().description("每日最多被挑战次数（0=无限制）").default(5)
-});
+var Config = import_koishi.Schema.intersect([
+  // 基础配置组
+  import_koishi.Schema.object({
+    proxyAgent: import_koishi.Schema.string().description("代理服务器地址"),
+    ggcqun: import_koishi.Schema.string().description("绑定咕咕虫evo的群组ID").required()
+  }).description("基础设置"),
+  // 赛季与兑换配置组
+  import_koishi.Schema.object({
+    rankseason: import_koishi.Schema.string().description("当前赛季名称(影响兑换系统)").required(),
+    ignoreGlobalLimit: import_koishi.Schema.boolean().description("禁用全局兑换限制(谨慎开启)").default(false)
+  }).description("赛季配置"),
+  // 核心功能开关组
+  import_koishi.Schema.object({
+    signrequire: import_koishi.Schema.boolean().description("游戏对局签到要求").default(true),
+    autorank: import_koishi.Schema.boolean().description("自动同步天梯数据").default(true)
+  }).description("功能开关"),
+  // 对战系统配置组
+  import_koishi.Schema.object({
+    dailyPKLimit: import_koishi.Schema.number().description("每日最大发起PK次数").default(3),
+    sameOpponentLimit: import_koishi.Schema.boolean().description("同玩家每日单次限制").default(true),
+    maxDailyBeChallenged: import_koishi.Schema.number().description("最大被挑战次数(0=无限制)").default(5)
+  }).description("对战限制"),
+  // 通知系统配置组
+  import_koishi.Schema.object({
+    groupId: import_koishi.Schema.array(import_koishi.Schema.string()).description("黑名单通知群组").default([]),
+    checkInterval: import_koishi.Schema.number().description("大厅监控检查间隔(秒)").default(60)
+  }).description("通知设置").collapse(),
+  // 权限管理组
+  import_koishi.Schema.object({
+    admins: import_koishi.Schema.array(import_koishi.Schema.string()).description("管理员QQ列表").default([])
+  }).description("权限管理")
+]);
 var inject = {
   required: ["database"]
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-ggcevo-game",
-  "description": "星际争霸2游戏大厅咕咕虫-Evo地图专属插件。",
-  "version": "1.1.3",
+  "description": "《星际争霸2》咕咕虫-evolved地图的专属游戏助手插件，集成天梯排行、抽奖系统、签到福利、兑换商城等丰富功能。",
+  "version": "1.1.4",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -2,4 +2,96 @@
 
 [![npm](https://img.shields.io/npm/v/koishi-plugin-ggcevo-game?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-ggcevo-game)
 
-星际争霸2游戏大厅咕咕虫-Evo地图专属插件。
+《星际争霸2》咕咕虫-evolved地图的专属游戏助手插件，集成天梯排行、抽奖系统、签到福利、兑换商城等丰富功能。
+
+## 功能清单
+
+### 核心系统
+- 🎰 **保底抽奖系统**：支持单抽/十连抽，隐藏奖励机制
+- 📅 **智能签到系统**：结合游戏对局验证的签到机制
+- 🏆 **天梯排名系统**：自动同步胜点数据，动态排行榜
+- 🛍️ **兑换商城系统**：多层级奖品池，赛季限定物品
+
+### 特色功能
+- ⚔️ **玩家对战系统**：金币PK玩法，动态胜率计算
+- 🚨 **违规监控系统**：大厅玩家行为监控，黑名单管理
+- 🎁 **活动管理系统**：福利活动创建与发放
+- 📊 **数据统计系统**：玩家成就、背包、抽奖记录等全维度统计
+
+## 安装配置
+
+1. 安装插件
+```bash
+npm install koishi-plugin-ggcevo-game
+```
+
+2. 基础配置 (koishi.yml)
+```yaml
+plugins:
+  ggcevo-game:
+    proxyAgent: ''             # 代理地址（如需）
+    ggcqun: '你的群号'         # 绑定游戏群组
+    rankseason: 'S1'           # 当前赛季名称
+    signrequire: true          # 对局签到要求
+    autorank: true             # 自动同步天梯数据
+    dailyPKLimit: 3            # 每日最大PK次数
+    admins: [管理员QQ列表]      # 管理员权限
+```
+
+## 使用说明
+
+### 玩家命令
+```bash
+每日签到
+/签到
+
+抽奖系统
+/单抽
+/十连抽
+/抽奖记录
+
+天梯系统
+/胜点榜
+/排名 @玩家
+
+对战系统
+/pk @玩家
+/切换pk状态
+
+兑换系统
+/兑换
+/兑换扭蛋币
+```
+
+### 管理命令
+```bash
+活动管理
+/创建活动 <名称> <描述> <奖励数量>
+
+玩家管理
+/活动拉黑
+/胜点榜拉黑
+
+数据维护
+/胜点榜数据同步
+```
+
+## 数据模型
+```
+📦 数据库结构
+├── 用户背包 (ggcevo_backpack)
+├── 签到记录 (ggcevo_sign)
+├── 天梯数据 (ggcevo_rank)
+├── 对战记录 (ggcevo_pk_logs)
+├── 兑换记录 (ggcevo_exchange)
+└── 活动管理 (ggcevo_activity)
+```
+
+## 注意事项
+
+1. **敏感词检测**：需要配置第三方API（示例使用 api.iminbk.com）
+2. **定时任务**：自动天梯同步默认每小时执行，请根据需求调整频率
+3. **赛季设置**：兑换系统依赖 `rankseason` 配置项，赛季变更时需更新
+4. **代理配置**：国内服务器建议配置代理访问SC2Arcade API
+
+> 提示：使用前请确保已安装 [koishi-plugin-sc2arcade-search](https://www.npmjs.com/package/koishi-plugin-sc2arcade-search) 作为前置插件