平台通知

全屏浏览 VibeHub

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

返回《三角洲 2D 搜打撤》

《三角洲 2D 搜打撤》创意工坊

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

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

启动游戏

推荐方式 · 不需要懂编程

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

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

作者允许的 Mod 能力

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

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

注册武器weapons.register

通过 modApi.weapons.register(key, def) 注册或覆盖武器定义,影响本地武器表,不修改已有武器实例的运行时状态。

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

读取武器weapons.read

通过 modApi.weapons.get / listAll 读取武器定义快照,只读,不修改。

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

注册 NPC 模板npcs.register-template

通过 modApi.npcs.registerTemplate 注册敌方模板,注入到本地敌人生成流程,不修改已有敌人实例。

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

应用 NPC 模板npcs.apply-to

通过 modApi.npcs.applyTo 对一个敌人实例应用已注册模板,影响本地敌人参数。

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

读取 NPCnpcs.snapshot

通过 modApi.npcs.snapshot 读取敌人快照,只读,不修改。

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

地图装饰maps.decorate

通过 modApi.maps.decorate 注册装饰回调,只在本地渲染层追加装饰,不修改碰撞与地形。

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

读取玩家player.snapshot

通过 modApi.player.snapshot 读取玩家快照,只读,不修改。

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

玩家回血player.heal

通过 modApi.player.heal 给本地玩家加血,不超过最大生命值。

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

伤害钩子player.hook-damage

通过 modApi.player.hookDamage 注册玩家受击前回调,可改写本地玩家受到的伤害。

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

子弹钩子player.hook-fire

通过 modApi.player.hookFireBullet 注册开火前回调,可改写本地子弹定义。

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

搜索产物钩子loot.hook-roll

通过 modApi.loot.hookRoll 注册容器搜索产物回调,可改写本地生成的物品列表。

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

订阅事件events.subscribe

通过 modApi.events.on 订阅平台事件,只读监听,不修改游戏状态。

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

广播事件events.emit

通过 modApi.events.emit 广播自定义事件给其他 Mod 订阅

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

只读游戏数据refs.read-only

通过 modApi.refs 读取 WEAPONS / ITEMS / ENEMY_TYPES / EXTRACTS 顶层字典,只读,不修改。

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

作者开发规范

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

三角洲 2D 搜打撤 · VibeHub 创意工坊 Mod 开发指南

本文件是《三角洲 2D 搜打撤》(Delta 2D) 的工坊作者—创作者约定。平台不会扫描或限制 Mod 代码, 只会读取 WORKSHOP_CAPABILITIES.json 决定 UI 上展示哪些能力。

本游戏是单机模式,没有联机匹配,且联机策略为 mods-disabled:所有 Mod 只影响本地表现。

  • 游戏版本:v3.0.0(工坊层 v1)
  • Mod API 版本:window.VibeHubGame(workshop: "v1")
  • 入口:const api = window.VibeHubGame.modApi;

1. 玩家可以制作哪些 Mod

类别示例用到的主要 API
新武器 / 改枪「M4A1 黄金版:伤害 +15%」「一把 SCAR-H」api.weapons.register(key, def)
NPC 强化「敌方血量 ×1.5、反应更快」「首领必带 SR-25」api.npcs.registerTemplate(tpl)
玩家增益「血量上限 150」「击杀回血 10」api.player.hookDamage + api.events.on('kill')
子弹规则「穿甲弹:命中后 30% 伤害穿透到下一个目标」api.player.hookFireBullet
事件驱动「每次击杀 +¥50」「撤离时提示」api.events.on(event, fn)
物资调整「所有容器必出 1 个血包」api.loot.hookRoll(fn)
地图装饰「在撤离点附近加一圈路灯」api.maps.decorate(fn)

多 Mod 叠加:weapons.register 同 key 后注册覆盖先注册;registerTemplate 同 id 后注册覆盖先注册; 模板之间按「相乘」叠加;钩子按注册顺序串联,任一返回值即改写。


2. 加载阶段

阶段适合做的事不适合做的事
before-start注册武器、NPC 模板、地图装饰订阅运行时事件、改写运行中的敌人
after-start订阅事件、注册伤害/子弹/搜索钩子、查询状态注册新武器(交易行已渲染)

执行顺序:

Loader → before-start Mod(并行,按 dependencyIds 拓扑序)
→ 游戏暴露 window.VibeHubGame.modApi
→ 玩家点「开始行动」→ 对局开始 → 触发 round:start
→ 游戏调用 VibeHubWorkshop.markGameReady()
→ Loader 拉取 after-start Mod → api.phase.ready 变为 true,onReady 回调触发
  • before-start Mod 可安全调用:weapons.*、npcs.registerTemplate、maps.decorate、events.on(仅注册)。
  • before-start 阶段不要调用 player.heal / hookDamage / hookFireBullet(此时还没有对局)。
  • after-start Mod 请先 await 就绪:await new Promise(r => api.phase.ready ? r() : api.phase.onReady(r));

3. API 一览

API用途阶段
api.weapons.register(key, def)注册/覆盖武器到 WEAPONS,并刷新交易行before-start
api.weapons.get(key)读单个武器快照,不存在返回 null任意
api.weapons.listAll()所有武器 key任意
api.weapons.listModded()本 Mod 注册过的 key任意
api.npcs.registerTemplate(tpl)注册敌方模板,注入后续生成的敌人before-start
api.npcs.applyTo(enemy)对手上敌人实例立即应用全部模板after-start
api.npcs.snapshot()存活敌人快照数组(只读)任意
api.maps.decorate(fn)注册地图装饰回调before-start
api.player.snapshot()玩家快照,未开局返回 nullafter-start
api.player.heal(amount)加血,不超过上限,返回实际恢复量after-start
api.player.hookDamage(fn)玩家受击前回调after-start
api.player.hookFireBullet(fn)开火前回调after-start
api.loot.hookRoll(fn)容器搜索产物回调after-start
api.events.on / off / emit事件订阅、退订、广播任意
api.refs.WEAPONS / ITEMS / ENEMY_TYPES / EXTRACTS只读字典引用任意
api.phase.ready / api.phase.onReady(cb)运行时钩子就绪状态任意

3.1 武器定义 def

{
  name: 'SCAR-H',        // 必填,展示名
  icon: '▬',             // 可选,单字符图标
  price: 12000,          // 可选,哈夫币价格,0 为免费
  damage: 1.45,          // 倍率,基数为干员伤害
  fireRate: 1.05,        // 倍率,越大越快
  range: 1.15,           // 倍率
  mag: 20,               // 弹匣容量,最小 1
  ammoType: 'heavy',     // light / medium / heavy / shell,非法值回落 medium
  desc: '7.62mm 战斗步枪'
}

非法数值会回落到默认值,不会污染 WEAPONS 其他条目。

3.2 NPC 模板 tpl

{
  id: 'mymod_hard',   // 必填,建议带 mod 前缀
  hpMul: 1.5,         // 生命倍率
  dmgMul: 1.2,        // 伤害倍率
  speedMul: 1.1,      // 移动速度倍率
  viewMul: 1.2,       // 视野半径倍率
  fireRateMul: 0.9,   // 射击冷却倍率(越小越快)
  reactMul: 0.8,      // 反应时间倍率(越小反应越快)
  radiusMul: 1.0,     // 体型倍率
  weapon: 'sr25'      // 强制指定武器 key(仅对已有该字段的敌人有意义)
}

模板只影响注册之后生成的敌人。想让首领必带 SR-25,可写 { id:'boss_sr25', weapon:'sr25' }。

3.3 钩子签名

// 伤害钩子:返回数字 = 改写;返回 undefined = 透传
api.player.hookDamage((amount, attacker, target, info) => {
  if (amount >= 60) return amount * 0.7;
});

// 子弹钩子:返回对象 = 合并替换;返回 undefined = 透传
api.player.hookFireBullet((def, shooter, origin, dir) => {
  return { damage: def.damage * 1.3 };
});

// 搜索产物钩子:返回数组 = 替换;返回 undefined = 透传
api.loot.hookRoll((items, container) => {
  const med = api.refs.ITEMS.med238;
  if (med && !items.some(it => it.id === 'med238')) items.push({ ...med });
  return items;
});

3.4 地图装饰

decorate 回调收到装饰数组,直接 push 即可;返回数组则替换整个列表。

api.maps.decorate((list) => {
  list.push({ x: 4000, y: 2900, type: 'lamp', size: 12, alpha: 0.4 });
});

支持的 type:grass、rock、crack、debris、lamp(暖光点)、marker(金色方块); 其他 type 会画成一个浅灰小圆点。装饰只影响渲染,不参与碰撞。

3.5 事件

事件payload触发时机
round:start{ operator, difficulty }对局开始
round:end{ reason, success }撤离或阵亡结算
extract{ extractId, success }撤离成功
kill{ attacker, victim, isHead }玩家击杀记入击杀播报
death{ attacker, isHead, target }玩家阵亡
damage{ amount, attacker, target, info }玩家受击,amount 为钩子处理后的最终值
loot:taken{ item }从容器或战利品包拾取物品
weapon:registered{ key, def, replaced }任意 Mod 调用 weapons.register
npc:registered{ id }任意 Mod 调用 registerTemplate

api.events.emit(name, payload) 可广播自定义事件,供其他 Mod 订阅。


4. 最小可运行 Mod

4.1 启动前(loadPhase: before-start)

(function () {
  if (!window.VibeHubGame || !window.VibeHubGame.modApi) return;
  const api = window.VibeHubGame.modApi;

  api.weapons.register('mymod_scarh', {
    name: 'SCAR-H', icon: '▬', price: 12000,
    damage: 1.45, fireRate: 1.05, range: 1.15,
    mag: 20, ammoType: 'heavy', desc: '7.62mm 战斗步枪'
  });

  api.npcs.registerTemplate({ id: 'mymod_tougher', hpMul: 1.2, reactMul: 0.9 });

  api.maps.decorate((list) => {
    list.push({ x: 4000, y: 2900, type: 'lamp', size: 12, alpha: 0.4 });
  });
})();

4.2 启动后(loadPhase: after-start)

(async function () {
  if (!window.VibeHubGame || !window.VibeHubGame.modApi) return;
  const api = window.VibeHubGame.modApi;

  await new Promise((r) => (api.phase.ready ? r() : api.phase.onReady(r)));

  api.player.hookDamage((amount) => (amount >= 60 ? amount * 0.7 : undefined));

  api.events.on('kill', ({ victim }) => {
    if (victim) api.player.heal(8);
  });

  api.events.on('round:end', ({ reason, success }) => {
    console.log('[mod] 对局结束', success ? '撤离成功' : '阵亡', reason);
  });
})();

5. 命名、去重与冲突

  • 武器 key、模板 id 用小写英文 + 数字 + 下划线,并带 Mod 前缀,例如 mymod_scarh。
  • weapons.register 同 key 后注册覆盖先注册;registerTemplate 同 id 后注册覆盖先注册。
  • maps.decorate 多个回调按注册顺序全部执行。
  • 三个钩子按注册顺序串联,任一返回值即改写。
  • 不要独占某个 key;不要阻塞主线程(同步循环超过 100ms 会掉帧)。

6. 明确禁止

禁止原因
直接读写 localStorage / indexedDB与游戏存档 schema 冲突,存档走 vibe.save
操作 DOMHUD 结构可能在任意小版本调整
覆盖 window.VibeHubGame / window.game会破坏后续 Mod
直接 mutate WEAPONS / ITEMS / ENEMY_TYPES 而不走 register注册表才是稳定接触面
直接修改 Game.enemies 数组请用 npcs.snapshot() + 自己的状态机
读写网络层 / WebSocket / fetch平台不为 Mod 网络行为背书
绕过 Loader破坏工坊体系

能力声明不是安全沙箱。平台不会阻止越权代码,越权带来的后果由 Mod 作者承担。


7. 版本兼容

工坊层 v1 与游戏 v3.x 绑定。大版本升级可能修改 WEAPONS / ENEMY_TYPES / ITEMS 字段; 建议在 Mod 描述里写明兼容版本范围。若平台检测到能力 ID 已被移除,会在 Mod 列表标红「已不兼容」。

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

发布你的 Mod

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

登录