level.add用 registerLevel 注册 100 以上的数字层级:只能设置边长、怪物池、档案文案、区域名与种子,地图由内置隧道模板生成;不能替换地图生成算法、不能修改内置层级。
作者声明:联机时不应使用
《BackRooms|后室 - 无人抵达 v1.3.6》创意工坊
收藏用于稍后查找;“开启”决定下次启动时加载哪些 Mod。所有已开启 Mod 会一起进入游戏。
推荐方式 · 不需要懂编程
Prompt 只注入作品、能力、依赖和你的 Mod ID,并要求 Agent 实时读取唯一官方 Skill;固定命令与规则不再复制到任务文本中。
发布 Mod 时必须声明使用哪些能力。以下内容是作者约定,平台不会扫描或限制 Mod 代码;只安装你信任的内容。
联机策略:游戏进入联机前应禁用全部 Mod
level.add用 registerLevel 注册 100 以上的数字层级:只能设置边长、怪物池、档案文案、区域名与种子,地图由内置隧道模板生成;不能替换地图生成算法、不能修改内置层级。
作者声明:联机时不应使用
level.child用 registerChildLevel 在自己注册的层级下挂一层(如 90001.1):父层自动出现入口门、子层有返回门;最多 4 个子层级,不能挂到内置层级或别人的层级下面。
作者声明:联机时不应使用
level.area用 registerArea 给已有层级或自己注册的层级追加区域名,只影响楼层信息的显示文本;不能改变房间布局或区域判定逻辑。
作者声明:联机时不应使用
item.add用 registerItem 注册可拾取、可发放的道具(名称、说明、堆叠上限、可选本地贴图);不能定义新存档结构、不能替换背包逻辑。
作者声明:联机时不应使用
item.use注册道具时提供 onUse 回调,玩家使用时触发;回调里只能调用公开 API(提示、音效、发放道具、切层),不能直接改动背包以外的游戏内部状态。
作者声明:联机时不应使用
entity.add用 registerEntityKind 注册怪物:可调半径、速度、视野、丢失时间、刷新时长与是否无害,外观只能沿用内置模型或本地贴图;不能接管 AI 状态机、不能自定义绘制代码。
作者声明:联机时不应使用
entity.spawn用 spawnEntity 在当前层级刷出已注册的实体,位置由游戏挑选;不能指定任意坐标批量刷怪,不能操控已有实体的追击与伤害逻辑。
作者声明:联机时不应使用
stat.tune用 tune 修改白名单内的数值(移动速度、体力、血量上限、理智流失、杏仁水回复、背包容量),超出范围会被夹到边界;不能修改未列出的配置项。
作者声明:联机时不应使用
asset.texture用 registerTexture 或注册参数里的 textures / texture 指定随包分发的图片,用于墙、地板、道具、实体与拾取物;图片解析失败自动回退程序化画法,不能注入自定义绘制代码。
作者声明:联机时不应使用
audio.music用 registerMusic / playMusic / stopMusic 给自己注册的层级配背景音乐,可设进层延迟与触发条件;与内置 BGM 互斥,音量仍受玩家设置控制,不能加载包外音频。
作者声明:联机时不应使用
ui.toast用 toast 在屏幕下方显示一行提示;不能创建自定义面板、按钮或修改现有界面结构。
作者声明:联机时不应使用
audio.sfx用 playSfx 播放白名单里的内置一次性音效;不能替换背景音乐、不能加载包外音频、不能调整全局音量设置。
作者声明:联机时不应使用
state.read用 getState / isMultiplayer 读取阶段、层级、楼层、生命、理智、玩家坐标与实体数量;只读,不能写入或回滚游戏状态。
作者声明:联机时不应使用
event.subscribe用 on 订阅 game-start、level-enter、player-death、mods-ready 事件并按顺序回调;回调抛错只影响自己,不能拦截或取消游戏流程。
作者声明:联机时不应使用
Agent 会同时收到下面这份本游戏专属规范。
本作通过 VibeHub 创意工坊加载器(https://gamesvibe.app/workshop/loader/v1.js)接收玩家启用的 Mod。
游戏只暴露一个全局对象 window.BackroomsMod(也可写作 BackroomsMod),ApiVersion 为 1。
能力声明不是安全沙箱:平台不会扫描或限制 Mod 代码。这里列出的"能力"是作者与 Mod 作者之间的 开发约定;超出约定的写法(改内部函数、抓 DOM、读本地凭据等)一律视为不兼容 Mod。
| 类型 | 说明 | 加载阶段 |
|---|---|---|
| 新层级 | 注册一个 100 以上的数字层级,使用内置"管道梦魇"模板生成,可自定义边长、实体、区域名、档案描述 | 启动前 |
| 子层级 | 在自己注册的层级下面再挂一层(90001.1),父层里自动出现一扇通往下层的门 | 启动前 |
| 层级区域 | 给已有层级或自己的层级追加"区域名",显示在楼层信息里 | 启动前(启动后也可立即生效) |
| 新道具 | 注册可拾取的道具,可选"使用回调" | 启动前注册;启动后可 giveItem 直接发放 |
| 新实体 | 注册一种怪物,沿用内置外观模型(猎犬 / 笑魇 / 无面灵 …),可调速度、视野、凶恶程度 | 启动前 |
| 本地贴图 | 给自己层级的墙 / 地板、道具、实体、拾取物指定随包分发的图片 | 启动前 |
| 自定义音轨 | 给自己层级配一条背景音乐,可设"进层后延迟 N 秒再响"或按条件触发 | 启动前 |
| 数值模组 | 调整玩家速度、体力、血量上限、理智流失、杏仁水回复、背包容量等白名单数值 | 启动前 |
| 事件脚本 | 订阅 game-start / level-enter / player-death,触发提示、生成实体、发放道具 | 启动前或启动后 |
| 纯表现类 | 提示条文案、播放内置音效 | 启动后 |
不能做的:替换地图生成算法、改写渲染管线、注入自定义 Canvas 绘制代码、修改存档结构、接管联机同步。 (贴图不是"注入绘制":你只交图片路径,铺在哪、怎么铺由游戏决定。)
window.BackroomsMod:Mod API。window.VibeHubWorkshop:平台加载器(由 loader 提供),只读使用。
beforeStart / afterStart:PromisemarkGameReady():由游戏调用,Mod 不要自己调getEnabledMods():当前启用的 Mod 描述符数组getCapability(id) / getMod(id) / resolve(modId, path) / createWorker(modId, path){ ok: boolean, error?: string, ... })BackroomsMod.registerLevel({
id: 90001, // 必填,2~6 位纯数字,且 >= 100,不得与内置层级冲突
name: "Level 90001 —— 回声走廊",
label: "LEVEL 90001",
size: 72, // 48~120,默认 72
entities: true, // 是否允许刷怪
monster: "bacterium", // 单一怪物种类(内置或 Mod 注册的 kind)
monsters: ["hound"], // 或者给一个怪物池(最多 8 个)
classes: ["等级 2", "不安全", "稳定", "少量实体"], // 最多 4 条,显示在档案
objective: "找到尽头的门", // 最多 300 字
seed: 123456, // 可选,地图种子(默认由 id 派生)
areas: ["走廊 A", "走廊 B"], // 可选,区域名
});
BackroomsMod.registerArea("0", "昏黄的回声区"); // 任意已存在/已注册层级,最多 40 个
BackroomsMod.registerItem({
key: "echo_shard", // 小写字母开头,2~40 位,不得与内置道具重名
name: "回声碎片",
short: "碎片",
desc: "一片摸起来还在震动的玻璃。",
effect: "使用后播放一声低语", // 只显示在背包说明里
stack: 9,
consume: true, // 可选:onUse 返回 true 时扣掉 1 个(默认 false = 可反复使用)
onUse(ctx) { // 可选:在背包里双击时触发;ctx = { key, api, state }
BackroomsMod.playSfx("whisper");
BackroomsMod.toast("碎片在你手里轻轻响了一下");
return true; // 返回 true 才算"用成功了",配合 consume 才扣数量
},
});
BackroomsMod.registerEntityKind({
kind: "echo_walker", // 小写字母开头,不得与内置实体重名
name: "回声行者",
color: "#556677",
radius: 13, // 6~30
speedMul: 1.1, // 0.3~2.2
wanderMul: 1.0, // 0.2~2
sightMul: 1.0, // 0.5~2
lostTime: 5, // 1~30 秒
spawnDuration: 1.0, // 0.2~4 秒
docile: false, // true = 不主动攻击(第 11 效应那种)
model: "hound", // 可选:沿用内置外观,见 §2.6
});
BackroomsMod.tune({
PLAYER_SPEED: 230, // 白名单数值,见 §2.4
SANITY_DRAIN_DARK: 0.4,
});
BackroomsMod.on("level-enter", (e) => { /* e = { level, floor } */ });
BackroomsMod.on("game-start", (e) => { /* e = { level, ai } */ });
BackroomsMod.on("player-death", (e) => { /* e = { level, floor, cause, killer } */ });
| 函数 | 说明 |
|---|---|
BackroomsMod.toast(msg) | 屏幕下方的提示条 |
BackroomsMod.giveItem(key, n) | 发放道具(n 为 1~99),会立刻刷新背包 |
BackroomsMod.spawnEntity(kind) | 在当前层级刷一只实体(自动挑离玩家较远的地板) |
BackroomsMod.goToLevel(level) | 走完整的切层流程(含过场动画) |
BackroomsMod.playSfx(name) | 播放内置音效,白名单见 §2.5 |
BackroomsMod.getState() | { phase, level, floor, hp, sanity, entities, multiplayer, player } |
BackroomsMod.isMultiplayer() | 当前是否联机对局 |
BackroomsMod.getEnabledMods() | 透传加载器 |
BackroomsMod.getCapability(id) | 透传加载器 |
BackroomsMod.playMusic(key, opt) | 立刻播放自己注册的音轨(opt.restart === false 则接着上次) |
BackroomsMod.stopMusic(key) | 停掉自己注册的音轨 |
BackroomsMod.registerTexture(def) | 登记本地贴图,见 §2.7 |
BackroomsMod.registerMusic(def) | 登记自定义音轨,见 §2.8 |
BackroomsMod.registerChildLevel(def) | 在自己层级下挂子层级,见 §2.9 |
tune 只认这些;超出范围会被夹到边界)PLAYER_SPEED(80480)、720)、PLAYER_SPRINT(120STAMINA_MAX(40400)、
120)、STAMINA_DRAIN(8STAMINA_REGEN(4120)、400)、HP_MAX(20SANITY_MAX(20400)、
4)、SANITY_DRAIN_DARK(0SANITY_DRAIN_LIT(02)、8)、
SANITY_DRAIN_ENTITY(0ALMOND_SANITY(090)、60)、ALMOND_HP(0BAG_DEFAULT(10~120)。
playSfx)footstep、splash、paper、door、growl、jumpscare、heartbeat、roar、collapse、
debris、exitChime、jazz、whisper、wind、water、steam、elevator、
flickerClick、adrenaline。
registerEntityKind.model)bacterium、hound、smiler、faceling、moth、rat、partypooper、jerry、worn、
kite、transporter、bride、crusher、neighborhood、kitty、mimic。
不填则使用默认的鞭毛体外观。
registerTexture / textures / texture)图片随 Mod 包分发,写包内相对路径;平台加载器(VibeHubWorkshop.resolve(modId, path))会把它
解析成真正的 URL。小图也可以直接写 data:image/png;base64,...。
// 墙 / 地板:整格铺满,注册在层级 id 上
BackroomsMod.registerLevel({
id: 90001,
name: "回声走廊",
textures: {
wall: "tex/wall.png",
floor: { src: "tex/floor.png", smooth: false }, // 像素风:关掉缩放平滑
},
});
// 其它四类:物件 / 实体 / 拾取物
BackroomsMod.registerTexture({
scope: "prop", // wall / floor / entity / prop / item
key: "echo_crate", // wall|floor 写层级 id(或 style);prop 写 p.type;entity 写 kind;item 写道具 key
src: "tex/crate.png",
h: 0.9, // 高度占一格的比例(默认 prop 0.9 / entity 1.15 / item 0.42)
w: 0, // 宽度比例,0 = 按图片长宽比自动算
anchor: "foot", // foot = 底部对齐脚下(站在地上),center = 居中
alpha: 1,
smooth: false,
sx: 0, sy: 0, sw: 0.5, sh: 0.5, // 图集裁切,归一化 0~1
});
也可以直接写在注册函数里,少写一次 registerTexture:
BackroomsMod.registerItem({ key: "echo_shard", name: "回声碎片", texture: "tex/shard.png" });
BackroomsMod.registerEntityKind({ kind: "echo_walker", name: "回声行者", texture: "tex/walker.png" });
model 字段可以留着,贴图加载失败时仍然有东西可画。registerMusic / music)BackroomsMod.registerMusic({
key: "echo_theme",
src: "audio/echo.ogg",
loop: true, // 默认 true
volume: 0.9, // 乘在设置里的音乐音量上
fadeIn: 1.5, // 淡入秒数,0 = 立刻满音量
trigger: {
level: 90001, // 也可以 levels: ["90001", "90001.1"]
after: 2, // 进层后 2 秒才响 —— Level ! 的警报就是这么卡的
once: true, // 每次进层只自动响一次(默认)
stopOnLeave: true, // 离开层级自动停(默认)
require(ctx) { // 可选:条件不满足就一直等
return ctx.sanity < 40; // ctx = { level, floor, hp, sanity, game }
},
},
});
简写(写在自己层级的注册参数里):
BackroomsMod.registerLevel({ id: 90001, name: "回声走廊", music: { src: "audio/echo.ogg", after: 3 } });
手动控制时机:
BackroomsMod.playMusic("echo_theme"); // 立刻从头响
BackroomsMod.playMusic("echo_theme", { restart: false }); // 接着上次的位置
BackroomsMod.stopMusic("echo_theme");
规则:
level / levels 的曲目是纯手动的,游戏不会自动播。registerChildLevel)BackroomsMod.registerChildLevel({
parent: 90001, // 必须是自己 registerLevel 注册的层级
index: 1, // 可选,默认自动挑最小空位 -> 90001.1
name: "Level 90001.1 —— 回声下层",
size: 56, // 48~120,默认跟父层一样
classes: ["等级 3", "不安全"],
objective: "找到回到走廊的那扇门",
inheritStyle: true, // 默认沿用父层的墙 / 地板外观
entry: true, // 默认在父层放一扇入口门
music: { src: "audio/echo_sub.ogg", after: 1 },
});
"90001.1",可以直接 goToLevel("90001.1"),存档里也原样保存。seed 可指定;墙 / 地板沿用父层贴图(inheritStyle: false 可独立)。registerTexture({ scope: "prop", key: "modsubdoor", src: "tex/door.png" })。目录结构:
echo-mod/
├─ vibehub.mod.json
└─ main.js
vibehub.mod.json:
{
"title": "回声碎片",
"summary": "给 Level 0 加一件会响的碎片,并给走廊起个名字。",
"description": "演示 BackRooms Mod API v1:注册道具、注册区域、订阅事件。",
"version": "1.0.0",
"releaseNotes": "首个版本",
"entry": "main.js",
"entryType": "classic",
"styles": [],
"loadPhase": "before-start",
"dependencyIds": [],
"capabilities": ["item.add", "item.use", "level.area", "event.subscribe", "audio.sfx", "ui.toast"]
}
main.js:
(function () {
const Mod = window.BackroomsMod;
if (!Mod) return;
const r = Mod.registerItem({
key: "echo_shard",
name: "回声碎片",
short: "碎片",
desc: "一片摸起来还在震动的玻璃。",
effect: "使用后播放一声低语",
stack: 9,
onUse() {
Mod.playSfx("whisper");
Mod.toast("碎片在你手里轻轻响了一下");
return true;
},
});
if (!r.ok) return; // 重名时安静退出,不覆盖别人的东西
Mod.registerArea("0", "昏黄的回声区");
Mod.on("game-start", () => {
Mod.giveItem("echo_shard", 1);
Mod.toast("你把一片回声碎片塞进了口袋");
});
})();
启动前(loadPhase: "before-start",默认值)
registerLevel、registerArea、registerItem、registerEntityKind、tune、on。giveItem / spawnEntity / goToLevel / getState() 依赖游戏实例的函数——
此时还没有对局,调用会返回 false,事件回调里再调即可。启动后(loadPhase: "after-start")
backroomsMods.echoPack = { items: [...] }),不要把对象挂到 window.BackroomsMod 上。vibehub.mod.json 的 dependencyIds 里,只能依赖"启动前"的 Mod。markGameReady()、不得改动 window.VibeHubWorkshop。key、实体 kind 只允许小写字母/数字/点/横线/下划线,建议带作者前缀,
例如 echo_shard、echo_walker。层级 id 建议使用 90000+ 区间,避免撞上内置编号。key / kind / 层级 id 会返回 { ok:false },不覆盖已有内容;
第二个注册的 Mod 应自行改名或安静退出。toast 会互相覆盖(后一条覆盖前一条),属于预期表现。br_local_slots_v1 等存档结构不含 Mod 数据。Mod 道具会随背包 inv 一起存进存档
(key 是字符串),卸载 Mod 后再读档会得到一件"没有定义"的道具(占格但不可用)。
请自行决定是否在 before-start 里清理自己的旧道具。mods-disabled。只要启用了任何 Mod,进入联机房间点"开始"会被拒绝并提示
关闭全部模组;单人模式不受限制。Mod 也不得尝试绕过该检查或修改联机同步。
因此能力目录(WORKSHOP_CAPABILITIES.json)里每一项的 multiplayer 都标记为 blocked:
联机时不装载任何 Mod,任何能力都不可用。async=false),启动前 Mod 全部执行完 →
应用注册 → 启动引擎 → markGameReady() → 启动后 Mod。注册冲突按"先到先得"处理。BackroomsMod.apiVersion = 1、BackroomsMod.version = "1.1.0"、游戏 v1.3.4。
registerTexture / registerMusic / registerChildLevel / playMusic / stopMusic,
以及 registerLevel.textures / registerLevel.music / registerItem.texture / registerEntityKind.texture。
这些字段都可以不写 —— 不写就是 1.0.0 的行为。window.__game、CONFIG、ITEMS 等)
都可能在任意版本变化,不属于兼容范围。apiVersion,会在更新说明里写明变更;Mod 可以读 BackroomsMod.apiVersion
自行判断是否继续执行。window.__game、window.__setLevel、window.__toast、window.__LK 等调试口子。Entity、generateMap、update、render、addItem …)。localStorage 中的身份/云存档键、管理接口与服务器 RPC。registerTexture / registerMusic 登记,不要自己 new Image() /
new Audio() 去抢渲染与音轨。mods-disabled 检查,或修改联机同步协议。worker / eval / Function 生成代码去规避上面的限制。登录后可以上传完整 Mod 包或单脚本。
登录反馈渠道
有任何问题、建议或反馈,请加 VibeHub 官方支持群:
QQ 752883513
进群后请直接在群里提反馈,我们会及时关注并处理。