splash

maps4cim

maps4cim is a map generator for the traffic simulation game Cities in Motion 2, which creates maps based on real parts of the world.

The required source data for relief and inscriptions can be downloaded on demand from free data sources. The elevations are directly integrated in the resulting map, all further data (roads, forests, rivers, buildings, …) are painted on the ground texture, so they can be recreated in the map editor.

Core Features

Release / Downloads

You can get the latest binary release from one of the following mirrors:

Apart from that, a test version of maps4cim will be available soon, which will be updated more frequently and contain the latest features, but might not be as stable as the major releases.

Instructions

Prerequisites

Installation

  1. Unzip the downloaded file maps4cim.zip
  2. If you are on Windows, start maps4cim.exe. On other operating systems, launch maps4cim.jar. If you run into memory issues, use the provided launch skript maps4cim.sh.
  3. Profit!

If you want to remove all user data that was stored by maps4cim, open maps4cim’s settings (menu ToolsSettings) and hit the Uninstall-Button.

Quick Start

Launch maps4cim. You will be presented with the main window which looks like this:

screen-app

First, make yourself familiar with the map; navigation works like any other map service on the web. Right click on the map to select a location.

You may use the settings panel on the right to adjust you configuration, but for now, just leave everything as is and hit the Render-Button on the bottom right. Select a location on your hard drive and off we go!

maps4cim will download all required source data on the fly and the map will be rendered for you. After 1-2 minutes, the flashing progress bar turns solid green and your map is ready. Move your map to C:\Users\MYNAME\AppData\LocalLow\Colossal Order\Cities in Motion 2\Maps (Windows) or /Users/MYNAME/Library/Application Support/Colossal Order/ (Mac) and start Cities in Motion 2. You can now edit your map in the map editor.

screen-game

Screenshot: View from the Brenner Pass on Innsbruck, map rendered in Cities in Motion 2, as generated by maps4cim.

There are a lot more features to explore, just have a look around. For more information on how to use maps4cim, use the built-in documentation and visit the forums (see links below). Have fun :)

Discussion & Support

For more information, usage guides, technical support, praise and criticism, please visit the forums:

Get involved

maps4cim is free software and you can get the source code from github

github.com/Klamann/maps4cim.git

Please note that this is still an early source code release, with important parts of the code in an undocumented and sometimes rather dirty state, but it should be well enough to work with.

If you want to contribute new features, don’t hesitate to do so! Fork the project and write your code, and if you like what you’ve done and think it may be useful for others, create a pull request.

For some hints on how to work with the code, see Deveopers.md. More documentation can be found in the docs folder.

Changelog

1.0.0

0.9.3.1 beta

0.9.3 beta

for the full changelog, see CHANGELOG.md

License

maps4cim is free software, distributed under the terms of the Apache License, Version 2.0.

maps4cim - a real world map generator for CiM 2
Copyright 2014 Sebastian Straub

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.