社区农场 NongChang

社区农场小游戏：种菜、浇水、收获、卖钱、偷菜、集市稀缺作物、看门狗、每日签到、排行榜、黑土地升级与一键收割，完全对接社区积分(coins)货币体系。

功能简介

• 🌱 种菜：6 种普通作物（萝卜、白菜、土豆、玉米、西瓜、草莓）直接用积分买种子
• 💧 浇水：每次浇水加速作物生长 12%，达到指定浇水次数才能成熟
• 🌾 收获：成熟后收获入仓库，获得农场经验
• 💰 卖钱：仓库作物可一键卖出，直接兑换社区积分
• 🦝 偷菜：访问好友农场偷取成熟作物（比例可配，默认 30%），每日限偷次数可配
• ⭐ 等级：收获获得经验升级，初始 1 块地，按等级阶梯解锁，上限 16 块
• 🏪 集市：4 种稀缺作物（葡萄、菠萝、蘑菇、板栗）仅能通过集市用积分购买种子，每日限购
• 🐕 看门狗：雇佣看门狗守护农场，偷菜者有一定概率被抓住并罚款（罚款归主人）
• 📅 每日签到：签到领取积分与农场经验奖励
• 🏆 排行榜：右侧栏实时展示农场经验排行（头像与社区头像一致）
• 🖤 黑土地：每块地累计种植满指定次数（默认 100 次）可升级为黑土地，成熟时间缩短（默认 ×0.75）
• ⚡ 一键收割：VIP/指定用户等级或达到农场等级门槛的用户可一键收获全部成熟作物（可配手续费）

作物表

普通作物（种子商店直接购买）

稀缺作物（仅集市购买种子）

以上全部数值均可在后台「农场设置」中逐个覆盖调整。

货币对接

• 种子购买、集市购买、看门狗雇佣、一键收割手续费：扣除社区 积分(coins)
• 卖菜收入、偷菜收入、被抓罚款（归主人）、签到奖励：增加社区 积分(coins)
• 所有资金变动写入 communitycoinlog 流水表，类型为 farmseed / farmsell / farmsteal / farmmarket / farmdog / farmsign / farmharvestall / farm_fine

安装

1. 将 plugins/NongChang/ 目录上传至站点 plugins/ 下
2. 后台「应用中心」找到「社区农场」，点击「安装」→「启用」
3. 前台顶部栏会出现 🌱 图标，点击进入农场
4. 后台左侧菜单「农场设置」可调整全部参数

后台配置项

后台「农场设置」提供以下可配置项：

数据表

• nongchangfield：农田地块（含 planttotal 累计种植次数、soil_level 土壤等级）
• nongchang_inventory：仓库（用户 × 作物 × 数量）
• nongchang_seed：种子袋（集市购买的稀缺种子）
• nongchang_user：农场用户信息（经验、偷菜计数、签到、看门狗到期时间）
• nongchang_log：操作日志（含集市购买限购统计）

目录结构

plugins/NongChang/
├── NongChangPlugin.php      # 插件入口（配置/菜单/钩子）
├── plugin.json
├── icon.svg
├── install.sql              # 5 张数据表
├── routes.php               # 前台 + 后台路由
├── README.md
├── controller/
│   ├── Index.php            # 前台控制器（页面 + API）
│   └── admin/
│       ├── Base.php
│       └── Index.php        # 后台「农场设置」
├── service/
│   ├── Crops.php            # 作物配置（支持后台覆盖）
│   └── FarmService.php      # 核心业务逻辑
├── view/
│   ├── front/
│   │   └── index.html       # 农场主页
│   └── admin/
│       └── index.html       # 后台配置页
└── static/
    ├── nongchang.css
    └── nongchang.js

常见问题

Q1：种植提示积分不足？  

A：种子需要消耗社区积分，可通过每日签到、发帖等方式获取积分。

Q2：作物一直不成熟？  

A：需要同时满足两个条件：生长时间到期 + 浇水次数达标。点击作物即可浇水，每次浇水加速 12%。

Q3：怎么偷好友的菜？  

A：点击「好友」按钮，选择关注的用户进入其农场，点击成熟的作物即可偷取。如果对方雇佣了看门狗，可能被抓并罚款。

Q4：地块数量如何增加？  

A：初始 1 块地，收获作物获得经验升级，按后台配置的等级阶梯解锁，最多 16 块。

Q5：稀缺作物怎么种？  

A：稀缺作物（葡萄、菠萝、蘑菇、板栗）不能直接在种子商店购买，需先到「集市」用积分购买种子（每日限购），种子进入种子袋后即可种植。

Q6：黑土地有什么用？  

A：单块地累计种植满 100 次（可配）后可升级为黑土地，黑土地上作物成熟时间缩短 25%（可配）。

Q7：一键收割谁能用？  

A：管理员始终可用；普通用户需满足后台配置的「允许的用户等级名称」或「最低农场等级」任一条件。可配置每次收割的手续费。

Q8：看门狗怎么工作？  

A：雇佣后守护期内，偷菜者按配置概率被抓住：偷菜失败并被罚款（罚款转给农场主人）。守护期可重复购买累加。

更新日志

• v1.0.01（2026-10-20）

 - 新增集市：4 种稀缺作物 + 每日限购 + 种子袋

 - 新增看门狗：概率抓贼 + 罚款双向转账

 - 新增每日签到（积分 + 经验）

 - 新增农场排行榜（右侧栏，头像与社区一致）

 - 新增黑土地升级（累计种植次数阈值 + 成熟加速）

 - 新增一键收割（VIP 等级/农场等级门槛 + 可配手续费）

 - 土地解锁改为 1 块起步、等级阶梯可配、上限 16 块

 - 新增后台「农场设置」页：全部数值可配，10 种作物参数逐个覆盖

• v1.0.0（2026-10-20）

 - 初始版本：种菜、浇水、收获、卖钱、偷菜、等级系统

 - 完全对接社区积分货币体系