The Placement Editor is a tool that allows you to visually design levels and screens for your games, which can then be exported and loaded directly into AGK.
This utility is located within the IDE\Utilities folder for AGK e.g. C:\Program Files\The Game Creators\AGK\IDE\Utilities within the folder named Placement Editor.
Within the Placement Editor folder are two folders named Editor (the actual editor) and Viewer (an AGK project to load data exported from the editor).
The Placement Editor folder contains an executable named Placement Editor.exe. Launch this to start the editor.
Before you begin creating levels you must copy any media into the media folder of the Placement Editor. By default this is located at C:\Program Files\The Game Creators\AGK\IDE\Utilities\Placement Editor\Editor\media.
If no media is present within the media folder you will be presented with this message when running the editor:
Once your media has been copied into the media folder and you launch the editor you will be presented with this:
The following screen shots show the different components of the Placement Editor
You can drag media onto the main editing area, edit its properties and move it around.
This button allows you to create a new project. When pressing it a dialog will be displayed on screen that allows you to specify the width and height of your screens and the number:
This button will load any saved data. The file must be named export.txt and be placed in the same directory as the Placement Editor executable e.g. C:\Program Files\The Game Creators\AGK\IDE\Utilities\Placement Editor\Editor.
This will save your data into a text file named export.txt. The data will be saved alongside the Placement Editor executable in C:\Program Files\The Game Creators\AGK\IDE\Utilities\Placement Editor\Editor.
When the paint option is selected you can paste the last imported item. For example, import an image of a crate and drop this on the screen, now press the paint button, now click on the main editing area to drop another crate.
Select a sprite and then press the delete button to remove it from the sceene.
Select a sprite then press the properties icon to display a dialog allowing you to supply a name for the sprite along with rotation and scale values.
When you have multiple screens it may be useful to display the edge of each screen. When borders are displayed blue lines will surround the edge of each screen.
Press this button to show or hide the grid.
This button controls the width of the grid.
This button controls the height of the grid.
Press this button to ensure sprites snap to the grid when moving them around.
When a sprite is selected several tool icons will appear next to it.
The padlock icon at the top allows you to lock a sprite. When a sprite is locked it cannot be moved. This is followed by two icons that allow you to move a sprite up or down a layer. Click and hold the next icon to rotate the sprite. Click and hold the icon below to scale a sprite. The final two icons allow you to mirror and flip the sprite.
A Tier 1 AGK project is available within C:\Program Files\The Game Creators\AGK\IDE\Utilities\Placement Editor\Viewer.
Ensure you copy your saved data (export.txt) and any media into the media folder. Now open the project and you will be presented with this code:
Run the program and your level will be displayed on screen ready to be used within your AGK game.