论坛与业务配置

论坛基于 phpwind，负责登录态、账号归属、商品目录、计价、积分事务、订单状态机和系统通知。GameAgent 负责账号字段及存档写入。业务配置的权威来源是论坛 MySQL；PHP 文件只提供入口、模板和非敏感默认值。

版本与入口

配置	中文说明
game_profile	订单、绑定、角色和套餐所属版本，固定为 109b 或 113c。
d2109/d2109.php	1.09 独立玩家入口；文件内固定 109b，不读取 113 PHP。
d2109/d2chat.php	1.09 独立论坛聊天兼容入口；只跳转到同目录的 109 玩家入口。
d2113/d2113.php	1.13c 独立玩家入口；文件内固定 113c，不读取 109 PHP。
d2113/d2chat.php	1.13c 独立论坛聊天兼容入口；只跳转到同目录的 113 玩家入口。
D2109_FORUM_ENTRY_PATH	后台定位 109 入口的路径；重命名文件时同步修改。
D2113_FORUM_ENTRY_PATH	后台和 Agent 定位 113 入口的路径；重命名文件时同步修改。
D2109_FORUM_INTERNAL_TOKEN / D2113_FORUM_INTERNAL_TOKEN	两版各自的论坛内部服务令牌，不得相同。
D2109_FORUM_CSRF_SECRET / D2113_FORUM_CSRF_SECRET	两版各自的表单 CSRF 密钥，必须独立于 API 令牌。

后台业务设置

分组	可配置项	生效规则
论坛前端维护	立即开关、定时开关、开始/结束时间、玩家提示	立即开关或当前处于定时窗口时，公开交易、自助、VIP、注册和绑定返回维护页；管理员和内部接口仍可用。
支付币种	游戏币、符文组合分别启用	禁用后前端不展示，服务端仍需拒绝篡改提交。
买家手续费	固定金额或万分比、最低费用	比例模式计算后不足 1 游戏币扣 1；配置为 0 时不收费。
发布广告	总开关、广告费用、消息前缀	关闭时前端不可勾选且服务端拒绝；费用为 0 可免费广播。
账号绑定	每用户绑定上限	以 PvPGN BBSUID 为权威关系，论坛缓存可重建。
VIP 套餐	天数、价格、启用、重复购买确认	到期时间直接读写 PvPGN auth_member_expire_time，论坛购买记录不能作为余额基准。
游戏内商店	手工物品、符文分别启用和定价	仅第一幕基德；普通商店投放符文，赌博商店投放手工物品。
自助套餐	草稿、发布版本、动作、条件、价格	只有 enabled=1 且已发布的活动版本可购买。
材料组合	任意合法物品、数量、品质、物品等级	项链、戒指等底材的词缀按物品等级和客户端数据表生成。

通知与提示信息

每个版本有独立模板文件：

• d2109/d2109_notification_templates.php
• d2113/d2113_notification_templates.php

两个模板都是完整配置，互不 include、继承或回退。模板使用命名占位符，例如 {service}、{account}、{character}、{cost}、{balance}、{expires_at}、{order_id}。模板层只负责文案，不重新计算价格、余额或 VIP 时间。完整配置和测试方法见提示与通知文案。

重命名入口

入口内部通过 SCRIPT_NAME 生成表单、跳转、图片和 AJAX 地址，因此 PHP 文件改名后站内功能不会引用旧名称。重命名时必须同步更新 catalog.json 和对应项目的 deploy/runtime.json：109 使用 D2109_FORUM_*，113 使用 D2113_FORUM_*。之后运行 d2ctl validate 再部署。目录边界 d2109/、d2113/ 不应互换，也不得恢复论坛根目录的共享 d2chat.php。

定时维护

在后台“交易管理”顶部选择国度后设置论坛前端维护。时间由浏览器本地时间转换成 Unix 时间戳，论坛按请求到达时的服务器时间判断，因此无需 Windows 计划任务；服务重启后窗口仍然有效。开始时间包含在维护期内，结束时间到达后自动恢复。立即维护和定时维护独立，任一条件成立都会展示维护页。

保存后先确认后台显示的“当前状态”，再分别打开该版本主入口和 d2chat.php 兼容入口。维护页返回 HTTP 503；后台内部管理、商品回调和消息桥接不经过玩家维护判定。

数据责任

数据	权威来源	论坛可保存内容
游戏账号绑定	PvPGN BBSUID	页面缓存、验证时间和审计，不作为最终归属。
VIP 到期	PvPGN auth_member_expire_time	订单、通知和历史，不累计计算当前到期。
角色存档	D2DBS CHARSAVE	revision、展示索引和操作回执。
论坛积分	phpwind 积分账本	余额、预扣、退款和对账。
交易/自助订单	论坛 MySQL	完整状态机、幂等号、费用与通知状态。

编码

phpwind 8.7 页面可能使用 GBK，源码和通知模板发布前必须用正式 PHP 5.6 执行语法检查，并确认中文没有被 UTF-8/GBK 二次转码。游戏内繁体提示还需按对应客户端编码验证。