weapons用 MODS.registerWeapon() 登记新枪械:名称、兵种归属、穿甲、伤害、暴击、瞄准时间、射击间隔、精度曲线、射程、噪音、连发与弹匣。命中判定、穿甲计算、噪音传播仍走游戏原有逻辑,Mod 只提供数值。不能覆盖或替换内置武器。
作者声明:联机时不应使用
《DoorKicker3 2D》创意工坊
收藏用于稍后查找;“开启”决定下次启动时加载哪些 Mod。所有已开启 Mod 会一起进入游戏。
推荐方式 · 不需要懂编程
Prompt 只注入作品、能力、依赖和你的 Mod ID,并要求 Agent 实时读取唯一官方 Skill;固定命令与规则不再复制到任务文本中。
发布 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用 MODS.addHudBadge() 在游戏画面登记一个只读文本信息条(标签 + 每帧取值函数 + 颜色)。只能显示文本,不能操作 DOM、不能加按钮或拦截点击。纯本地展示,不影响任何战斗判定。
作者声明:只影响本地表现
events用 MODS.on() 监听 game-start / mission-start / mission-end / unit-died / frame 五类事件。处理器抛错会被隔离记录,不影响游戏与其它 Mod。适合做统计、播报、联动提示等纯观察型扩展;事件回调本身不改变战局。
作者声明:只影响本地表现
Agent 会同时收到下面这份本游戏专属规范。
本文件写给 Mod 作者。它说明这个游戏开放了哪些能力、Mod 该怎么写、以及哪些事情不要做。
vibehub.mod.json + 一个入口脚本(.js)。MODS(也就是 window.DK2D.modApi)登记新内容:武器、护甲、敌人、任务、默认编队、HUD 挂件、事件监听。| 类型 | 做法 | 能力 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)登记的武器 / 护甲 / 敌人 / 任务要等下一次进入任务才生效(因为数据表在开局时读取)。
目录结构:
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。
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 高于本作支持的版本MODS.registerWeapon(ns, id, def)id 建议写成 weapons.xxx(点线命名,避免撞车)。
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
name | string | 必填,显示名 | — |
cls | string | 兵种归属:assault / support / marksman / grenadier / smg / pistol / lmg / shotgun | assault |
classes | string[] | 可选。想同时归多个兵种就用它(会出现在这些兵种的编队下拉里) | — |
pen | number | 穿甲值(0–70 制) | 20 |
dmg | number | 命中伤害(队员满血 100) | 30 |
crit | number | 暴击(秒杀)概率 % | 20 |
aim | [min, max] | 必填格式,瞄准时间 ms 区间 | [200, 340] |
reset | number | 射击间隔 ms | 320 |
start / end | number | 近距离 / 远距离精度 % | 85 / 60 |
range | number | 有效射程 m | 35 |
sound | number | 开火噪音半径 m(消音武器设 8 左右) | 60 |
mob | number | 机动性修正(负数更笨重) | −2 |
shots | number | 每次扣扳机连发数 | 3 |
burst | number | 连发间隔 ms | 90 |
mag | number | 弹匣容量 | 30 |
注意:开枪命中判定、穿甲计算、噪音传播全部复用游戏原有逻辑,你只提供数值。别试图通过极端数值(比如 pen: 99999)绕过机制,那只会让关卡失去意义。
MODS.registerArmor(ns, id, def)| 字段 | 类型 | 说明 |
|---|---|---|
name | string | 必填 |
level | number | 防护等级 0–70(自动夹取范围) |
side | boolean | 是否提供侧后防护 |
speedMod | number | 对移动速度的修正 |
MODS.registerEnemy(ns, id, def)| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
name | string | 必填 | — |
fov | number | 视野锥角度 | 90 |
sight | number | 视距 m | 13 |
react | number | 反应延迟 ms | 1500 |
hp | number | 生命值 | 100 |
armor | string | 护甲键(必须存在,内置或 Mod 的都行) | none |
weapon | string | null | 武器键(必须存在)。null 表示无武器(如自杀袭击者) | AK47S |
ai | string[] | 行为标签,见下表 | ['guard'] |
color | string | 代号色 | #b8935a |
threat | number | 威胁度(显示用) | 3 |
可用行为标签:guard、patrol、flee、blindfire、sniper、rocket、buff、flank、suppress、ambush、executioner、suicide。
executioner会让该单位看到队员/尸体/近距离枪声时提前处决人质;suicide会让它在贴近后引爆。用它们之前先想清楚关卡还打不打得过。
MODS.registerMission(ns, def)| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
id | string | 必填,唯一 | — |
name | string | 关卡名 | 未命名关卡 |
cat | string | 菜单分类标题 | 自制关卡 |
type | string | 任务类型:clear / hostage / execute / bomb / hvt / vip | clear |
seed | number | 地图随机种子(同种子 = 同地图) | 9001 |
gridW / gridH | number | 地图尺寸(格),自动夹到 24–80 / 18–64 | 40 / 30 |
squadSize | number | 建议出兵数(1–6) | 3 |
roomCount | number | 房间数 | 6 |
enemies | number | 敌人数量(1–40) | 8 |
timeBeat | number | 三星达标时间(秒) | 90 |
diff | string | normal / hard / expert | normal |
desc | string | 简报文本 | — |
enemyMix | string[] | 敌人混编,每个键必须存在 | ['grunt'] |
hvtHostile | boolean | 仅 type:'hvt'。true = 目标是敌方武装指挥官(会还击,需打伤/闪光/压制后活捉);默认 false = 平民打扮的中立逃跑者 | false |
hvtName | string | 仅 hvtHostile 时用:目标显示名(也会出现在 HUD 目标里) | 敌方指挥官 |
hvtWeapon | string | 仅 hvtHostile 时用:目标武器(必须已存在) | AK47S |
hvtArmor | string | 仅 hvtHostile 时用:目标护甲(必须已存在) | plate3a |
hvtExtract | boolean | 仅 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。
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 同时覆盖同一个规模时,后加载的生效。
MODS.addHudBadge(ns, def)MODS.addHudBadge(ns, {
id: 'hud.ammo-total',
label: '总弹药',
text: (sim) => { /* 返回字符串 */ return String(sumAmmo(sim)); },
color: '#9fd0ff'
});
text 是一个函数,每帧调用(必须很快返回,别在里做重活)。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 里做耗时操作。
before-start(启动前):在游戏建立内容表之前执行。适合登记武器/护甲/敌人/任务/编队/挂件,以及注册事件。推荐默认用它。after-start(启动后):游戏已可玩时执行。适合只需要监听事件、或想在下一次进任务时才补内容的 Mod。硬性规则:
dependencyIds,那就是你声明的前置 Mod。查询可用依赖用平台接口 /api/works/<作品ID>/mods/options?q=<关键词>,用返回的准确 ID,别猜。before-start。id 必须唯一。MODS.define 的 id 全局唯一;每个内容 id 也全局唯一。weapons.*、armor.*、enemies.*、任务用你自己的前缀(如 mod.eagle-range)。
M4、weapons.gun 这种通用名。registerWeapon('mod.x', 'M4', …) 会被拒绝。MODS.report() 会返回 { apiVersion, mods, errors, counts },errors 里每条都标了是哪个 Mod 出的问题。存档
联机
mods-disabled。MODS.modsActive() / MODS.canEnterMultiplayer()),不依赖平台拦截。加载顺序
dependencyIds)。版本兼容
MODS.API_VERSION = 1。define 时声明的 apiVersion 不得高于它。以下内容不要做。它们要么技术上拿不到,要么即使拿到了也会破坏游戏和其它 Mod:
localStorage —— 存档格式属于游戏内部,不容 Mod 改动。document / window 上加覆盖层、改按钮、改样式。
(HUD 只能通过 MODS.addHudBadge 登记文本。)SIM.step、ENG.damage、UI.syncHud。所有扩展都必须走登记式 API。VibeHubWorkshop.createWorker(modId, path)。node_modules / .git / 密钥 / 本地配置。frame 里死循环、把 text 写成慢查询)。再次强调:能力目录是契约,不是沙箱。平台不会扫描你的代码。但违反契约的 Mod 在联机时会被整包拒绝,也可能被下架。
MODS.report():有没有加载成功、登记了什么、有没有冲突/报错,一目了然。[DK2D Mod] <modId>: <原因>。用「ID 前缀 + 说清原因」的写法定位。index.html 打开(不需要平台),此时 VibeHubWorkshop 的三个 Promise 会立刻完成,游戏照常启动。node_modules、.git、密钥)?capabilities 里只写了你真的用到的能力?normal 难度下能通关吗?// 身份
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 包或单脚本。
登录反馈渠道
有任何问题、建议或反馈,请加 VibeHub 官方支持群:
QQ 752883513
进群后请直接在群里提反馈,我们会及时关注并处理。