User Manual


A branch is an isolated line of development. Every checkpoint created belongs to a branch and a series of checkpoints in a branch can track the development of an application or a particular feature. A PlayCanvas project will always have at least one branch, the main branch, and will often have multiple branches. You can merge the changes from one branch into any other branch using the version control panel in the Editor.

Main branch

Every project has a branch called "main" which is always present and cannot be deleted. In most respects this branch is no different from any other branch. However, in some cases (for example, the REST API) the "main" branch will be used as a default if no other branch is specified. A common scenario is to treat the main branch as the current development state of your application; to use another branch for stable releases and still more branches for feature development. However, you should feel free to use or not use the main branch as best suits your needs.


作業を行っている各プロジェクトには 現在のブランチ に設定されたブランチがあります。これは作業中のブランチでエディターを開いたりコードファイルの編集を行った際に、現在のブランチに変更が適用されます。


Create branch

ブランチを作成するには、バージョンコントロールパネルを開き、ブランチを開始するチェックポイントを選択して、ドロップダウンメニューから「New Branch」オプションを選びます。

New branch dialog



Switch branch

ブランチを切り替えるにはバージョンコントロールパネルを開き、切替先のブランチを選択してドロップダウンメニューの「Switch to this branch」オプションを選択します。



Close branch

If you have completed work on a branch, you can close it which will remove it from the open branches list.

To close a branch, open the version control panel, select the branch you wish to close and choose the "Close this branch" option in the branch's drop-down menu. Note that you cannot close your current branch or the main branch. Switch to a different branch first if you wish to close your current branch.

Close branch dialog



Deleting a branch

Deletion of branches are only supported if the following conditions are met:

To delete a branch open the version control panel, select the branch you wish to delete and choose the "Delete this branch" option in the branch's drop-down menu.

You will be asked to confirm the deletion of the branch by typing the name of the branch in the dialog box.

Note, deleted branches cannot be recovered after deletion! If in doubt, please close the branch instead.

This site is translated by the community. If you want to get involved visit this page