bridge.¶

bridge.是面向基岩版附加包的项目编辑器。它把项目创建、文件预设、JSON补全、字段校验、资源预览、同步和导出集中到一个界面里，适合用来维护中小型附加包项目。

安装或直接使用¶

bridge.当前同时提供桌面安装包和网页应用。下载配置列出了Windows、macOS、Linux和Web App四种入口；如果准备长期维护项目，桌面端通常更稳妥；如果只是临时试用、查看界面或在受限设备上快速改动文件，网页应用更方便。

常见选择方式如下：

Windows上优先使用安装程序。
macOS上使用.dmg安装包。
Linux上根据发行版选择.AppImage或.deb。
不想安装时，直接打开https://editor.bridge-core.app/。

网页应用仍然可以安装成接近本地应用的形式。文档列出的可用浏览器包括Chrome、Edge、Firefox和Safari；在Chromium桌面浏览器中安装体验通常最好。当前版本也持续改进了移动端可用性，并支持在移动环境中管理多个项目；不过正式维护附加包时，桌面端仍然更适合作为主工作环境。

不安装也能试用

只是查看界面或临时编辑文件时，可以直接用网页版。正式开发项目时，建议尽早确定桌面端或固定浏览器环境，并配置项目文件夹，减少权限提示、路径混乱和多项目切换成本。

首次设置¶

首次进入后，bridge.通常会让你完成这些设置：

选择编辑器类型。文本编辑器接近Visual Studio Code体验；树编辑器更适合不熟悉JSON语法的初学者。
选择bridge.文件夹。这个文件夹保存项目和设置，建议放在Documents或其他容易备份的位置。
在桌面环境中，把com.mojang文件夹作为输出文件夹关联到bridge.。原生应用可自动检测或手动链接，网页版可拖入该文件夹并选择Output Folder。这样项目改动可以同步到development_behavior_packs和development_resource_packs，不必每次手动导入游戏。

创建项目¶

优先创建普通bridge.文件夹项目。Local Project只保存在bridge.内部，不能直接使用Git等版本管理，适合临时练习而不适合正式项目。创建项目时通常需要填写：

包类型：常见附加包通常至少包含行为包和资源包；皮肤包和世界模板按项目需要选择。
实验性玩法：bridge.会根据项目配置筛选可用文件和补全项。
名称、描述、图标和作者。
命名空间：使用短小、唯一、蛇形命名的名称，例如my_pack。
目标版本：设置为你要开发和测试的Minecraft版本，避免误用目标版本不支持的字段。

创建后，典型结构如下：

PROJECT_NAME
- {{file|config.json}}
- BP
- RP
- SP
- WT
- builds
- .bridge

创建和编辑文件¶

bridge.的预设窗口可以创建方块、实体、物品、简单文件和皮肤等资源。你可以点击新建文件按钮，按Ctrl＋N，或在资源管理器中右键文件夹创建。

编辑JSON时，bridge.会根据项目目标版本、格式版本和实验性开关提供补全与校验。文档还提到它会扫描包中的标识符、标签和事件等数据，并把这些内容用于补全。

现在，很多这类数据资料可以在后台自动更新。因此，遇到“字段补全还没跟上最新数据”的情况时，不一定需要立刻重装或升级bridge.本体，先检查数据更新是否已经完成通常更合适。

如果你在开发脚本或函数，也可以直接编辑.ts、.js和.mcfunction文件。命令补全、选择器参数提示和脚本类型提示能减少低级错误。

同步到游戏¶

bridge.默认把源项目保存在com.mojang文件夹外。这样做更适合备份和版本管理，但项目不会自动出现在Minecraft里。要让修改进入游戏，需要把com.mojang设置为Dash编译器的输出位置。

在原生应用中，编译器窗口可以直接关联输出文件夹；Windows上的原生应用通常还能自动检测com.mojang。在网页应用中，可以把com.mojang文件夹从资源管理器拖入bridge.，并在弹窗中选择Output Folder。之后，bridge.会把开发构建写入development_behavior_packs、development_resource_packs、development_skin_packs和世界相关文件夹。需要同时维护稳定版与预览版项目时，可以按项目分别指定输出位置；没有单独设置时，再回退到全局输出目录。

不要反向编辑输出目录

如果项目已经启用同步，com.mojang中的开发包应视为编译输出。直接修改这些输出文件，可能会在下一次编译时被覆盖。

当前版本已经支持自动检测外部文件改动，因此用Blockbench等外部工具保存文件后，bridge.通常会自行重新读取并编译输出。如果游戏中没有看到预期结果，再在包资源管理器中手动刷新项目，或在编译器窗口里重启监视模式，强制重新编译开发输出。

导入已有项目¶

把文件拖入bridge.通常就能触发导入或打开流程。常见格式包括：

格式	用途
`.mcaddon`和`.mcpack`	从游戏包导入，可能需要手动修正项目配置
`.brproject`	bridge.完整项目格式，包含项目配置
`com.mojang`项目	直接编辑开发包目录中的资源，适合快速修补
文件夹或单个文件	临时打开和编辑，仍可获得文件类型猜测和补全

导出项目¶

发布前，从包资源管理器的更多菜单中选择Export As。默认导出格式包括：

.brproject：完整bridge.项目，适合继续协作。
.mcaddon：行为包和资源包组合包。
.mcworld：行为包、资源包和世界组合包。
.mctemplate：行为包、资源包、皮肤包和世界模板组合包。

如果你只是本地测试，并且已经配置了com.mojang同步，就不需要每次导出。直接保存文件、回到游戏重新进入世界，通常更快。

进阶功能¶

bridge.还提供Dash编译器、项目配置、扩展、预设、代码片段、自定义命令、自定义组件、.molang文件和生成器脚本等进阶能力。这些功能能提高附加包开发效率，但它们大多属于bridge.自己的项目层语法或工具扩展，不是Minecraft原生支持的文件格式。

如果你准备在团队项目中使用这些能力，先阅读bridge.进阶功能，并确保所有协作者都使用同一套项目配置和编译流程。

项目类型¶

bridge.支持多种项目类型，适应不同的工作流：

bridge.文件夹项目（推荐）：项目存储在bridge.文件夹外，便于版本管理和备份；支持与com.mojang文件夹同步开发包
本地项目（Local Project）：仅在bridge.内部存储，不支持Git等版本管理，适合临时练习
com.mojang项目：直接编辑开发包目录，快速修改但不适合长期项目
打开文件或文件夹：临时编辑任意文件或文件夹，仍可获得完整的补全和验证体验

编辑文件时的便利功能¶

转到定义（Go to Definition）¶

bridge.支持快速跳转到相关文件。例如，在组件中按"转到定义"可以直接打开对应的几何体或渲染控制器文件，大大加快开发流程。

全局查找和替换¶

bridge.包含全局查找和替换系统，支持： - 字符串精确搜索或正则表达式 - 正则捕获组替换 - 快速修改项目内的标识符、标签等

文件预览¶

bridge.支持不启动游戏即可预览： - 实体和方块的三维模型（自动匹配纹理和动画） - 碰撞箱和座位位置 - 粒子特效 - 实体的资源预览窗口用于展示截图

自动补全和验证¶

bridge.的补全系统会： - 根据项目配置的format_version和实验性开关过滤选项，避免误用不支持的功能 - 自动扫描项目中的标识符、标签、事件等数据，在补全中提建议 - 对文件进行JSON架构验证，指出错误和问题

当打开来自其他地方的文件时，bridge.会智能推断文件类型，仍然提供相应的补全和验证。

什么时候不要用bridge.¶

bridge.并不能替代所有工具。三维模型和动画仍然建议交给Blockbench；复杂脚本项目仍然可能需要完整的Node.js工具链；性能分析和真实运行结果必须回到游戏里测试。