平台通知

全屏浏览 VibeHub

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

返回《BackRooms|后室 - 无人抵达 v1.3.6》

《BackRooms|后室 - 无人抵达 v1.3.6》创意工坊

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

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

启动游戏

推荐方式 · 不需要懂编程

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

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

作者允许的 Mod 能力

发布 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 会同时收到下面这份本游戏专属规范。

后室创意工坊开发指南(BackRooms Mod API v1)

本作通过 VibeHub 创意工坊加载器(https://gamesvibe.app/workshop/loader/v1.js)接收玩家启用的 Mod。 游戏只暴露一个全局对象 window.BackroomsMod(也可写作 BackroomsMod),ApiVersion 为 1。

能力声明不是安全沙箱:平台不会扫描或限制 Mod 代码。这里列出的"能力"是作者与 Mod 作者之间的 开发约定;超出约定的写法(改内部函数、抓 DOM、读本地凭据等)一律视为不兼容 Mod。


1. 玩家可以制作哪些 Mod

类型说明加载阶段
新层级注册一个 100 以上的数字层级,使用内置"管道梦魇"模板生成,可自定义边长、实体、区域名、档案描述启动前
子层级在自己注册的层级下面再挂一层(90001.1),父层里自动出现一扇通往下层的门启动前
层级区域给已有层级或自己的层级追加"区域名",显示在楼层信息里启动前(启动后也可立即生效)
新道具注册可拾取的道具,可选"使用回调"启动前注册;启动后可 giveItem 直接发放
新实体注册一种怪物,沿用内置外观模型(猎犬 / 笑魇 / 无面灵 …),可调速度、视野、凶恶程度启动前
本地贴图给自己层级的墙 / 地板、道具、实体、拾取物指定随包分发的图片启动前
自定义音轨给自己层级配一条背景音乐,可设"进层后延迟 N 秒再响"或按条件触发启动前
数值模组调整玩家速度、体力、血量上限、理智流失、杏仁水回复、背包容量等白名单数值启动前
事件脚本订阅 game-start / level-enter / player-death,触发提示、生成实体、发放道具启动前或启动后
纯表现类提示条文案、播放内置音效启动后

不能做的:替换地图生成算法、改写渲染管线、注入自定义 Canvas 绘制代码、修改存档结构、接管联机同步。 (贴图不是"注入绘制":你只交图片路径,铺在哪、怎么铺由游戏决定。)


2. 公共对象、注册函数、事件及参数

2.1 全局对象

  • window.BackroomsMod:Mod API。
  • window.VibeHubWorkshop:平台加载器(由 loader 提供),只读使用。
    • beforeStart / afterStart:Promise
    • markGameReady():由游戏调用,Mod 不要自己调
    • getEnabledMods():当前启用的 Mod 描述符数组
    • getCapability(id) / getMod(id) / resolve(modId, path) / createWorker(modId, path)

2.2 注册函数(全部返回 { 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 } */ });

2.3 运行时函数(游戏启动后调用)

函数说明
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

2.4 数值白名单(tune 只认这些;超出范围会被夹到边界)

PLAYER_SPEED(80480)、PLAYER_SPRINT(120720)、STAMINA_MAX(40400)、 STAMINA_DRAIN(8120)、STAMINA_REGEN(4120)、HP_MAX(20400)、SANITY_MAX(20400)、 SANITY_DRAIN_DARK(04)、SANITY_DRAIN_LIT(02)、SANITY_DRAIN_ENTITY(08)、 ALMOND_SANITY(090)、ALMOND_HP(060)、BAG_DEFAULT(10~120)。

2.5 音效白名单(playSfx)

footstep、splash、paper、door、growl、jumpscare、heartbeat、roar、collapse、 debris、exitChime、jazz、whisper、wind、water、steam、elevator、 flickerClick、adrenaline。

2.6 可复用外观模型(registerEntityKind.model)

bacterium、hound、smiler、faceling、moth、rat、partypooper、jerry、worn、 kite、transporter、bride、crusher、neighborhood、kitty、mimic。 不填则使用默认的鞭毛体外观。

2.7 本地文件贴图(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 字段可以留着,贴图加载失败时仍然有东西可画。
  • 图片没加载完 / 加载失败:自动退回原来的程序化画法,不会白块、不会报错。
  • 同 scope 同 key 后注册者覆盖先注册者;贴图上限 240 张。

2.8 自定义层级音轨(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");

规则:

  • 自定义音轨与内置背景音乐互斥:播自定义时内置 BGM 让位,停了会自动还回去。
  • Level ! 的警报优先级最高:警报响着时自定义音轨一律不抢。
  • 音量跟随设置里的"音乐音量";玩家关掉音乐就是静音。
  • 切层 / 死亡 / 结局 / 回主菜单都会自动停,不会带着上一层的音乐进新层。
  • 没写 level / levels 的曲目是纯手动的,游戏不会自动播。
  • 音轨上限 16 条;候选格式看浏览器支持(mp3 / ogg / m4a / wav)。

2.9 子层级(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 },
});
  • 完整 id 是字符串 "90001.1",可以直接 goToLevel("90001.1"),存档里也原样保存。
  • 父层:自动挑一格离出生点 4~16 格的地板放一扇门,按 E 下去。
  • 子层:出生点附近同样有一扇回父层的门,按 E 回去(父层会重新生成,位置不保留)。
  • 最多 4 个子层级;层级总数仍受"单次 20 个"的限制。
  • 子层级地图沿用内置隧道模板,seed 可指定;墙 / 地板沿用父层贴图(inheritStyle: false 可独立)。
  • 想换门的贴图:registerTexture({ scope: "prop", key: "modsubdoor", src: "tex/door.png" })。

3. 一个最小可运行 Mod

目录结构:

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("你把一片回声碎片塞进了口袋");
  });
})();

4. 启动前 / 启动后加载

启动前(loadPhase: "before-start",默认值)

  • 所有注册类内容:registerLevel、registerArea、registerItem、registerEntityKind、tune、on。
  • 游戏会等这些 Mod 全部执行完,才把注册表写进真实数据结构,然后启动主循环。
  • 启动前 Mod 里不能调用 giveItem / spawnEntity / goToLevel / getState() 依赖游戏实例的函数—— 此时还没有对局,调用会返回 false,事件回调里再调即可。

启动后(loadPhase: "after-start")

  • 适合纯表现与运行时逻辑:事件回调里发提示、刷怪、发道具、切层。
  • 启动后 Mod 仍然可以注册新道具/实体,但注册会"立即生效",不会重跑已生成的地图。
  • 启动后 Mod 不能注册层级(地图已生成,注册不会影响当前对局,只影响下一次切层)。

5. 可作公共前置依赖的基础 Mod API

  • 被依赖的 Mod 应只做"注册 + 提供事件",把可复用内容挂在自己的命名空间里(例如 backroomsMods.echoPack = { items: [...] }),不要把对象挂到 window.BackroomsMod 上。
  • 依赖声明写在 vibehub.mod.json 的 dependencyIds 里,只能依赖"启动前"的 Mod。
  • 禁止的跨阶段依赖:
    • 启动前 Mod 依赖启动后 Mod(加载器不会等待,依赖一定拿不到)。
    • 启动后 Mod 依赖启动前 Mod 的"运行时状态"(那个状态在游戏启动时已经发生过了)。
  • 基础 Mod 不得替别人调用 markGameReady()、不得改动 window.VibeHubWorkshop。

6. 多 Mod 同时启用的命名、去重与冲突规则

  • 命名:道具 key、实体 kind 只允许小写字母/数字/点/横线/下划线,建议带作者前缀, 例如 echo_shard、echo_walker。层级 id 建议使用 90000+ 区间,避免撞上内置编号。
  • 去重:注册函数遇到已存在的 key / kind / 层级 id 会返回 { ok:false },不覆盖已有内容; 第二个注册的 Mod 应自行改名或安静退出。
  • 区域:同名区域重复注册是幂等的(只保留一份)。
  • 数值:多个 Mod 调同一个键时"后注册者生效"(按加载顺序),不做合并;请在自己的说明里写清。
  • 事件:多个 Mod 可以订阅同一事件,按注册顺序依次调用;单个 Mod 抛错不会影响其它 Mod。
  • 提示条:同时 toast 会互相覆盖(后一条覆盖前一条),属于预期表现。
  • 不提供卸载 / 热重载:Mod 在本次页面生命周期内常驻。

7. 存档、联机、加载顺序与版本兼容

  • 存档: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。
    • 1.1.0 新增:registerTexture / registerMusic / registerChildLevel / playMusic / stopMusic, 以及 registerLevel.textures / registerLevel.music / registerItem.texture / registerEntityKind.texture。 这些字段都可以不写 —— 不写就是 1.0.0 的行为。
    • 只使用本文档列出的函数与字段;未列出的内部对象(window.__game、CONFIG、ITEMS 等) 都可能在任意版本变化,不属于兼容范围。
    • 新版本若提升 apiVersion,会在更新说明里写明变更;Mod 可以读 BackroomsMod.apiVersion 自行判断是否继续执行。

8. 明确禁止使用的能力

  1. 直接读写 window.__game、window.__setLevel、window.__toast、window.__LK 等调试口子。
  2. 覆盖 / 猴子补丁任何全局函数(Entity、generateMap、update、render、addItem …)。
  3. 操作游戏 DOM(HUD、背包、终端、菜单)或注入自定义样式去伪造 UI / 按钮。
  4. 访问或索取账号凭据、Token、localStorage 中的身份/云存档键、管理接口与服务器 RPC。
  5. 联网请求、外链脚本、把资源放在包外(图片、音频、字体、WASM、Worker 必须随包分发)。 包内的图片 / 音频请交给 registerTexture / registerMusic 登记,不要自己 new Image() / new Audio() 去抢渲染与音轨。
  6. 绕过联机的 mods-disabled 检查,或修改联机同步协议。
  7. 采集玩家数据、键盘记录、修改存档上传逻辑。
  8. 借助 worker / eval / Function 生成代码去规避上面的限制。
手动发布 Mod高级方式:手动填写资料并上传 ZIP 或入口脚本

发布你的 Mod

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

登录