koishi-plugin-active-tasks
v1.0.1
Published
Koishi活跃任务插件 - 群成员完成任务获取积分,积分商店兑换物品
Maintainers
Readme
Koishi 活跃任务插件 一个功能丰富的 Koishi 插件,为群成员提供每日任务、积分系统和商店兑换功能。
功能特色 🎯 任务系统 多种任务类型:诗词接龙、数学计算、知识问答、词语接龙、自定义任务等
每日刷新:每天随机生成新的任务
智能验证:支持答案验证、尝试次数限制、冷却时间
难度分级:简单、中等、困难三个难度级别
自定义配置:完全可配置的任务库和参数
💰 积分系统 任务奖励:完成任务获得积分
每日签到:连续签到获得额外奖励
积分上限:可配置的每日积分上限
排行榜:查看积分排名
🛒 商店系统 物品兑换:使用积分兑换各种物品
库存管理:有限库存和无限库存支持
限购功能:每人限购数量控制
购买记录:完整的交易历史记录
📊 数据持久化 用户数据:积分、任务完成情况、购买历史
签到记录:连续签到天数和总签到次数
物品库存:用户个人物品栏
每日任务:每天的任务状态和尝试记录
安装 在 Koishi 市场安装 bash
在 Koishi 控制台搜索 "active-tasks" 并安装
手动安装 bash npm install koishi-plugin-active-tasks 配置 在 koishi.yml 或 Koishi 控制台中配置插件:
yaml plugins: active-tasks: # 基础设置 dailyTaskCount: 5 maxPointsPerDay: 200 enableSignIn: true signInReward: 10 consecutiveBonus: [5, 10, 15, 20, 30] enableLeaderboard: true leaderboardSize: 10 taskCooldown: 5
# 任务配置
tasks:
- id: 'poetry_1'
name: '诗词接龙'
description: '接下一句诗'
type: 'poetry'
difficulty: 'medium'
reward: 15
enabled: true
- id: 'math_1'
name: '数学题'
description: '简单的数学计算'
type: 'math'
difficulty: 'easy'
reward: 10
enabled: true
- id: 'custom_1'
name: '脑筋急转弯'
description: '什么车寸步难行?'
type: 'custom'
difficulty: 'hard'
reward: 20
answer: '风车'
hint: '不是真正的交通工具'
enabled: true
# 商店物品
shopItems:
- id: 'badge_1'
name: '初级徽章'
description: '新手荣誉徽章'
cost: 50
stock: -1
maxPerUser: 1
enabled: true
effect: '身份象征'
- id: 'double_1'
name: '双倍积分卡'
description: '下次任务双倍积分'
cost: 80
stock: 50
maxPerUser: 5
enabled: true
effect: '一次性使用'
# 诗词数据库
poetryDatabase:
"床前明月光,疑是地上霜。": "举头望明月,低头思故乡。"
"春眠不觉晓,处处闻啼鸟。": "夜来风雨声,花落知多少。"
# 知识问答库
triviaQuestions:
- question: "中国的首都是?"
answer: "北京"
- question: "太阳从哪边升起?"
answer: "东边"
# 词语接龙词库
wordTasks:
- "苹果"
- "香蕉"
- "电脑"
- "手机"使用方法 基础命令 命令 别名 说明 任务 tasks 查看今日任务和积分 完成任务 <编号> <答案> complete 完成任务 我的积分 points 查看当前积分 积分商店 shop 查看商店物品 兑换 <编号> exchange 兑换物品 我的物品 inventory 查看已拥有的物品 签到 signin 每日签到获取积分 排行榜 leaderboard 查看积分排行榜 任务帮助 taskhelp 查看详细帮助 使用示例 查看今日任务
text
任务 📊 当前积分:150(总计:520)
📋 今日任务:
- 诗词接龙 - 请接下一句诗:"床前明月光,疑是地上霜。" 奖励: 15积分 (0/3次尝试) [❌ 未完成]
- 数学题 - 计算:25 + 38 = ? 奖励: 10积分 (0/3次尝试) [❌ 未完成] 完成任务
text
完成任务 1 举头望明月,低头思故乡。 🎉 任务完成!获得 15 积分 兑换物品
text
积分商店 🛒 积分商店:
- 初级徽章 - 新手荣誉徽章 [身份象征] 价格: 50积分 [库存: 无限]
兑换 1 🎉 成功兑换 初级徽章!消耗 50 积分,剩余积分:100 每日签到
text
签到 ✅ 签到成功!获得 15 积分 📅 已连续签到 5 天 🎁 连续签到奖励 +10 积分 任务类型说明
- 诗词接龙 随机显示一句古诗的上半句
用户需要接出下半句
支持自定义诗词库
- 数学计算 随机生成数学计算题
支持加减乘除运算
自动验证计算结果
- 知识问答 常识性问题问答
支持自定义问题库
自动答案验证
- 词语接龙 给出词语的最后一个字
用户需要说出以该字开头的词语
支持自定义词库
- 自定义任务 完全自定义的任务内容
支持预设答案和提示
灵活的验证机制
高级配置 任务配置选项 yaml tasks:
- id: 'unique_id' # 唯一标识 name: '任务名称' # 显示名称 description: '任务描述' # 详细描述 type: 'poetry' # 任务类型 difficulty: 'medium' # 难度级别 reward: 15 # 奖励积分 answer: '答案' # 正确答案(可选) options: [] # 选项列表(可选) hint: '提示信息' # 提示信息(可选) cooldown: 5 # 冷却时间(分钟,可选) maxAttempts: 3 # 最大尝试次数(可选) enabled: true # 是否启用 商店物品配置 yaml shopItems:
- id: 'unique_id' # 唯一标识 name: '物品名称' # 显示名称 description: '物品描述' # 详细描述 cost: 50 # 兑换所需积分 stock: -1 # 库存(-1表示无限) maxPerUser: 1 # 每人限购数量(-1表示无限) enabled: true # 是否启用 effect: '效果描述' # 物品效果说明(可选) 数据管理 插件会自动创建以下数据表:
active_tasks_user - 用户积分和任务数据
active_tasks_daily - 每日任务状态
active_tasks_inventory - 用户物品库存
active_tasks_signin - 签到记录
所有数据都支持持久化存储,确保服务器重启后数据不丢失。
开发说明 构建插件 bash npm run build 开发模式 bash npm run dev 项目结构 text koishi-plugin-active-tasks/ ├── index.ts # 主插件文件 ├── package.json # 项目配置 ├── tsconfig.json # TypeScript配置 └── lib/ # 编译输出目录 常见问题 Q: 任务没有正确验证答案? A: 检查任务配置中的 answer 字段,确保答案格式正确。支持多个正确答案,可以用数组格式。
Q: 用户积分异常? A: 检查每日积分上限配置,确保没有超过限制。可以查看用户数据表进行调试。
Q: 商店物品库存不更新? A: 确保物品配置中的 stock 字段设置正确,-1 表示无限库存,大于0表示有限库存。
Q: 如何重置用户数据? A: 可以通过数据库操作工具直接修改对应的数据表,或者等待每日自动刷新。
更新日志 v1.0.0 ✅ 基础任务系统
✅ 积分商店
✅ 每日签到
✅ 排行榜功能
✅ 数据持久化
技术支持 如果遇到问题或有功能建议,请通过以下方式联系:
在 GitHub 仓库提交 Issue
在 Koishi 官方社区发帖
联系插件作者
许可证 MIT License
享受使用 Koishi 活跃任务插件!🎉
