Skip to content

AHeroicLlama/Mappalachia

Repository files navigation

Mappalachia

The complete mapping tool for Fallout 76.
Mappalachia is a Windows application for generating and exporting complex maps of entities within the Fallout 76 game world.

Latest release

Latest release

Discord
License

Download and Installation

Download 'Mappalachia.zip' from here to get started generating maps. Simply unzip it to a folder and then launch Mappalachia.exe.
For help installing please refer to the installation and first launch guide.

User Guides

A number of User guides exist for Mappalachia in document form;

Discord

Join the Mappalachia Discord for discussion and help.

Info for Developers

Alongside the source code for the GUI itself, this repository also contains the necessary scripts and code used to export, preprocess and build the Mappalachia database and also generate/render supporting image assets.

The required information is compiled in 3 key steps.

  1. Extract the raw data in CSV using FO76Edit
  2. Preprocess the data and assemble the database, with validation
  3. Image Asset rendering and extraction

If you fancy doing some data mining or development with Mappalachia then you may be interested in the following documentation;

  • FO76Edit scripts explains using FO76Edit to run the Mappalachia edit scripts to export rough, raw game data.
  • Preprocessor covers using the CLI tool to assemble the database, and provide data and asset validation.
  • Background Image Rendering explains using the powerful fo76utils to render top-down views of locations, used for map backgrounds.
  • Map Icon extraction explains the process of exporting map marker icons from the game to Mappalachia.
  • GUI covers developing and debugging the Mappalachia GUI itself.
  • Deployment explains how to update and deploy Mappalachia, including following a game update.

Thanks

  • Every single person who has so generously donated to say thanks for Mappalachia.
  • All prominent members of the Mappalachia Discord who have provided feedback and ideas for new features. (Gilpo, Duchess Flame, MeatServo, Scratchy, frame, +rat, fo76utils, pcrov and more)
  • Contributors to and developers of XEdit and FO76Edit, namely Eckserah.
  • Members of the FO76 Datamining Discord, for helping out with FO76Edit and Edit Scripts.
  • fo76utils for their excellent, powerful render tool, used to render background images.

Licensing

This project is licensed under the GNU General Public License 3.0 - see LICENSE.md for details.
Mappalachia uses technologies such as .NET, SQLite, SVG.NET and KGy SOFT Core Libraries which are each subject to their own licenses.
Use of other third-party assets are covered below.

Legal/Disclaimer

Mappalachia is provided as a non-commercial, free tool solely for the benefit of players of Fallout 76. Mappalachia and its creator are neither affiliated with - nor endorsed by - ZeniMax Media or any of its subsidiaries including Bethesda Softworks LLC. Any and all game data and/or assets including but not limited to images, characters, names and other game data which are contained within this application (and thus stored and distributed at this repository) are extracted from a purchased copy of Fallout 76 and are shared with the player community in good faith and for the explicit purpose of making maps for the benefit of said community, with an understanding that this lies within fair use.
Great care has been taken to minimize such data so that it cannot be reconstructed in any meaningful way.
If you have any concerns or queries, please direct them to mappalachia.feedback@gmail.com.