GB Studio

版权所有 (c) 2019-2026 Chris Maltby，根据 MIT 许可证 发布。

Patreon：gbstudiodev
Twitter：@maltby
Reddit：/r/gbstudio
Discord：加入聊天

GB Studio 是一款简单易用的复古游戏制作工具，适用于 Game Boy，支持 Mac、Linux 和 Windows 系统。 如需了解更多信息，请访问 GB Studio 网站。

GB Studio 包含一个 Electron 游戏构建器应用程序和 GBVM——一个基于 C 语言的游戏引擎，使用 GBDK。

安装

从 GB Studio 下载 页面下载适用于您操作系统的版本。

或者从源代码运行：克隆此仓库，然后：

• 安装 NodeJS（所需版本在 .nvmrc 中给出）

> cd gb-studio
> corepack enable
> yarn
> npm run fetch-deps
> npm start

在检出新版本后，您可能还需要再次获取依赖项，以确保拥有 GBVM + GBDK 等的最新版本。

> cd gb-studio
> npm run fetch-deps

GB Studio 当前使用 Node 24 LTS。如果您已安装 NVM，可以使用随附的 .nvmrc 切换到受支持的 Node 版本。

> cd gb-studio
> nvm use

GB Studio 命令行界面

按照上述方法从源代码安装 GB Studio，然后

> npm run make:cli
> yarn link
# From any folder you can now run gb-studio-cli
> $(yarn bin gb-studio-cli) -V
> $(yarn bin gb-studio-cli) --help

更新 CLI

拉取最新代码并再次运行 make:cli，yarn link 仅在首次运行时需要。

> npm run make:cli

命令行界面示例

• 导出项目

  > $(yarn bin gb-studio-cli) export path/to/project.gbsproj out/
  

  将 GBDK 项目从 gbsproj 导出到 out 目录

• 导出数据

  > $(yarn bin gb-studio-cli) export -d path/to/project.gbsproj out/
  

  仅将 gbsproj 中的 src/data 和 include/data 导出到 out 目录

• 生成 ROM

  > $(yarn bin gb-studio-cli) make:rom path/to/project.gbsproj out/game.gb
  

  从 gbsproj 生成 ROM 文件

• 生成 Pocket 文件

  > $(yarn bin gb-studio-cli) make:pocket path/to/project.gbsproj out/game.pocket
  

  从 gbsproj 生成 Pocket 文件

• 生成网页版

  > $(yarn bin gb-studio-cli) make:web path/to/project.gbsproj out/
  

  从 gbsproj 生成网页版构建

GBS 音乐

音乐编辑器的独立网页应用可通过 https://music.gbstudio.dev/ 访问

要在本地运行此应用程序

> npm run start:music-web

或为自行托管生成资源

> npm run build:music-web

这会将构建文件输出到 out/music-web。

文档

GB Studio 文档

致翻译者的说明

如果您想帮助为 GB Studio 贡献新的语言本地化，可以通过提交拉取请求来添加或更新 JSON 文件，这些文件位于 https://github.com/chrismaltby/gb-studio/tree/develop/src/lang。

如果您希望更新现有翻译，补充缺失的内容，有一个便捷的脚本可以列出英语本地化文件中存在但您的本地化文件中缺失的键，并将这些键复制到您的本地化文件中。

npm run missing-translations lang
# e.g. npm run missing-translations de
# e.g. npm run missing-translations en-GB