小茶馆插件 (astrbot_plugin_furry_cg)

一个为 AstrBot 开发的虚拟茶馆插件，提供签到、商店、背包、任务系统等丰富的游戏功能。

功能介绍

🍵 核心玩法

• 每日签到获取金币奖励
• 茶叶商店购买各种茶叶
• 背包系统管理茶叶收藏
• 喝茶享受不同类型的茶叶
• 茶艺展示获得额外奖励
• 茶叶评级系统展示收藏成就
• 任务系统完成挑战获取奖励

🎨 特色功能

• 精美的签到卡片生成
• 丰富的任务系统（每日、每周、特殊任务）
• 茶叶评级系统（青茶学徒→绿茶行者→乌龙使者→红茶大师→普洱宗师）
• 管理员功能（上架/下架商品、补货）

安装要求

此插件需要配合数据库插件使用：

• astrbot_plugin_furry_cgsjk

请确保先安装并启用数据库插件。

安装步骤

1. 下载插件文件到 AstrBot 的 plugins 目录
2. 确保依赖插件已安装：astrbot_plugin_furry_cgsjk
3. 重启 AstrBot 以加载插件
4. 使用命令开始体验茶馆生活

使用说明

玩家命令

签到系统

雪泷签到

每日签到可获得 50-100 金币奖励，签到卡片包含个人信息、时间和一言。

商店系统

雪泷商店

查看所有可购买的茶叶商品，显示商品ID、名称、类型、价格和库存。

雪泷购买 <商品ID> <数量>

购买指定ID的茶叶，茶叶将存入个人背包。

背包系统

雪泷背包

查看个人背包中的所有茶叶及其详细信息。

雪泷余额

查看当前拥有的金币数量。

雪泷喝茶 <茶叶名称>

享用背包中的茶叶，不同类型茶叶有不同的享受效果。

互动功能

雪泷茶艺展示

根据背包中茶叶种类和数量获得金币奖励。

雪泷茶叶评级

查看个人茶叶收藏评级，从青茶学徒到普洱宗师共5个等级。

任务系统

雪泷任务列表

查看所有可完成的任务，包括每日、每周和特殊任务。

雪泷领取奖励 <任务名称>

领取已完成任务的金币奖励。

管理员命令

商品管理

雪泷上架 <茶叶名称> <库存> <类型> <价格> <描述>

添加新茶叶商品到商店。

雪泷下架 <商品ID>

从商店移除指定商品。

雪泷补货 <商品ID> <数量>

为指定商品增加库存。

配置说明

管理员配置

插件支持管理员功能，管理员QQ号需配置在 admins.json 文件中：

{
  "admins": [
    "管理员QQ号1",
    "管理员QQ号2"
  ]
}

自定义素材

• 签到卡片背景图片可放置在 backgrounds 目录中
• 签到卡片字体文件为 font.ttf
• 默认头像为 avatar.png

开发信息

• 作者：furryHM-mrz
• 开源协议：MIT
• 项目地址：https://github.com/furryHM-mrz/astrbot_plugin_furry_cg

常见问题

插件无法正常工作

请确认是否已安装并启用了数据库插件 astrbot_plugin_furry_cgsjk。

签到卡片无法生成

请检查 font.ttf 字体文件是否存在，以及 backgrounds 目录中是否有背景图片。

命令无响应

请检查 AstrBot 日志，确认插件是否正常加载，以及是否有相关错误信息。

本插件签到部分采用saris_economic插件的