百舸争流，各成其器。
Local-first, cross-engine game authoring infrastructure with human-controlled AI.
English · 中文 · Product Website · Web Roadmap
BAG — Build Across Games is the English brand of 百舸, an open, local-first foundation for building cross-engine game authoring tools. It provides engine-neutral domain data, shared editor infrastructure, lightweight engine bridges, and a controlled LLM Patch workflow so individual tools can focus on their own domain instead of rebuilding the same platform layer.
BAG is the platform, ecosystem, and shared technical foundation. User-facing tools are independently named products. Official products carry the fixed family signature:
A BAIGE Project
BAIGE is not the English platform name. Outside migration/history text, it is reserved for the phrase A BAIGE Project.
- Local-first — project data and production assets remain on the developer's machine by default.
- Cross-engine — BAG IR describes design intent independently from Unreal Engine, Godot, Unity, or a proprietary engine.
- Human-controlled AI — an LLM may propose validated structural patches, but it cannot bypass review or directly alter final engine assets.
- Open and portable — schemas, the BAG Bridge Protocol, and reference runtimes are open so projects are not locked to one tool.
- Product independence — official tools keep their own names, identities, and domain focus while sharing BAG infrastructure.
- Production-oriented — versioned data, deterministic validation, rollback, migration, and source control come before feature count.
The brand hierarchy is intentionally split into two layers:
百舸 / BAG
Build Across Games
│
├─ <Independent Product Name>
│ └─ A BAIGE Project
└─ Shared Infrastructure
├─ BAG Studio
├─ BAG IR
├─ BAG Bridge Protocol
└─ @bag/*
Official products are not named BAG <Feature>. Each product receives an independent name, preferably drawn from Chinese classical literature, poetry, imagery, or related cultural language, while A BAIGE Project provides the common family signature.
See Product Naming Rules.
This repository is building the shared BAG authoring foundation and a first combat-authoring vertical slice with animation timelines, damage volumes, virtual sockets, VFX and audio events, movement curves, input and cancel windows, and authoritative engine preview.
- Primary support: Unreal Engine
- Cross-engine reference: Godot
- Technical preview: Unity
- Target release:
v0.8 Public Beta
apps/studio/ BAG Studio web/desktop front end
packages/editor-core/ Shared editor state and command model
packages/schema/ BAG IR and schemas
packages/bridge-protocol/ BAG Bridge Protocol
engines/unreal/ Unreal Bridge and Runtime
engines/godot/ Godot Bridge and Runtime
engines/unity/ Unity technical preview
docs/ Architecture, principles, naming, constraints, specifications
website/ GitHub Pages website
Shared JavaScript/TypeScript packages use the @bag/* namespace. Public platform types and constants use BAG terminology, for example:
@bag/studio
@bag/editor-core
@bag/schema
@bag/bridge-protocol
BAG_SCHEMA_VERSION
BagDocument
Legacy @baige/*, Baige*, BAIGE_*, CrossLoom, and @crossloom/* names are not used for new APIs except explicit migration compatibility.
corepack enable
pnpm install
pnpm dev
pnpm check- Product Naming Rules
- Design Principles
- AI Development Constraints
- Architecture
- Product Scope
- Schema Rules
- Bridge Protocol
- Testing Strategy
- Security Boundaries
- One-year Roadmap
The repository was originally created under the codename CrossLoom and briefly used BAIGE as the standalone English platform name. The repository itself is now named BAG.
Current rules are:
- 百舸 — Chinese brand name.
- BAG — English brand name.
- Build Across Games — official expansion of BAG.
- A BAIGE Project — fixed family signature for official products only.
- CrossLoom / standalone BAIGE / @baige/ — legacy names for migration or historical references only.
百舸 的英文品牌名为 BAG，完整展开为 Build Across Games。百舸是一个面向跨引擎游戏创作工具的开源、本地优先基础平台，提供统一领域数据、通用编辑器基础、轻量引擎桥接与受控 LLM Patch 工作流，使每个领域工具能够专注自身问题，而不必重复建设平台层。
BAG 是母品牌、生态与技术底座。 面向用户的工具拥有自己的独立名称；百舸旗下正式产品统一使用以下家族署名：
A BAIGE Project
需要特别区分：BAIGE 不再作为百舸的英文平台名。除历史与迁移说明外，它只用于固定短语 A BAIGE Project。
- 本地优先：项目数据与正式资产默认保留在开发者设备中。
- 跨引擎：BAG IR 独立描述设计意图，再由 Bridge 与 Runtime 适配 Unreal、Godot、Unity 或自研引擎。
- 人工主导 AI：LLM 只能提出经过校验的结构化 Patch，不能绕过审核，也不能直接修改最终引擎资产。
- 开放可迁移：开放 Schema、BAG Bridge Protocol 与参考 Runtime，避免项目被单一工具锁定。
- 产品独立：官方工具拥有自己的名称、视觉身份和领域边界，同时共享 BAG 基础设施。
- 生产导向：版本化数据、确定性校验、回滚、迁移和版本控制优先于功能数量。
百舸 / BAG
Build Across Games
│
├─ <独立产品名>
│ └─ A BAIGE Project
└─ 共用基础设施
├─ BAG Studio
├─ BAG IR
├─ BAG Bridge Protocol
└─ @bag/*
百舸官方产品不采用 BAG + 功能名 的统一前缀方式。每个面向用户的产品拥有独立名称，优先从中国古典文学、诗词、意象与相关文化语言中取名，并统一使用 A BAIGE Project 作为家族署名。
完整规则见 产品命名规范。
当前仓库正在建设 BAG 共用创作基础，并通过首个战斗创作垂直切片验证动画时间轴、伤害判定体、虚拟挂点、VFX/Audio 事件、位移曲线、输入与取消窗口，以及引擎权威预览等能力。
- 首要支持引擎：Unreal Engine
- 跨引擎参考实现：Godot
- 技术预览：Unity
- 年度目标版本：
v0.8 Public Beta
apps/studio/ BAG Studio 桌面/Web 前端
packages/editor-core/ 通用编辑器状态与命令模型
packages/schema/ BAG IR 与 Schema
packages/bridge-protocol/ BAG Bridge Protocol
engines/unreal/ Unreal Bridge 与 Runtime
engines/godot/ Godot Bridge 与 Runtime
engines/unity/ Unity 技术预览
docs/ 架构、原则、命名、约束与规范
website/ GitHub Pages 产品说明站点
共享 JavaScript/TypeScript 包统一使用 @bag/*：
@bag/studio
@bag/editor-core
@bag/schema
@bag/bridge-protocol
BAG_SCHEMA_VERSION
BagDocument
除显式迁移兼容外，新公共 API 不再使用 @baige/*、Baige*、BAIGE_*、CrossLoom 或 @crossloom/*。
corepack enable
pnpm install
pnpm dev
pnpm check本仓库最初使用 CrossLoom 作为代号，上一阶段曾短暂将 BAIGE 作为英文平台名。目前正式规则已统一为：
- 中文品牌：百舸；
- 英文品牌：BAG；
- BAG 展开：Build Across Games；
- 官方产品署名：A BAIGE Project；
CrossLoom、单独使用的BAIGE、@baige/*：仅保留给历史与迁移兼容场景。
- Version / 版本：
0.1.0-foundation - Stage / 阶段：M0 Architecture Freeze / 架构冻结
- Website / 产品网站：https://syurli.github.io/BAG/
- Roadmap / 网站路线图：https://syurli.github.io/BAG/roadmap.html
BAG source code is licensed under Apache License 2.0. BAG, Build Across Games, 百舸, official product names, logos, and the A BAIGE Project mark are not automatically licensed with the source code.
BAG 源代码采用 Apache License 2.0。BAG、Build Across Games、百舸、官方产品名称、Logo 与 A BAIGE Project 标识不因代码许可证而自动授权。