5.8 KiB
农场 · AstrBot
开通自己的农场，购买种子、播种、收获、管理仓库，与群友一起偷菜、开垦土地。 农场图片、商店、仓库和帮助菜单均可在聊天中查看，存档保存在本地。
安装与快速开始
在 AstrBot 插件市场搜索 astrbot_plugin_farm，或在插件管理中选择
「从文件安装」，上传作者提供的完整插件 ZIP。不要只上传 main.py。
安装依赖后重载插件。按你配置的唤醒前缀发送指令，下面以 / 为例：
/开通农场：创建农场，获得初始6块土地。/种子商店：查看种子名称、编号与价格。/购买种子 白萝卜 1，然后/播种 白萝卜 1。/我的农场查看状态，生长期间用/农场除虫清除虫害。- 成熟后
/收获，用/我的作物查看库存，或/出售作物出售。
发送 /农场帮助 查看当前版本自动生成的图片菜单；
发送 /农场帮助 文字 查看文字版。仅 /我的农场 高清 支持高清。
指令
[参数] 表示可选。作物支持名称或 #编号；同名作物请使用编号。
仓库默认图片，例如 /我的种子 2 文字。偷菜目标必须通过消息中的 @ 指定。
配置
| 配置项 | 默认值 | 说明 |
|---|---|---|
font_path |
空 | 中文字体路径；留空尝试系统字体，无可用字体时退回文字 |
data_dir |
空 | 留空使用 data/plugin_data/astrbot_plugin_farm；更改不会自动搬迁存档 |
image_format |
AUTO |
AUTO 为 JPEG；也可选 JPEG 或 PNG |
image_quality |
75 |
整数1～95，下一次图片请求生效；PNG不受影响 |
resource_source（资源获取地址） |
Github |
Github、Gitea、farm_service，重载生效 |
farm_service_url（farm_service 地址） |
空 | 独立HTTPS基础地址，供资源及后续活动服务共用；选farm_service下载时必填 |
除图片质量外，配置变更后请重载插件。高清农场的图片质量不低于85。
依赖 Pillow 和 aiohttp，由插件依赖声明安装；插件不捆绑中文字体。
当前重点适配 QQ/OneBot（aiocqhttp），其他平台尚未完成真实环境验证。
插件不携带大型assets.zip。启动时校验数据目录下缓存素材的SHA256，
缺失或不匹配时从所选源下载并校验后原子替换；GitHub/Gitea均从
farm_service仓库根目录assets/获取。默认Github，不自动跨源切换；
下载失败保留文字功能，调整来源后重载重试。两项配置始终同时存在，
活动功能尚未实现。已有正确缓存时不联网。
离线部署可将服务仓库的assets/assets.zip放到农场数据目录
assets/<SHA256>/assets.zip；SHA见插件的_vendor/farm_render/data/asset-manifest.json。
请先提交/发布服务仓库的素材，再发布依赖它的插件；不要把素材ZIP放回插件仓库。
玩法与旧账号兼容
- 新账号初始6块土地。
/开垦 条件查询下一块地的等级和费用，/开垦每次购买1块普通空地；未配置的地块不会扣款或放行。 - 可靠识别为初始3块地的旧账号，一次性追加3块普通空地，保留已有开垦成果、 作物、加成与资产。来源不明、编号异常或补后超过当前30个显示位置时， 保留原状并提示管理员处理，不截断、不折现。
- 新播种及下一季每半个基础生长周期生虫一次，间隔至少2小时。 已排定的旧生虫事件仍按原计划执行一次。
- 每只虫降低生长速度5%；成熟时每只虫使本季减产5%。成熟后除虫无法恢复 本季减产，请在生长期间及时除虫。
- 每日最多5次成功偷菜，北京时间零点重置；无可偷作物不消耗成功次数。
- 出售时自动跳过已锁定作物。仓库可使用作物编号操作。
升级与数据备份
升级前备份 data/plugin_data/astrbot_plugin_farm；若自定义 data_dir，
请备份实际目录。数据库为 farm.sqlite3，日志为 farm-preview.log。
旧库迁移前建议先在副本中验证。更换机器人、平台实例或部署不会自动合并账号。
新版当前没有签到、改名、土地升级、点券商店、外部金币兑换及旧远程服务功能。 请以当前帮助菜单为准，不要套用旧1.x版本指令。缺少稳定消息ID时， 插件会拒绝写操作以避免重复扣款。离线包校验及模拟宿主测试不代表线上验证。
QQ/OneBot 图片查询会请求发送者的腾讯头像用于农场及详情图片； 请求失败使用默认头像，成功缓存5分钟、失败缓存30秒，最多缓存16项。 其他平台使用默认头像。存档按部署、平台实例、机器人及用户隔离。
更新日志与反馈
代码许可见插件所附 LICENSE。角色图标为非官方二次创作，不表示获得官方授权； 角色与原作相关权利不因代码许可证而转移。
开发者本地构建
开发源为 Farm 主仓库。Windows 双击 build_astrbot.cmd，或运行
python scripts/build_plugin.py astrbot，构建后生成完整 ZIP 和校验文件。
每次使用独立输出目录，不安装或启动机器人、不自动推送远端。
版本来自 version.txt；命令表、元数据与展示文件由构建生成。