10 回收与云储：网页回收、@回收和累计奖励

回收系统分为两条主要链路：

1. 通用回收：玩家提交回收请求，成功后获得商城币、美金、声望、金条、通行证经验、称号或自定义奖励。
2. 云储回收：玩家把物品回收到云储仓库，后续可取出、上架或交易。

网页按钮和游戏内 @回收 本质上都是创建回收任务，只是入口不同。

回收队列独立于普通发货队列。后台清空普通发货队列时，不会清空正在处理的回收任务。

示例视频预留

这里后续可放“配置通用回收并让玩家游戏内回收”的视频，例如：/mp4/newwebdoc/10-recycle-flow.mp4

一、后台入口

后台 -> 通用回收
后台 -> 云储仓库
玩家前端 -> 回收
玩家前端 -> 个人信息 -> 云储仓库

二、通用回收配置

通用回收表里常见字段：

字段	说明
物品名	玩家看到或输入的回收名称
回收代码	用于查询/回收的游戏物品代码
奖励商城币	成功回收后增加商城币
奖励美金	成功后通过 RCON 增加游戏美金
奖励声望	成功后通过 RCON 增加声望
奖励金条	成功后通过 RCON 增加金条
奖励通行证经验	成功后增加通行证经验
自定义奖励	额外发送的命令或提示
累计数量	单次或阶段目标数量
累计奖励门槛	达到多少总回收数量后发达标奖励
回收开关	是否允许玩家回收

配置时，回收代码必须唯一。否则玩家提交同一个代码时无法稳定判断是哪条规则。

三、玩家如何回收

网页入口：

玩家前端 -> 回收 -> 选择物品 -> 提交回收

游戏内入口：

@回收物品名

例如：

@回收金锁

如果玩家输入不完整，系统会提示回收格式。

回收前建议玩家：

1. 确认自己在线。
2. 把要回收的物品放在身边。
3. 不要把不想回收的同类物品放在附近。
4. 提交后原地等待，不要连续重复提交。

四、回收任务为什么不是立即完成

回收需要向 RCON 发送查询/回收命令，并等待服务器回执。为了避免回执被普通发货、查询命令淹没，回收命令发送后会进入短暂保护窗口。

保护窗口内：

• 优先等待回收回执。
• 普通发货可能短暂停一下。
• 在线玩家、旗帜、车辆等查询会避让。

这就是玩家提交回收后可能需要等几秒的原因。

回收状态大致会经历：

待完成 -> 正在回收 -> 结算中 -> 成功/失败

同一玩家短时间内有未完成回收任务时，新请求可能会被拒绝，避免重复回收和回执串扰。

五、累计奖励

累计奖励只允许达成一次。

逻辑是按玩家、回收任务和成功回收数量统计：

玩家成功回收总数 >= 累计奖励门槛

如果未达到门槛，系统会提示进度，例如：

数量：7/10 | 进度：70%

如果达到门槛且未领取过，则发放累计奖励并记录领取。

如果已经领取过，则提示已获得达标奖励。

六、累计奖励类型

常用类型：

类型	发放方式
商城币	直接增加玩家商城币
美金	RCON 发送 #ChangeCurrencyBalance Normal 数量 SteamID
称号	给玩家添加称号

称号奖励允许玩家当前没有佩戴该称号，也允许称号未使用，只要后台称号数据存在且有效即可。

如果累计奖励带称号条件，玩家没有前置称号时，系统会提示任务完成但奖励失败原因。

七、云储回收

云储回收适合让玩家把物品存入商城仓库。

成功回收后，会进入：

云储_玩家仓库

玩家可以在个人信息的云储仓库中查看、取出或上架交易。

管理后台可以：

• 查看玩家仓库。
• 删除异常仓库记录。
• 管理可回收规则。
• 设置保管费用、保管天数、交易手续费。

八、常见玩家问题

问：我发了 @回收，为什么没马上提示成功？

答：回收需要等待服务器返回实际回收数量。请原地等待几秒，不要连续刷屏提交。

问：为什么提示进度没有给累计奖励？

答：累计奖励要达到后台设置的门槛才会发。未达到时只显示进度。

问：为什么达标后提示已获得？

答：累计奖励每个任务只能领取一次。说明你之前已经达成并领取过。

问：云储物品为什么取不出来？

答：可能是物品已上架、已失效、存在欠款，或 RCON 队列暂时未发送。请刷新仓库后再试。

九、管理排障检查表

1. 通用回收开关是否开启。
2. 回收代码是否唯一。
3. 玩家输入名称是否匹配物品名。
4. RCON 是否正常。
5. 游戏语句表_回收 是否存在待完成或正在回收任务。
6. 回收任务是否长期卡在正在回收。
7. 累计奖励门槛是否大于 0。
8. 奖励类型和奖励数量是否填写。
9. 云储仓库是否有过期或欠款记录。
10. 玩家是否在可回收物品附近或身上确实有该物品。

注意

回收和普通发货都依赖 RCON，但回收更依赖服务器回执。不要把回收速度理解成普通发货速度。