Jade Tilemap Editor

The Editor uses the ECS system from the course https://pikuma.com/courses/cpp-2d-game-engine-development. You can load and save data to [.map] files. When saving and loading, the editor uses a [.lua] file that loads the the location of the [.map] files and the tilesets that are used.

Just Added Save to Lua Table Functionality. It creates a formatted lua table currently set up for another project that I am working on.

This application was created to quickly make tile maps for small games created with the Pikuma Game Engine. I re-made the tilemap editor that I created in my ZeldaClone https://github.com/dwjclark11/ZeldaClone_NES. I added more functionality and made the code more clean and concise as my abilities continue to grow.

Read the Docs

• Just created a quick documation site created with MD Book. Check it out here (Work in progress): https://dwjclark11.github.io/TilemapEditor_Document_Site/

Video

tilemap_editor.mp4

Loading a Map Project

New_Tilemap_Vid.mp4

Technologies

• ImGui - for user interface
• SDL2 - for rendering and window/inputs
• Sol/Lua - for loading files
• ECS - from Pikuma Game Engine

Dependencies

• SDL2
• ImGui
• SPDLOG
• Sol/Lua

Build

• Added Premake5.lua build script. Just run the GenerateSln.bat file and it should create the Visual Studio 2022 solution for you.
• You may need to edit the GenerateSln.bat to run your version of VS if not using 2022.
• Ex: change call premake\bin\premake5 vs2022 to call premake\bin\premake5 vs2019
• I have not added any other platforms to the build for I use VS and windows; however, you should be able to add your OS to the build script

Functionality

• Load/Add multiple tilemaps
• Undo/Redo functionality when adding/removing tiles and changing canvas size
• Save/Load capabilities.
  • I have changed the way that I load/save files. It differs from the course; therefore, you may have to rewrite the save functionality.
  • The load function uses lua/sol and loads previously saved projects and their assets/tilemaps into the asset manager.
• Selecting different tiles based on where you click on the displayed tileset
• Panning and Zooming

Tilemap Editor Controls

Key Shortcuts and Functions

key	Function
W	Move Camara Up
S	Move Camera Down
A	Move Camera Left
D	Move Camera Right
Space	Move Camera to Default Position
Ctrl + Z	Undo Command
Ctrl + Shift + Z	Redo Command
Ctrl + S	Save/Save As Project
Ctrl + O	Open Project
Ctrl + N	New Canvas/Project

Mouse Functions

Mouse Button	Function
Left Button	Add Tile
Middle Button	Pan/Move the Camera
Right Button	Remove Tile
Wheel Up	Zoom In
Wheel down	Zoom Out

Issues to Work On

• Only works on 1920 1080 Resolution, does not take into affect other screen resolutions
• Box Collider Offset not scaling properly with zoom fixed
• There are probably more bugs that I am still finding