CDDA Map Editor

The CDDA Map Editor is a map editor for the Open-Source roguelike Cataclysm: Dark Days Ahead. It allows you to edit the Maps in an easy-to-use interface and receive instant feedback without having to reload the game or touch the underlying JSON Files.

If you prefer editing the Mapgen files directly, you can create a new Mapgen Viewer Which will automatically reload the selected map when you save the file.

Important

As of right now, this program only supports the Mapgen Viewer. The map editor has not been implemented and is currently in the works. If you still want to use a map editor, the best alternative as of right now is the Hostile Architect Editor, which makes map editing easier, without having to read the CDDA Game directory.

Related Posts

• https://discourse.cataclysmdda.org/t/overmap-special-mapgen-viewer/29718
• https://discourse.cataclysmdda.org/t/feature-suggestion-for-a-custom-map-editor/29600

What can this Map Editor do?

What properties are supported?

This editor currently supports the following mapgen file object properties including their place counterparts:

• terrain
• furniture
• monsters
• nested
• toilets
• fields
• signs
• computers
• gaspumps
• traps
• vehicles
• corpses
• monster

What properties are not supported?

The following properties are not supported yet:

• npcs
• loot
• sealed_item
• rubble
• liquids
• remove_vehicles
• graffiti
• items

Important

Please keep in mind that the editor does not represent the map perfectly as it will be shown ingame. Always load your map in the actual game to check if it matches the map that is shown. If you find any inconsistencies, please head over to the Issues Page and submit a new issue after checking the Known Problems.

What tilesets are supported?

This editor should support most non-iso tilesets, including but not limited to:

• Altica
• BrownLikeBears
• ChibiUltica
• Cuteclysm
• GiantDays
• LarwichOvermap
• MshockXotto+
• NeoDaysTileset
• RetroDaysTileset
• MSX++UnDeadPeopleEdition

Known Problems

Here is a list of known limitations, which may or may not be fixed in the future.

• Vehicle Rotations beside 0, 90, 180 and 270 degrees look bad
• Damaged and Broken vehicles are not accurately spawned as they should be (With parts removed and disabled)
• Mutable overmap terrain entries are not supported
• Isometric tilesets are not supported
• rotates_to is not supported
• Some non-iso tilesets do not work
• No Background color for fallback ascii sprites

Installation

Prerequisites

To provide support for Palettes, Nested Mapgens and other related data, you will need to have a local copy / installation of CDDA which will be read and parsed by the application.

Downloads

Check out the Releases page to download the most recent executable for your platform.

Compiling

If you want to compile the program yourself, you can follow the steps below.

1. Install the required system dependencies for your Operating System outlined in https://v2.tauri.app/start/prerequisites/
2. Install Rust from rust-lang.org. This is used to run the Webview backend, which provides support for OS native operations such as Filesystem access.
3. Install Node.Js (LTS) from nodejs.org. This is used by the Webview frontend, which is powered by React.
4. Install the Tauri CLI using your preferred package manager
5. Finally, to build the application, run the cargo tauri build command in your terminal
6. The application should be located in the src-tauri/target/release directory