------------ Important
Mac support is experimental, create a backup of you Cities in Motion Bundle/Package!

------------ Installing

1. Find your Cities In Motion Folder, where your Cities In Motion.exe resist.
	For Mac: Open your Cities In Motion.app bundle/package, go to Contents/MacOS

	For Steam User:
	<Programm Folder>\STEAM\STEAMAPPS\COMMON\CITIES IN MOTION\
	
	For Steam Mac User:

	/Users/<YourUserName>/Library/Application Support/Steam/SteamApps/common/cities in motion/Cities in Motion.app/Contents/MacOS

	You should now see a metro.gs file.

2. Create addons folder
	Now create the "addons" folder if it doesn't exists yet.
	Don't use any uppercase letters, all lowercase!


3. Extract ModManager

	In the attached zip archive you will find a eis_os_mod_manager_v<Number>.gs file,
	please copy this file to the addons folder.
	

4. Start CIM and enable Mods
	Start CIM, you get a screen to install ModManager, please say yes, 
	it's normal that CIM will quit after installing!

	Note: All Addons and Mods are disabled now!

	To enable all Mods and Addons please go into the ModManager screen via the Main Menu, 
	then follow the Manageing Mods (Tab 1) part.


5. Uninstall
	Please use the uninstall feature found in ModManager Settings (third tab, left button)
	and then remove all modmanager gs files in addons. (see below)

	*emergency uninstall*

	If something goes wrong, ModManager can be disabled/removed by removing the gs file,
	delete the following scripts or replace them with your backup.

	metro/scripts/addons.script
	metro/ui/loading/loading.script


6. Important for Mac Users:
	As soon as you start to try downloading files or repositories OSX will tell you have no rights to execute the file. 

	Fixing this is relative easy, start a terminal:
	cd /Users/<YourUserName>/Library/Application Support/Cities in Motion/modmanager/download/
	chmod +x modmanagerdownloader.command
	sh modmanagerdownloader.command

	Next time executing the command file should work directly.



------------ Updateing
Please use the integrated downloader,
refresh repositories in the install tab, then click on ModManager and hit "Download & Update"

If you have problems:

Click the uninstall button in the Settings Tab, quit CIM.
Remove the old gs file and put the new gs file to addons.


------------ Manageing Mods (Tab 1)

In the Main Menu and Pause Menu you will find a new entry "Mod Manager".
This will open the UI. If the UI stays ingame, please open the Pause Menu again, this should kill it.

Click on a Mod/Addon and press "Activate", the red status indicator should go green.
Yellow means, Mod Loaded but depencies missing. Very Bad.
Nothing = Can't be changed currently or is simply off.

Press "Save", when you close CIM the on/off status won't be saved automatically!

You can create different profiles and switch them in the upper right corner.


------------ Settings (Tab)
Here you can add repositories by clicking on [[New]]
A window should open, you can give the repository a name and use a repository url.

A repository url for "Extended Money Bar" and "eis_os Tram Puzzle Pieces" is:
http://cim.bytetransfer.de/repo/cim.repo

(you may use copy and paste the url, via Ctrl-C and then Ctrl-V)


------------ Install (Tab)
You can refresh the repositories (actually downloading a list of mods) and install mods and addons here.
This will result in running modmanagerdownloader.exe, you want to give it Internet Access in your Firewall,
otherwise it won't be able to download something.

------------ Info (Tab)
Get CIM Systeminfos, like Version, User Folder, direct access to log_metro.txt,
change the Debug Modus.



