插件是什么

DPForge 的每个「插件」对应 DNF 服务端进程里的一段 Frida 注入逻辑。工具会把所有已启用插件的代码拼进 df_game_r.js，随服务端加载执行，从而实现登入播报、副本玩法、装备道具、运营管控等功能。

一个插件在云端就是一个 JSON 文件：元信息 + Hook 地址 + 设置项 schema + 注入代码。DPForge 拉取后即可在「插件配置」页勾选、改参数、生成部署。

插件 JSON 结构

把下面的对象保存成 plugins/<id>.json，并在 plugins/index.json 里登记一行即可：

{
  "schema": 1,
  "id": "extra_monster_reward",     // 唯一 id（英文/下划线）
  "cat": "dungeon",                 // 分类 id（见 index.json.categories）
  "name": "副本随机稀有怪",          // 显示名
  "ico": "👹",                       // emoji 图标
  "version": "1.0.0",               // 语义化版本
  "author": "your-name",            // 贡献者
  "initFn": "hook_extra_monster",   // 入口函数名（会被调用）
  "desc": "进房间按概率追加稀有怪并掉落道具。",
  "tags": ["副本玩法"],
  "hooks": [                        // 仅作展示/说明，实际 attach 在 code 内
    { "addr": "0x1234ABCD", "mode": "attach", "dup": false }
  ],
  "settings": [ /* 见「插件设置配置」 */ ],
  "code": "function hook_extra_monster(){ /* Frida 代码 */ }",
  "updatedAt": "2026-07-17"
}

注入处理逻辑

注入代码就是标准的 Frida JavaScript。约定：把所有逻辑包在一个与 initFn 同名的函数里，在函数内部用 Interceptor.attach 挂目标地址。

最小示例（强制某函数返回 1）

// initFn: HookDsSwordman_SkillSlot
function HookDsSwordman_SkillSlot() {
  Interceptor.attach(ptr(0x08608C98), {   // SkillSlot::checkMoveComboSkillSlot
    onEnter: function (args) { /* args[0]=this, args[1..]=参数 */ },
    onLeave: function (retval) { retval.replace(1) } // 改返回值
  });
}

读取参数 / 调用游戏内函数

function hook_user_inout_game_world() {
  Interceptor.attach(ptr(0x86C4E50), {          // GameWorld::reach_game_world
    onEnter: function (args) { this.user = args[1]; },
    onLeave: function () {
      var name = api_CUserCharacInfo_getCurCharacName(this.user);
      sendWelcomeMessage(this.user, name);      // 复用框架已有的公共函数
    }
  });
}

内存补丁（无 Hook）

// initFn: baitan14  —— 放开个人摆摊格子上限到 14
function baitan14() {
  Memory.protect(ptr(0xXXXXXXX), 4, 'rwx');
  ptr(0xXXXXXXX).writeU8(14);
}

插件设置配置

把可调参数写进 settings 数组，DPForge 会在「基本设置」里自动渲染成输入框 / 开关，并把用户填的值替换进代码中的 {{key}} 占位符。

"settings": [
  { "key": "boss_start_hour", "label": "开启时间(点)", "type": "number",
    "default": 21, "description": "每天几点整开启活动 (0-23)" },
  { "key": "phase2_dungeon_name", "label": "二阶段副本名", "type": "text",
    "default": "罗特斯宫殿", "description": "广播文案中显示的副本名称" },
  { "key": "phase1_unique_team", "label": "一阶段队伍去重", "type": "toggle",
    "default": false, "description": "同一队伍多次通关只计一次" }
]

字段	说明
key	参数名，同时是代码里的占位符 {{key}}
label	界面显示名
type	number / text / toggle
default	默认值
description	参数说明（显示在输入框旁）

在代码里使用占位符

var START_HOUR = {{boss_start_hour}};        // 数字直接替换
var DUNGEON    = "{{phase2_dungeon_name}}";  // 文本放进引号
if ({{phase1_unique_team}}) { /* toggle → true/false */ }

在 DPForge 中使用在线插件

DPForge 客户端从本站点拉取插件（约定接口，纯静态 JSON，支持跨域）：

• GET /plugins/index.json — 插件列表 + 分类
• GET /plugins/<id>.json — 单个插件完整定义

拿到 JSON 后合并进本地 modules.json（新增/覆盖同 id 项）+ 把 code 落地到 data/codes/<id>.js.tmpl，即可在「插件配置」页看到并启用。你也可以在插件详情里直接「复制 JSON」，手动导入。

贡献插件（在线提交）

不需要 Git、不需要自己部署站点。直接在本站 提交插件 页填写并提交：

1. 打开 提交插件，填 id / 分类 / 名称 / initFn / 说明 / 设置项 / 注入代码（可点「填入示例」参考）。
2. 点「提交审核」，你的插件进入待审核队列。
3. 站长在后台审核代码，通过后即刻上架到本站，所有 DPForge 用户可拉取。
4. 想更新已上架的插件？用同一个 id 再提交一次，审核通过即覆盖为新版。

部署到 Cloudflare（站长，免费）

本站用 Cloudflare Pages + Pages Functions + D1，投稿与审核都在你自己的站点内完成,全部免费额度即可。

1. 把 dpforge-site/ 推到 Git 仓库，Cloudflare → Workers & Pages → Create → Pages → 连接仓库（Framework=None，构建命令留空，输出目录 /）。
2. 创建 D1：npx wrangler d1 create dpforge-plugins，把返回的 database_id 填进 wrangler.toml。
3. 建表并导入示例：wrangler d1 execute dpforge-plugins --file=schema.sql、--file=seed.sql。
4. 在 Pages 项目 Settings → Functions → D1 bindings 绑定变量名 DB → 该数据库。
5. 在 Settings → Environment variables 加密变量 ADMIN_TOKEN（你的审核口令）。
6. 审核后台：访问 https://<你的域名>/admin.html，输入 ADMIN_TOKEN 即可批准/拒绝投稿、下架插件。