矿矿矿（矿场游戏）kuang

社区矿场经营小游戏：开采矿石、合成水晶、购买房屋与矿工、矿石兑换积分、水晶提现，并集成“打劫”与“发帖消耗矿石”玩法，完全对接社区积分体系。

作者：kuakeba.cn

功能简介

• 挖矿产出：矿场按周期自动产出矿石，支持离线累计（默认最多 12 小时），可单个收取或一键收取全部
• 矿石体系：后台自定义矿石名称、图标、兑换比例与排序，默认铁/铜/银/金四种矿石
• 矿场系统：自定义矿场（关联矿石、单次产量、产出周期、可派驻矿工上限），矿工需派驻后才开始产出
• 水晶工厂：自定义合成配方（多种矿石 + 手续费），合成水晶用于提现或继续发展
• 房屋/矿工：房屋决定矿工容量，矿工拥有不同产量倍率，价格可在后台调整
• 矿石兑换：矿石按后台比例直接兑换为社区积分/金币/人民币（可配置交易货币类型）
• 水晶提现：设置最低提现水晶与“多少水晶兑 1 元”，支持自定义提现渠道，后台审核通过或驳回
• 新人礼包：新玩家首次进入自动赠送水晶、房屋、矿工与矿石
• 矿场动态：收取、派驻、购买、兑换、合成、提现、打劫等行为写入动态与排行榜
• 打劫玩法：可打劫矿石、交易积分、水晶、矿工，按资源类型配置消耗、成功率、掠夺比例、单次上限、双方最低门槛，支持每日次数限制、“劫富济贫”加成与站内通知
• 发帖消耗：按用户等级与版块配置发帖所需矿石类型与数量，扣除后写入矿场动态；矿石不足时自动拦截发帖
• 后台管理：基础设置、矿石/矿场/工厂/房屋/矿工管理、玩家资产调整、封禁、提现审核、矿场动态、打劫规则、发帖消耗规则

默认矿石

默认矿场

默认水晶工厂

默认房屋与矿工

以上数值均可在后台“基础设置”与对应资源管理页面中调整。

货币与提现

• 矿石兑换、房屋/矿工购买、打劫消耗：扣除社区交易积分（默认 coins，可切换 gold/cny）
• 矿石兑换收入、打劫所得：增加对应交易积分
• 提现申请：扣除水晶并生成待审核记录；审核通过可配置自动到账人民币，驳回自动退还水晶
• 所有资产变动记录到 communitycoinlog，矿场行为记录到 kuang_log

打劫规则

打劫支持四种资源：矿石、交易积分、水晶、矿工。后台“打劫规则”为每种资源独立配置：

• 是否启用
• 打劫消耗积分
• 基础成功率
• 掠夺比例（对方该类资源数量的百分比；矿工固定掠夺 1 个）
• 单次掠夺上限
• 被劫者最低持有数量
• 打劫者最低持有数量

同时支持“劫富济贫”加成（打劫者持有量少于对方时提高成功率，最高封顶 95%）、每日打劫/被打劫次数限制、被打劫站内通知。前台可按资源类型切换目标列表，按持有量从高到低排序。默认仅开启矿石打劫，积分/水晶/矿工需在后台手动开启。

发帖消耗

后台“发帖消耗”按用户等级与版块配置：

• 指定用户等级、指定版块、消耗矿石类型、消耗数量、启用状态
• 规则按“版块 + 等级”精确匹配，未匹配时回退到更宽泛的规则
• 新主题发布时扣除矿石；矿石不足抛出拦截异常，宿主自动回滚主题与悬赏
• 扣除记录写入矿场动态

安装

1. 将 plugins/kuang/ 目录上传至站点 plugins/ 下
2. 后台“应用中心”找到“矿场游戏”，点击“安装”后启用
3. 前台访问 /kuang 进入矿场，/kuang/rob 进入打劫页面
4. 后台左侧菜单“矿场游戏”进入管理，首次安装会自动注册菜单与权限规则

安装时自动执行 install.sql 建表并写入默认矿石、矿场、工厂、房屋、矿工与打劫规则，同时将插件 static/ 复制到 public/static/kuang/。

后台管理

• 基础设置：启用开关、页面标题/说明/SEO、交易货币、离线累计小时、新人礼包、水晶汇率、提现门槛与渠道、打劫次数/加成/通知、发帖消耗开关、各模块规则文案、卸载是否清空数据
• 矿石/矿场/工厂/房屋/矿工：增删改查，矿石被矿场或工厂引用时禁止删除，房屋/矿工被玩家持有后禁止删除
• 玩家管理：按用户名/昵称搜索，查看并调整水晶、矿石、房屋、矿工资产，支持封禁与解封
• 提现审核：按状态筛选，审核通过或驳回并填写备注
• 矿场动态：按行为类型与关键字检索全部玩家行为日志
• 打劫规则：按矿石配置消耗、成功率、比例、上限与门槛
• 发帖消耗：按版块与用户等级配置消耗矿石

目录结构

plugins/kuang/
├── plugin.json              插件元信息
├── KuangPlugin.php          插件入口、配置项、安装/卸载、菜单与发帖钩子
├── routes.php               前台与后台路由
├── install.sql              数据表与默认数据
├── icon.svg / icon.png      插件图标
├── README.md                使用文档
├── controller/
│   ├── Index.php            前台页面与 AJAX 接口
│   └── admin/               后台管理控制器
├── service/
│   ├── Kuang.php            资产、配置、日志等公共方法
│   ├── MiningService.php    挖矿、派驻、兑换、合成、商店、提现
│   ├── RobService.php       打劫规则、目标列表与打劫结算
│   ├── WithdrawService.php  提现申请、审核、驳回
│   └── ThreadService.php    发帖消耗矿石
├── static/                  前台 JS/CSS 与后台 JS/CSS
└── view/
    ├── front/               前台模板
    └── admin/               后台模板

卸载说明

后台卸载插件时会移除菜单与权限规则；默认保留数据表。如需彻底清空，请在“基础设置”中开启“卸载时清除数据”后再卸载。

依赖

• 社区插件 community（成员体系、积分服务、主题发布钩子、前台布局）
• 消息插件 message（被打劫站内通知，未安装时自动跳过）
• 用户等级服务 app\service\UserLevelService（发帖消耗规则匹配）