weapons.register通过 modApi.weapons.register(key, def) 注册或覆盖武器定义,影响本地武器表,不修改已有武器实例的运行时状态。
作者声明:联机时不应使用
《三角洲 2D 搜打撤》创意工坊
收藏用于稍后查找;“开启”决定下次启动时加载哪些 Mod。所有已开启 Mod 会一起进入游戏。
推荐方式 · 不需要懂编程
Prompt 只注入作品、能力、依赖和你的 Mod ID,并要求 Agent 实时读取唯一官方 Skill;固定命令与规则不再复制到任务文本中。
发布 Mod 时必须声明使用哪些能力。以下内容是作者约定,平台不会扫描或限制 Mod 代码;只安装你信任的内容。
联机策略:游戏进入联机前应禁用全部 Mod
weapons.register通过 modApi.weapons.register(key, def) 注册或覆盖武器定义,影响本地武器表,不修改已有武器实例的运行时状态。
作者声明:联机时不应使用
weapons.read通过 modApi.weapons.get / listAll 读取武器定义快照,只读,不修改。
作者声明:联机时不应使用
npcs.register-template通过 modApi.npcs.registerTemplate 注册敌方模板,注入到本地敌人生成流程,不修改已有敌人实例。
作者声明:联机时不应使用
npcs.apply-to通过 modApi.npcs.applyTo 对一个敌人实例应用已注册模板,影响本地敌人参数。
作者声明:联机时不应使用
npcs.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 搜打撤》(Delta 2D) 的工坊作者—创作者约定。平台不会扫描或限制 Mod 代码,
只会读取 WORKSHOP_CAPABILITIES.json 决定 UI 上展示哪些能力。
本游戏是单机模式,没有联机匹配,且联机策略为 mods-disabled:所有 Mod 只影响本地表现。
window.VibeHubGame(workshop: "v1")const api = window.VibeHubGame.modApi;| 类别 | 示例 | 用到的主要 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 后注册覆盖先注册;
模板之间按「相乘」叠加;钩子按注册顺序串联,任一返回值即改写。
| 阶段 | 适合做的事 | 不适合做的事 |
|---|---|---|
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 回调触发
weapons.*、npcs.registerTemplate、maps.decorate、events.on(仅注册)。player.heal / hookDamage / hookFireBullet(此时还没有对局)。await 就绪:await new Promise(r => api.phase.ready ? r() : api.phase.onReady(r));| 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() | 玩家快照,未开局返回 null | after-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) | 运行时钩子就绪状态 | 任意 |
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 其他条目。
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' }。
// 伤害钩子:返回数字 = 改写;返回 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;
});
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 会画成一个浅灰小圆点。装饰只影响渲染,不参与碰撞。
| 事件 | 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 订阅。
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 });
});
})();
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);
});
})();
mymod_scarh。weapons.register 同 key 后注册覆盖先注册;registerTemplate 同 id 后注册覆盖先注册。maps.decorate 多个回调按注册顺序全部执行。| 禁止 | 原因 |
|---|---|
直接读写 localStorage / indexedDB | 与游戏存档 schema 冲突,存档走 vibe.save |
| 操作 DOM | HUD 结构可能在任意小版本调整 |
覆盖 window.VibeHubGame / window.game | 会破坏后续 Mod |
直接 mutate WEAPONS / ITEMS / ENEMY_TYPES 而不走 register | 注册表才是稳定接触面 |
直接修改 Game.enemies 数组 | 请用 npcs.snapshot() + 自己的状态机 |
| 读写网络层 / WebSocket / fetch | 平台不为 Mod 网络行为背书 |
| 绕过 Loader | 破坏工坊体系 |
能力声明不是安全沙箱。平台不会阻止越权代码,越权带来的后果由 Mod 作者承担。
工坊层 v1 与游戏 v3.x 绑定。大版本升级可能修改 WEAPONS / ENEMY_TYPES / ITEMS 字段;
建议在 Mod 描述里写明兼容版本范围。若平台检测到能力 ID 已被移除,会在 Mod 列表标红「已不兼容」。
登录后可以上传完整 Mod 包或单脚本。
登录反馈渠道
有任何问题、建议或反馈,请加 VibeHub 官方支持群:
QQ 752883513
进群后请直接在群里提反馈,我们会及时关注并处理。