平台通知

全屏浏览 VibeHub

全屏浏览,获得更沉浸的体验。你可以随时通过菜单退出全屏。

返回《DoorKicker3 2D》

《DoorKicker3 2D》创意工坊

选择 Mod,下次启动自动加载

收藏用于稍后查找;“开启”决定下次启动时加载哪些 Mod。所有已开启 Mod 会一起进入游戏。

启动游戏

推荐方式 · 不需要懂编程

复制任务给 Agent,让它发布、更新或删除

Prompt 只注入作品、能力、依赖和你的 Mod ID,并要求 Agent 实时读取唯一官方 Skill;固定命令与规则不再复制到任务文本中。

作者允许的 Mod 能力

发布 Mod 时必须声明使用哪些能力。以下内容是作者约定,平台不会扫描或限制 Mod 代码;只安装你信任的内容。

联机策略:游戏进入联机前应禁用全部 Mod

武器weapons

用 MODS.registerWeapon() 登记新枪械:名称、兵种归属、穿甲、伤害、暴击、瞄准时间、射击间隔、精度曲线、射程、噪音、连发与弹匣。命中判定、穿甲计算、噪音传播仍走游戏原有逻辑,Mod 只提供数值。不能覆盖或替换内置武器。

作者声明:联机时不应使用

护甲armors

用 MODS.registerArmor() 登记新护甲:防护等级(0-70)、是否提供侧后防护、对移动速度的修正。不能覆盖内置护甲。

作者声明:联机时不应使用

敌人与单位enemies

用 MODS.registerEnemy() 登记新敌人:视野锥、视距、反应延迟、生命值、护甲、武器、行为标签(守卫/巡逻/包抄/压制/狙击/火箭/鼓舞/伏击/行刑者/自爆等)、代号色与威胁度。引用的武器和护甲必须已存在。

作者声明:联机时不应使用

关卡与任务missions

用 MODS.registerMission() 登记自制关卡:任务类型(清剿/人质/阻止处决/拆弹/抓捕/护送)、地图尺寸与随机种子、房间数、敌人数量与混编、建议出兵数、三星达标时间、难度与简报文本。房间布局由种子程序化生成,Mod 不能直接指定布局。

作者声明:联机时不应使用

默认编队squads

用 MODS.registerSquad() 覆盖 A/B/C/D 四种规模的默认出战编队(每人:姓名、兵种、主/副武器、护甲、夜视仪、投掷物、破门工具、GO Code)。会覆盖玩家看到的内置默认编队,多个 Mod 同时覆盖时后加载者生效。

作者声明:联机时不应使用

HUD 信息条hud

用 MODS.addHudBadge() 在游戏画面登记一个只读文本信息条(标签 + 每帧取值函数 + 颜色)。只能显示文本,不能操作 DOM、不能加按钮或拦截点击。纯本地展示,不影响任何战斗判定。

作者声明:只影响本地表现

战斗事件events

用 MODS.on() 监听 game-start / mission-start / mission-end / unit-died / frame 五类事件。处理器抛错会被隔离记录,不影响游戏与其它 Mod。适合做统计、播报、联动提示等纯观察型扩展;事件回调本身不改变战局。

作者声明:只影响本地表现

作者开发规范

Agent 会同时收到下面这份本游戏专属规范。

《破门而入 3 · 2D 战术小队》创意工坊开发规范

本文件写给 Mod 作者。它说明这个游戏开放了哪些能力、Mod 该怎么写、以及哪些事情不要做。


0. 一分钟速览

  • Mod 是一个独立目录,含 vibehub.mod.json + 一个入口脚本(.js)。
  • 入口脚本通过全局对象 MODS(也就是 window.DK2D.modApi)登记新内容:武器、护甲、敌人、任务、默认编队、HUD 挂件、事件监听。
  • 你不能修改游戏内部函数、不能碰 DOM、不能读存档、不能联网。
  • 引擎不扫描也不限制你的代码 —— 能力目录是我们之间的开发契约,不是安全沙箱。请按契约来写,越界的内容在联机模式下会被整包拒绝。

1. 你能做哪些 Mod

类型做法能力 ID
加武器MODS.registerWeapon()weapons
加护甲MODS.registerArmor()armors
加敌人MODS.registerEnemy()enemies
加关卡 / 任务MODS.registerMission()missions
改默认编队MODS.registerSquad()squads
加 HUD 信息条MODS.addHudBadge()hud
监听战斗事件MODS.on()events

以上都能在启动前(before-start)登记,游戏开局就会带上。启动后(after-start)登记的武器 / 护甲 / 敌人 / 任务要等下一次进入任务才生效(因为数据表在开局时读取)。


2. 最小可运行 Mod

目录结构:

my-mod/
├── vibehub.mod.json
└── main.js

vibehub.mod.json:

{
  "title": "战术沙鹰",
  "summary": "加一把大威力手枪和一张自制关卡",
  "description": "为小队添加「沙鹰·重锤」手枪,以及一张适合练枪的短图。",
  "version": "1.0.0",
  "releaseNotes": "首次发布",
  "entry": "main.js",
  "entryType": "classic",
  "loadPhase": "before-start",
  "dependencyIds": [],
  "capabilities": ["weapons", "missions"]
}

main.js:

// 1) 先申报自己(id 必须全局唯一,小写)
var id = MODS.define({
  id: 'mod.desert-eagle',
  name: '战术沙鹰',
  version: '1.0.0',
  apiVersion: 1
});
if (!id) return;   // 申报失败(id 冲突 / 版本不符)就安静退出,别抛错

// 2) 加一把手枪
MODS.registerWeapon(id, 'weapons.deagle', {
  name: '沙鹰 · 重锤',
  cls: 'pistol',
  pen: 18, dmg: 46, crit: 30,
  aim: [120, 200], reset: 380,
  start: 76, end: 34, range: 16,
  sound: 62, mob: 5, shots: 1, burst: 0, mag: 7
});

// 3) 加一张关卡
MODS.registerMission(id, {
  id: 'mod.eagle-range',
  cat: '自制关卡',
  name: '沙鹰靶场',
  type: 'clear',
  seed: 4242,
  gridW: 34, gridH: 26,
  squadSize: 2,
  roomCount: 4,
  enemies: 5,
  timeBeat: 60,
  diff: 'normal',
  desc: '两间房、五个靶子。拿新枪来试手感。',
  enemyMix: ['rabble', 'grunt', 'pistoler']
});

复制这段就能跑。注意 enemyMix 里每个键都必须是已存在的敌人(内置的或别的 Mod 登记过的),拼错会被拒绝并记进 MODS.report().errors。


3. 公开对象与登记函数

3.1 MODS.define(info) → namespace | null

每个 Mod 必须最先调用,且只调用一次。 返回值是它的命名空间,后面所有登记函数的第一个参数都要传它。

MODS.define({
  id: 'mod.my-mod',        // 必填。唯一。小写字母/数字 + . - _
  name: '我的 Mod',         // 显示名
  version: '1.0.0',
  apiVersion: 1,           // 你要用的 ModAPI 版本(当前为 1)
  author: '你的名字'         // 可选
});

失败情况(都返回 null,并在 MODS.report().errors 里留一条):

  • id 已被别的 Mod 占用
  • apiVersion 高于本作支持的版本

3.2 武器 MODS.registerWeapon(ns, id, def)

id 建议写成 weapons.xxx(点线命名,避免撞车)。

字段类型说明默认
namestring必填,显示名—
clsstring兵种归属:assault / support / marksman / grenadier / smg / pistol / lmg / shotgunassault
classesstring[]可选。想同时归多个兵种就用它(会出现在这些兵种的编队下拉里)—
pennumber穿甲值(0–70 制)20
dmgnumber命中伤害(队员满血 100)30
critnumber暴击(秒杀)概率 %20
aim[min, max]必填格式,瞄准时间 ms 区间[200, 340]
resetnumber射击间隔 ms320
start / endnumber近距离 / 远距离精度 %85 / 60
rangenumber有效射程 m35
soundnumber开火噪音半径 m(消音武器设 8 左右)60
mobnumber机动性修正(负数更笨重)−2
shotsnumber每次扣扳机连发数3
burstnumber连发间隔 ms90
magnumber弹匣容量30

注意:开枪命中判定、穿甲计算、噪音传播全部复用游戏原有逻辑,你只提供数值。别试图通过极端数值(比如 pen: 99999)绕过机制,那只会让关卡失去意义。

3.3 护甲 MODS.registerArmor(ns, id, def)

字段类型说明
namestring必填
levelnumber防护等级 0–70(自动夹取范围)
sideboolean是否提供侧后防护
speedModnumber对移动速度的修正

3.4 敌人 MODS.registerEnemy(ns, id, def)

字段类型说明默认
namestring必填—
fovnumber视野锥角度90
sightnumber视距 m13
reactnumber反应延迟 ms1500
hpnumber生命值100
armorstring护甲键(必须存在,内置或 Mod 的都行)none
weaponstring | null武器键(必须存在)。null 表示无武器(如自杀袭击者)AK47S
aistring[]行为标签,见下表['guard']
colorstring代号色#b8935a
threatnumber威胁度(显示用)3

可用行为标签:guard、patrol、flee、blindfire、sniper、rocket、buff、flank、suppress、ambush、executioner、suicide。

executioner 会让该单位看到队员/尸体/近距离枪声时提前处决人质;suicide 会让它在贴近后引爆。用它们之前先想清楚关卡还打不打得过。

3.5 任务 MODS.registerMission(ns, def)

字段类型说明默认
idstring必填,唯一—
namestring关卡名未命名关卡
catstring菜单分类标题自制关卡
typestring任务类型:clear / hostage / execute / bomb / hvt / vipclear
seednumber地图随机种子(同种子 = 同地图)9001
gridW / gridHnumber地图尺寸(格),自动夹到 24–80 / 18–6440 / 30
squadSizenumber建议出兵数(1–6)3
roomCountnumber房间数6
enemiesnumber敌人数量(1–40)8
timeBeatnumber三星达标时间(秒)90
diffstringnormal / hard / expertnormal
descstring简报文本—
enemyMixstring[]敌人混编,每个键必须存在['grunt']
hvtHostileboolean仅 type:'hvt'。true = 目标是敌方武装指挥官(会还击,需打伤/闪光/压制后活捉);默认 false = 平民打扮的中立逃跑者false
hvtNamestring仅 hvtHostile 时用:目标显示名(也会出现在 HUD 目标里)敌方指挥官
hvtWeaponstring仅 hvtHostile 时用:目标武器(必须已存在)AK47S
hvtArmorstring仅 hvtHostile 时用:目标护甲(必须已存在)plate3a
hvtExtractboolean仅 type:'hvt'。true = 逮捕之后还要把目标押到撤离点才算完成(清场后他会自动走向撤离点)false

两种高价值目标(type:'hvt'),击杀目标都会直接判负 —— 只能逮捕:

  • 中立版(hvtHostile 不填):平民打扮,靠近就逃;用视野锥瞄住他,他会举手投降,然后上前逮捕。
  • 敌方版(hvtHostile: true):武装、会还击,生命 150 且免疫暴击(不会被一枪秒杀)。 被打伤 / 被闪光弹震住 / 被火力压制后缴械投降;投降后队员会自动停止向他射击,此时上前逮捕。 用爆炸物把他炸死同样算失败 —— 想做"活捉"关就别在目标旁边扔手雷。

再加 hvtExtract: true 就是"逮捕并押走"(DK2 的 capture & extract): 胜利条件变成「目标已逮捕 + 已撤离到撤离点 + 敌人清空」。 逮捕后目标会跟随小队;区域清空后自动前往撤离点,半路被打死同样判负。 内置的 m15「与司马KHG的 PvP」就是这么做的。

关卡必须三种难度都打得通(至少 normal 下能通)。你没法直接指定房间布局,布局由 seed 程序化生成 —— 换个 seed 多试几张,挑一张顺手的。

选种子有个坑:同一个难度参数下,换一张地图可能让关卡从"能过"变成"开局就被团灭"。 内置关卡是用 _tools/realplay.js(拟真 AI 自动通关)筛过的 —— 建议你也用同样的办法试几个 seed。

3.6 默认编队 MODS.registerSquad(ns, key, list)

key 是 A / B / C / D,对应 2/3/4 人规模的默认编队。list 最多 6 人,每人:

{ name:'破门手', cls:'assault', primary:'weapons.deagle', secondary:'G17',
  armor:'plate3', nvg:true, gadgets:['frag','flash'],
  breachTools:['hand','kick','shotgun'], goCode:'A' }

⚠ 这会覆盖玩家看到的内置默认编队。除非你的 Mod 主题就是改编队,否则慎用;多个 Mod 同时覆盖同一个规模时,后加载的生效。

3.7 HUD 挂件 MODS.addHudBadge(ns, def)

MODS.addHudBadge(ns, {
  id: 'hud.ammo-total',
  label: '总弹药',
  text: (sim) => { /* 返回字符串 */ return String(sumAmmo(sim)); },
  color: '#9fd0ff'
});
  • text 是一个函数,每帧调用(必须很快返回,别在里做重活)。
  • 只能显示文本,不能改 DOM、不能加按钮、不能拦截点击。
  • 单个挂件抛错会被跳过,不影响其它挂件和游戏。

3.8 事件 MODS.on(ns, event, fn)

事件触发时机payload
game-start游戏初始化完成{ mods }
mission-start进入任务(开始规划){ sim, mission, squad }
mission-end任务结算{ sim, win, reason, stars }
unit-died任意单位死亡{ sim, unit, killer, side }
frame每帧{ sim, dt }

处理器抛错不会中断游戏 —— 会被捕获并记进 MODS.report().errors。但请不要靠"抛错"当控制流,也别在 frame 里做耗时操作。


4. 加载阶段与依赖

  • before-start(启动前):在游戏建立内容表之前执行。适合登记武器/护甲/敌人/任务/编队/挂件,以及注册事件。推荐默认用它。
  • after-start(启动后):游戏已可玩时执行。适合只需要监听事件、或想在下一次进任务时才补内容的 Mod。

硬性规则:

  1. 启动前 Mod 不能依赖启动后 Mod(后者还没跑)。
  2. 复制发布任务时如果给了 dependencyIds,那就是你声明的前置 Mod。查询可用依赖用平台接口 /api/works/<作品ID>/mods/options?q=<关键词>,用返回的准确 ID,别猜。
  3. 如果你需要"启动前 Mod 才能提供"的基础设施,那就必须自己也标 before-start。

5. 命名 / 去重 / 冲突规则

  • id 必须唯一。MODS.define 的 id 全局唯一;每个内容 id 也全局唯一。
  • 点线命名是约定:weapons.*、armor.*、enemies.*、任务用你自己的前缀(如 mod.eagle-range)。
    • 同名冲突时先登记的赢,后者会失败并留一条错误。请给内容 id 加上你的 Mod 前缀,别用 M4、weapons.gun 这种通用名。
  • 不能覆盖内置内容:registerWeapon('mod.x', 'M4', …) 会被拒绝。
  • 同一个 Mod 重复登记同一 id 也会被拒绝,不会静默覆盖。
  • 查看冲突:MODS.report() 会返回 { apiVersion, mods, errors, counts },errors 里每条都标了是哪个 Mod 出的问题。

6. 存档 / 联机 / 加载顺序 / 版本兼容

存档

  • 游戏的进度(关卡星级)和战术信条分别存在浏览器本地。Mod 不能读写存档,也拿不到玩家进度。
  • Mod 关卡按内置规则存星级。若你删掉了某张关卡,它留下的星级记录不会影响别的关卡。

联机

  • 本作的联机策略是 mods-disabled。
  • 含义:只要有任何 Mod 处于启用状态,游戏就会拒绝进入联机,而不是"尝试联机后各玩各的"。
  • 这个判断由游戏自己做(读 MODS.modsActive() / MODS.canEnterMultiplayer()),不依赖平台拦截。
  • 所以:想让玩家联机,就得先关掉 Mod 并刷新页面(内容是在加载时装配的,热关不生效)。

加载顺序

  • 多个 Mod 之间没有保证的先后(除 dependencyIds)。
  • 不要假设"我的 Mod 一定在别人之前跑"。所有跨 Mod 的假设都要通过显式依赖声明来表达。

版本兼容

  • MODS.API_VERSION = 1。define 时声明的 apiVersion 不得高于它。
  • 未来若扩展 API,只做向后兼容的加法(新增登记函数 / 新增事件),不会改变已有函数语义。
  • 发布后不要更改你已发布内容 id 的含义。玩家存档、其它 Mod 的依赖都可能引用它们。

7. 明确禁止的能力

以下内容不要做。它们要么技术上拿不到,要么即使拿到了也会破坏游戏和其它 Mod:

  1. 直接读写 localStorage —— 存档格式属于游戏内部,不容 Mod 改动。
  2. 操作 DOM —— 不能用 document / window 上加覆盖层、改按钮、改样式。 (HUD 只能通过 MODS.addHudBadge 登记文本。)
  3. 覆盖、替换或猴子补丁游戏内部函数 —— 例如改写 SIM.step、ENG.damage、UI.syncHud。所有扩展都必须走登记式 API。
  4. 访问账号凭证 / Token / 平台接口 / 管理功能 —— Mod 运行环境里没有这些,也不该有。
  5. 联网请求、加载远程脚本或资源 —— 图片、音频、字体、WASM、Worker 都必须打包在 Mod 目录内。Worker 用 VibeHubWorkshop.createWorker(modId, path)。
  6. 修改其它 Mod 的登记内容。
  7. 包内包含 node_modules / .git / 密钥 / 本地配置。
  8. 用极端数值或无限循环拖垮游戏(例如 frame 里死循环、把 text 写成慢查询)。

再次强调:能力目录是契约,不是沙箱。平台不会扫描你的代码。但违反契约的 Mod 在联机时会被整包拒绝,也可能被下架。


8. 调试建议

  • 在浏览器控制台里看 MODS.report():有没有加载成功、登记了什么、有没有冲突/报错,一目了然。
  • 加载阶段出问题会打印 [DK2D Mod] <modId>: <原因>。用「ID 前缀 + 说清原因」的写法定位。
  • 本地测试可以直接双击 index.html 打开(不需要平台),此时 VibeHubWorkshop 的三个 Promise 会立刻完成,游戏照常启动。
  • 提交前自查:
    • Mod 目录里有没有不该带的东西(node_modules、.git、密钥)?
    • 单文件 ≤ 25 MiB、文件数 ≤ 200、整包 ≤ 50 MiB?
    • capabilities 里只写了你真的用到的能力?
    • 关卡在 normal 难度下能通关吗?

9. 你能用到的公开接口(速查)

// 身份
MODS.define({id, name, version, apiVersion, author})   // → namespace

// 登记
MODS.registerWeapon(ns, id, def)
MODS.registerArmor (ns, id, def)
MODS.registerEnemy (ns, id, def)
MODS.registerMission(ns, def)
MODS.registerSquad (ns, 'A'|'B'|'C'|'D', list)
MODS.addHudBadge   (ns, {id, label, text, color})
MODS.on(ns, event, fn)

// 查询(给需要读游戏内容的 Mod 用;只读)
MODS.weapon(id) / MODS.armor(id) / MODS.enemy(id)
MODS.allWeapons() / MODS.allArmors() / MODS.allEnemies()
MODS.allMissions()
MODS.weaponExists(id) / MODS.armorExists(id) / MODS.enemyExists(id)

// 工坊
MODS.workshopEnabledMods()      // 当前启用的 Mod 列表
MODS.modsActive()              // 有没有 Mod 在用
MODS.multiplayerPolicy()       // 'mods-disabled' | 'author-managed'
MODS.canEnterMultiplayer()     // 现在能不能进联机

// 诊断
MODS.API_VERSION
MODS.report()

就这些。没有 MODS.override()、没有 MODS.hook()、没有 DOM 入口 —— 这是有意为之:登记的接口越窄,越少的 Mod 会让别人的 Mod 崩掉。

手动发布 Mod高级方式:手动填写资料并上传 ZIP 或入口脚本

发布你的 Mod

登录后可以上传完整 Mod 包或单脚本。

登录