ASCII Mapper
Ever needed a map editor for a tile-based game, but found most of them too complicated and/or specific? ASCII Mapper allows you to paint the same using the characters on your keyboard instead of graphics. That's it: just a grid of symbols you can load easily in code and interpret however you want.
Other ASCII art editors exist. This one differs from them in two big ways:
- It uses square tiles, so you can estimate distances well.
- It doesn't deal in color, to keep it abstract and distraction-free.
ASCII Mapper started out as a quick-and-dirty online prototype. As of 17 August 2019, there's also a desktop version offering more features.
But how will I know what all the symbols mean?
Why, they mean whatever you want them to. It's your game, and your maps.
That said, games in the roguelike genre have established certain conventions you might want to follow, to avoid having to make up your own:
. is the default, empty floor, is a marked floor that stands out in some way: is impassable terrain; is another type of impassable terrain# is a wall~ is water| is a column, pole or tree trunk^ is a mountain or pine tree" is a bush or foliage of some sort+ is a closed door/ is an open door= is a wooden plank, table or crate< is a staircase going up> is a staircase going down
You can also use any other character on the keyboard; just press any key you want to set the brush. For instance, I've used "*" to mean a fountain or basin, and "&" to mean a statue.
Limitations
ASCII Mapper handles maps of up to 100x100. You can't fit much more in a reasonably-sized browser window anyway, even at minimum zoom. The desktop version puts the map in a scrollable viewport, but even then it can only handle so many tiles at once before it becomes too slow.
Credits
Both editions are open source under the MIT License.
The Square font by Wouter van Oortmerssen is available under the CC-BY license. (Only needed in the online edition.)
Uses
I used ASCII Mapper forElectric Rogue andGlittering Light 2. More recently, it's listed in the credits ofMoonshot.
Shout-outs
- A devlog by the creator of Ct.js (9 April 2021)
| Status | Released |
| Category | Tool |
| Platforms | HTML5,macOS,Linux |
| Rating | Rated 4.5 out of 5 stars (13 total ratings) |
| Author | No Time To Play |
| Tags | ascii,Level Editor,Minimalist,Text based,Tilemap |
| Code license | MIT License |
| Asset license | Creative Commons Attribution v4.0 International |
| Average session | A few minutes |
| Languages | English |
| Inputs | Keyboard,Mouse,Touchscreen |
| Accessibility | Color-blind friendly,High-contrast |
| Links | Homepage,Source code |
Install instructions
The desktop version of ASCII Mapper requires a Python runtime. Python comes preinstalled on the Mac and most Linux distributions; Windows users can get it from thepython.org website. You'll also need the Tkinter module, which is bundled with most Windows runtimes and preinstalled on the Mac. On Linux you might need to add it yourself: look in your package manager for something called "tkinter", "python-tk" or the like.
Python version 3.3 or newer is preferred, but 2.7 should work as well.
Development log
Comments
Log in with itch.io to leave a comment.
This was really helpful. I needed a tool to help me design an ascii map for a single-screen micro-medtroidvania. After looking around a fair amount I found this and it worked perfectly for me. I used the web version and it was great. Thank you for making it! BTW, if you want to see what came out of it, you can check out my gameEdge of Known Space. Thanks again!
