------------ Important
Always make backups.
Mac support is experimental, do 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\

	/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, create backups
	Now create the "addons" folder if it doesn't exists yet.

	If you have modified the following scripts, please make a backup:
		metro/scripts/addons.script
		metro/ui/loading/loading.script

	If you don't find them, don't worry, it's not very likely you use a modified version.


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.

	If you can't find an "addons" folder, please create this folder.
	Don't use any uppercase letters!

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.



------------ Uninstall
Click the uninstall button in the Settings Tab.

Remove the relevant gs file, then remove or restore your backup of:

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

You may want to delete the Documents\Cities In Motion\modmanager folder
to remove any settings and downloaded files.


------------ Updateing
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 alist 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.



