The editor allows you to browse and manipulate all files in your game project in an efficient manner. Editing files brings up a suitable editor and shows all relevant information about the file in separate views.
When you run the Defold editor, you are presented with a project selection and creation screen. On the left side there are three main views available. Click to select what you want to do:
Click to show a lists your recently opened projects so you can quickly access them. This is the default view.
Click if you want to create a new Defold project, then select if you want to base your project on a basic template (from the From Template tab), if you would like to follow a tutorial (the From Tutorial tab), or try one of the sample projects (the From Sample tab).
When you create a new project it is stored on your local drive and any edits you do are saved locally. To share the project with members of your team, use the Synchronize feature in the editor. It creates a Defold cloud Git storage project for you through which you and your team can synchronize work.
Create a working copy from an existing project from you Defold cloud Git storage account. The local copy is linked to the cloud Git project so it’s ready for team synchronization.
Access to the Defold cloud git storage requires that you provide your Defold account credentials.
You can learn more about the different options in the Project Setup manual.
The Defold editor is separated into a set of panes, or views, that display specific information.
Lists all the files that are part of your project. Click and scroll to navigate the list. All file oriented operations can be made in this view:
The center view shows the currently open file in an editor for that file type. All visual editors allows you to change the camera view:
There is a toolbar in the top right corner of the scene view where you find object manipulation tools: Move, Rotate and Scale.
This view shows the content of the file currently being edited, but in a hierarchial tree structure. The outline reflects the editor view and allows you to perform operations on your items:
This view shows properties associated with the currently selected item, like Position, Rotation, Animation etc, etc.
This view shows any error output or purposeful printing that you do while your game is running. Alongside the console are tabs containing the Curve Editor which is used when editing curves in the particle editor, the Build Errors view that shows build errors, and the Search Results view that displays search results. The console is also used for interacting with the integrated debugger.
This view lists any files that has been changed, added or deleted in your project. By synchronizing the project regularly you can bring your local copy in sync with what is stored in the project Git repository, that way you can collaborate within a team, and you won’t lose your work if unfortune strikes. Some file oriented operations can be performed in this view:
If you have multiple files open, a separate tab for each file is shown at the top of the editor view. It is possible to open 2 editor views side by side. Right click the tab for the editor you want to move and select Move to Other Tab Pane.
You can also use the tab menu to swap the position of the two panes and join them to a single pane.
Double clicking a collection or game object file brings up the Scene Editor:
Click on objects in the main window to select them. The rectangle surrounding the object in the editor view will highlight green to indicate what item is selected. The selected object is also highlighted in the Outline view.
You can also select objects by:
Hold Shift or ⌘ (Mac) / Ctrl (Win/Linux) while clicking to expand the selection.
To move objects, use the Move Tool. You find it in the toolbar in the top right corner of the scene editor, or by pressing the W key.
The selected object shows a set of manipulators (squares and arrows). Click and drag the green center square handle to move the object freely in screen space, click and drag the arrows to move the object along the X, Y or Z-axis. There arn also square handles for moving the object in the X-Y plane and (visible if rotating the camera in 3D) for moving the object in the X-Z and Y-Z planes.
To rotate objects, use the Rotate Tool by selecting it in the toolbar, or by pressing the E key.
This tool consists of four circular manipulators. An orange manipulator that rotates the object in screen space and one for rotation around each of the X, Y and Z axes. Since the view is peripendicular to the X- and Y-axis, the circles only appear as two lines crossing the object.
To scale objects, use the Scale Tool by selecting it in the toolbar, or by pressing the R key.
This tool consists of a set of square handles. The center one scales the object uniformly in all axes (including Z). There also one handle for scaling along each of the X, Y and Z axes and one handle for scaling in the X-Y plane, the X-Z plane and the Y-Z plane.
To create new resource files, either select File ▸ New… and then choose the file type from the menu, or use the context menu:
Right click the target location in the Assets browser, then select New… ▸ [file type]:
Type a suitable name for the new file. The full file name including the file type suffix is shown under Path in the dialog:
To add asset files (images, sounds, models etc) to your project, simply drag and drop them to the correct position in the Assets browser. This will make copies of the files at the selected location in the project file structure.