Awesome
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --> <!-- ALL-CONTRIBUTORS-BADGE:END --> <br /> <p align="center"> <a href="https://github.com/probabletrain/mapgenerator"> <img src="docs/images/logo.png" alt="Logo" width="125" height="125"> </a> <h3 align="center">Map Generator</h3> <p align="center"> Create procedural American-style cities <br /> <a href="https://probabletrain.itch.io/city-generator"><strong>Open Generator »</strong></a> <br /> <br /> <a href="https://maps.probabletrain.com" target="_blank">Read the Docs</a> · <a href="https://github.com/probabletrain/mapgenerator/issues">Report Bug</a> · <a href="https://github.com/probabletrain/mapgenerator/issues">Request Feature</a> </p> </p>Table of Contents
About The Project
<!-- TODO YT video -->This tool procedurally generates images of city maps. The process can be automated, or controlled at each stage give you finer control over the output.
3D models of generated cities can be downloaded as a .stl
. The download is a zip
containing multiple .stl
files for different components of the map.
Images of generated cities can be downloaded as a .png
or an .svg
. There are a few choices for drawing style, ranging from colour themes similar to Google or Apple maps, to a hand-drawn sketch.
Built With
Getting Started
To get a local copy up and running follow these steps.
Prerequisites
- npm
npm install npm@latest -g
- Gulp
npm install --global gulp-cli
Installation
- Clone the mapgenerator
git clone https://github.com/probabletrain/mapgenerator.git
- Install NPM packages
cd mapgenerator
npm install
- Build with Gulp. This will watch for changes to any Typescript files. If you edit the HTML or CSS you will have to rerun this command. Gulp Notify sends a notification whenever a build finishes.
gulp
- Open
dist/index.html
in a web browser, refresh the page whenever the project is rebuilt.
Usage
See the documentation.
Roadmap
See the open issues for a list of proposed features (and known issues).
Contributing
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated. For major changes, please open an issue first to discuss what you would like to change.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Contributors ✨
Thanks goes to these wonderful people (emoji key):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tr> <td align="center"><a href="https://github.com/trees-and-airlines"><img src="https://avatars3.githubusercontent.com/u/63573826?v=4" width="100px;" alt=""/><br /><sub><b>trees-and-airlines</b></sub></a><br /><a href="#infra-trees-and-airlines" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td> <td align="center"><a href="https://github.com/ProbableTrain"><img src="https://avatars2.githubusercontent.com/u/33726340?v=4" width="100px;" alt=""/><br /><sub><b>Keir</b></sub></a><br /><a href="https://github.com/ProbableTrain/MapGenerator/commits?author=ProbableTrain" title="Code">💻</a></td> <td align="center"><a href="https://github.com/ersagunkuruca"><img src="https://avatars3.githubusercontent.com/u/8115002?v=4" width="100px;" alt=""/><br /><sub><b>Ersagun Kuruca</b></sub></a><br /><a href="https://github.com/ProbableTrain/MapGenerator/commits?author=ersagunkuruca" title="Code">💻</a></td> <td align="center"><a href="https://github.com/Jason-Patrick"><img src="https://avatars3.githubusercontent.com/u/65310110?v=4" width="100px;" alt=""/><br /><sub><b>Jason-Patrick</b></sub></a><br /><a href="https://github.com/ProbableTrain/MapGenerator/commits?author=Jason-Patrick" title="Code">💻</a></td> </tr> </table> <!-- markdownlint-enable --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->This project follows the all-contributors specification. Contributions of any kind welcome!
Contact
Keir - @probabletrain - probabletrain@gmail.com
Project Link: https://github.com/probabletrain/mapgenerator
License
Distributed under the LGPL-3.0 License. See COPYING
and COPYING.LESSER
for more information.