A C++17 desktop GUI application for editing Fallout 2 image assets — FRM sprites, MSK mask tiles, overworld map tiles, and town map tiles. Built with Dear ImGui (docking branch), GLFW, OpenGL 3.3, and GLAD.
Forked from msk2bmpGUI by QuantumApprentice, which was originally based on the msk2bmp sources by temaperacl.
- Load standard image formats (PNG, BMP, JPG, GIF) and Fallout FRM/FR0-FR5 files via file dialog or drag & drop
- Load MSK mask files and
.wmapworldmap project files - Import an existing worldmap directly from Fallout 2 (parses
worldmap.txt, stitches FRM tiles and MSK masks, and loadscity.txtdata into a single editable project) - Palettize images to the Fallout 256-color palette using Euclidean distance color matching with optional Floyd-Steinberg dithering
- Real-time palette rendering via OpenGL fragment shaders
- Display multi-frame FRM animations in all 6 orientations
- Drag & drop a folder of images to load them as sequential animation frames, with automatic directional grouping (NE, E, SE, SW, W, NW subfolders)
- Split a source image into a grid of 350x300 FRM tiles for the Fallout 2 overworld map
- Export all tiles or a single selected tile
- Automatic
.wmapproject file creation for round-trip editing — reload exported tiles without the original source image - Note: Only the default vanilla worldmap size of 1400x1500 (4x5 tiles) has been tested so far. Other sizes may work but are untested.
- Create and paint 1-bit collision masks on a dedicated MSK layer
- Export MSK mask tiles alongside FRM tiles
- Automatically import city data (
CITY.TXT) when loading a worldmap from Fallout 2 - Display cities as interactive markers on the worldmap overlay
- Click markers to select a city and open the City Info panel
- Edit city properties: name, world position, size (Small/Medium/Large), start state, and lock state
- Export a modified
CITY.TXTalongside worldmap tiles
- Set a Fallout 2 game path for one-click export of FRM, MSK, and CITY.TXT files to the correct subdirectories
- Export a minimal
WORLDMAP.TXTtemplate for registering worldmap tiles
- Paint on palettized images using colors from the Fallout palette
- Fill-rect tool with configurable brush size
Detailed step-by-step guides are included in this repository:
- Importing & Loading Files — loading images, opening
.wmapprojects, importing a worldmap from a Fallout 2 installation, drag & drop animation loading - Worldmap Tiles & Masks — exporting overworld FRM/MSK tiles,
.wmapproject files, file format reference - City Editing — importing, editing, and exporting city data (
CITY.TXT) for the Fallout 2 worldmap
- Dear ImGui 1.90.8 (docking branch)
- GLFW 3.4
- GLAD (OpenGL loader)
- stb_image
- ImFileDialog
- tinyfiledialogs
cmake -S . -B build
cmake --build buildThe executable is build/FO2MapEdit. Resources are copied to build/resources/ automatically.
You may need to uninstall libtbb-dev if it conflicts with the CMake build.
Open msk2bmpGUI.sln in Visual Studio and build from the IDE.
This project is licensed under the GNU General Public License v3.0. Portions of this software were originally licensed under the MIT License.
Licenses for vendored dependencies are in the Licenses folder.