This question comes up over and over again, because the information is scattered around the forum.
Aspyr do not support or even display the ability to run mods on their Mac port of Civ5, and the process for doing so has changed several times as Civ5 has been updated and the Gods and Kings expansion was released.
So. Here, gathered together in one place, is the current set of instructions to enable the Mods menu and to obtain and install mods to use in Civ5.
I hope to maintain this post as the definitive mod installation procedure, so please let me know if you spot any errors, or if the process changes as a result of Civ5 updates.
UPDATE 19 June 2014
PLEASE USE THE SIMPLE PROCEDURE in this post. The script linked in that post configures the Steam version of Civ5, and installs mods you can subscribe to from the Steam Workshop.
END UPDATE
For people unable to use the above automated script for any reason, here is the manual process required:
The steps involved are:
* NOTES:
1. Organise your privileges
You must be logged in as an Administrator on your Mac in order to modify the software.
I strongly recommend that you use BBEdit or TextWrangler, or another text editor that allows you to authenticate with your Administrator password in order to edit files owned by root. Otherwise you will have to modify the privileges for the files you have to edit, and for their parent folders before you edit them. TextEdit can be used, but please also note the issue with double hyphens below.
2. Find your Civ5 application
Your Civ5 application is in one of two places depending on whether it is registered with Steam or with the Mac App Store.
In a Steam-registered installation, select the Finder's Go->Go to Folder menu option.
Copy and paste the following path string into the text box and click Go:
~/Library/Application Support/Steam/SteamApps/common/sid meier's civilization v/Civilization V.app
This will open a Finder window with your Civ5 application highlighted.
In a Mac AppStore registered installation highlight /Applications/Civilization V Campaign Edition.app
NOTE: The App Store Civ5 Campaign Edition appears to have been modified in the last few months to make it unable to run mods. If anyone is still able to run mods in Campaign Edition, please let us know.
3. Modify your Civ5 software
You have to edit some script files within the Civ5 application in order to enable the Mods menu.
When you have highlighted your copy of the Civ5 application, right click or control-click it and select Show Package Contents.
Find the following folder within the package contents window that opens:
Contents/Home/assets/UI/FrontEnd/MainMenu.lua
Open this file using a suitable text editor (see section 1 above).
Find the following line (line #37 in my copy) and insert two hyphens at the start of the line to make it into a comment line as shown:
NOTE: TextEdit seems to change two hyphens into an em-dash (a single Unicode character for a long dash). This breaks the Lua script interpreter. To prevent this, copy and paste two hyphens from elsewhere in the script if you are using TextEdit.
Save the file.
[update]The following additional steps do not appear to be necessary now
If you have the Gods & Kings expansion, repeat the above steps to edit the second copy of the file at:
Contents/Home/assets/DLC/Expansion/UI/FrontEnd/MainMenu.lua
Finally, go to this post by Iamgoofball and follow his instructions to replace the file:
Contents/Home/assets/UI/FrontEnd/Modding/InstalledPanel.xml
4. Find and Download a Mod
Mods that use a custom DLL cannot be run with the Mac versions of Civ5.
You cannot install mods automatically using the Steam Workshop. That only works for Windows users.
However, if you are using the Steam version of Civ5 then you can subscribe to a Steam Workshop mod. It will then download to a folder on your Mac: ~/Library/Application Support/Steam/userdata/########/ugc/ *. Find the [mod name].civ5mod file in this folder. You will need to explore its subfolders. Extract and install the mod manually (see next sections). The Mac version of Civ5 doesn't do this for you.
If you are running the Mac AppStore version then you will have to find a downloadable file for the mod you want. The best place to look first is in CFC's Civ5 Downloads Section. If the mod you want is only available from the Steam Workshop, then you will have to find a friendly Steam user with Civ5 to download it for you. You can then copy the mod to your Mac.
One way or another, download the file for the mod that you want.
5. Expand/Extract the Mod
Mac Civ5 cannot handle a compressed mod file. It must be extracted into a folder of plain, uncompressed files before you install it.
Steam Workshop mods will download as compressed .civ5mod files. These files are compressed using '7zip' format, and you need third party software to extract the mod from them.
Other mods may be available in a number of formats - .zip, .7z, .rar. These are all single files that contain the separate files that make up the mod.
If the mod downloads as a .zip file then you can use your usual unzip utility. Safari may well unzip it automatically, depending on your settings.
If the mod downloads as a .civ5mod or .7z or .rar file then you can use Keka or Ez7z or Unarchiver to extract it. Depending on your extraction software, you may need to change a .civ5mod file extension to .7z so that it can recognise it.
I now recommend Keka for extracting mods. It downloads as a disk image file, so just drag the Keka icon to your Applications folder to install it.
I have attached a modified Preferences file for Keka that will recognise and extract a .civ5mod file automatically. Download this file and use Keka to extract it. Close Keka, and move the resulting com.aone.keka.plist file into ~/Library/Preferences/ to replace the existing file of the same name.
I no longer recommend Ez7z. It used to be available at MacUpdate.com, but the link seems to be broken as of January 2013. It is available at TechSpot, but TechSpot is one of those annoying download sites with lots of distracting links, and the app downloads as a .rar archive, so you need another extractor to get at the disk image to install it!
Whatever unzipping software you use, install it into your /Applications/ folder, drop the downloaded file onto its icon, and make sure that you end up with a single folder containing all the individual files (.xml, .lua, .dds, .mp3 ....) and subfolders that make up the mod.
6. Install the Mod
Move the extracted mod folder into the following folder to make it available for Civ5:
For the Steam version:
~/Documents/Aspyr/Sid Meier's Civilization 5/MODS
For the AppStore version *:
~/Library/Containers/com.aspyr.civ5campaign/Data/Library/Application Support/Civilization V Campaign Edition/MODS
7. Activate the mod
Launch Civ5. You should now see the Mods menu option on the main screen. Click it, and you should see a list of the mods you have installed. Click a checkbox to activate a mod. Click Next. Click 'Single Player" to proceed to the modified game setup screens where you can choose the Mod options to play. Do NOT click Back, as you will not see the Mod options in the standard game setup screens.
* If you can't find ~/Library on your Mac, please see the Notes near the top of this post.
Aspyr do not support or even display the ability to run mods on their Mac port of Civ5, and the process for doing so has changed several times as Civ5 has been updated and the Gods and Kings expansion was released.
So. Here, gathered together in one place, is the current set of instructions to enable the Mods menu and to obtain and install mods to use in Civ5.
I hope to maintain this post as the definitive mod installation procedure, so please let me know if you spot any errors, or if the process changes as a result of Civ5 updates.
UPDATE 19 June 2014
PLEASE USE THE SIMPLE PROCEDURE in this post. The script linked in that post configures the Steam version of Civ5, and installs mods you can subscribe to from the Steam Workshop.
END UPDATE
For people unable to use the above automated script for any reason, here is the manual process required:
The steps involved are:
- Organise your privileges
- Find your Civ5 application
- Modify your Civ5 software
- Find and download a mod
- Unzip/extract/expand/decompress the mod into a folder
- Install the mod
- Activate the mod
* NOTES:
- '~/' at the beginning of a file or folder path is short for "/Users/[your_user_name]/
- If a file or folder path begins with '~/Library' then this location may be hidden on your Mac. Use the Finder's Go to Folder menu option and copy/paste the path in order to find it.
1. Organise your privileges
You must be logged in as an Administrator on your Mac in order to modify the software.
I strongly recommend that you use BBEdit or TextWrangler, or another text editor that allows you to authenticate with your Administrator password in order to edit files owned by root. Otherwise you will have to modify the privileges for the files you have to edit, and for their parent folders before you edit them. TextEdit can be used, but please also note the issue with double hyphens below.
2. Find your Civ5 application
Your Civ5 application is in one of two places depending on whether it is registered with Steam or with the Mac App Store.
In a Steam-registered installation, select the Finder's Go->Go to Folder menu option.
Copy and paste the following path string into the text box and click Go:
~/Library/Application Support/Steam/SteamApps/common/sid meier's civilization v/Civilization V.app
This will open a Finder window with your Civ5 application highlighted.
In a Mac AppStore registered installation highlight /Applications/Civilization V Campaign Edition.app
3. Modify your Civ5 software
You have to edit some script files within the Civ5 application in order to enable the Mods menu.
When you have highlighted your copy of the Civ5 application, right click or control-click it and select Show Package Contents.
Find the following folder within the package contents window that opens:
Contents/Home/assets/UI/FrontEnd/MainMenu.lua
Open this file using a suitable text editor (see section 1 above).
Find the following line (line #37 in my copy) and insert two hyphens at the start of the line to make it into a comment line as shown:
Code:
--Controls.ModsButton:SetHide( true ); -- MAC_PORT - rickb Comment this line out to re-enable mods. Happy modding!
NOTE: TextEdit seems to change two hyphens into an em-dash (a single Unicode character for a long dash). This breaks the Lua script interpreter. To prevent this, copy and paste two hyphens from elsewhere in the script if you are using TextEdit.
Save the file.
Spoiler old instructions :
[update]The following additional steps do not appear to be necessary now
If you have the Gods & Kings expansion, repeat the above steps to edit the second copy of the file at:
Contents/Home/assets/DLC/Expansion/UI/FrontEnd/MainMenu.lua
Finally, go to this post by Iamgoofball and follow his instructions to replace the file:
Contents/Home/assets/UI/FrontEnd/Modding/InstalledPanel.xml
4. Find and Download a Mod
Mods that use a custom DLL cannot be run with the Mac versions of Civ5.
You cannot install mods automatically using the Steam Workshop. That only works for Windows users.
However, if you are using the Steam version of Civ5 then you can subscribe to a Steam Workshop mod. It will then download to a folder on your Mac: ~/Library/Application Support/Steam/userdata/########/ugc/ *. Find the [mod name].civ5mod file in this folder. You will need to explore its subfolders. Extract and install the mod manually (see next sections). The Mac version of Civ5 doesn't do this for you.
If you are running the Mac AppStore version then you will have to find a downloadable file for the mod you want. The best place to look first is in CFC's Civ5 Downloads Section. If the mod you want is only available from the Steam Workshop, then you will have to find a friendly Steam user with Civ5 to download it for you. You can then copy the mod to your Mac.
One way or another, download the file for the mod that you want.
5. Expand/Extract the Mod
Mac Civ5 cannot handle a compressed mod file. It must be extracted into a folder of plain, uncompressed files before you install it.
Steam Workshop mods will download as compressed .civ5mod files. These files are compressed using '7zip' format, and you need third party software to extract the mod from them.
Other mods may be available in a number of formats - .zip, .7z, .rar. These are all single files that contain the separate files that make up the mod.
If the mod downloads as a .zip file then you can use your usual unzip utility. Safari may well unzip it automatically, depending on your settings.
If the mod downloads as a .civ5mod or .7z or .rar file then you can use Keka or Ez7z or Unarchiver to extract it. Depending on your extraction software, you may need to change a .civ5mod file extension to .7z so that it can recognise it.
I now recommend Keka for extracting mods. It downloads as a disk image file, so just drag the Keka icon to your Applications folder to install it.
I have attached a modified Preferences file for Keka that will recognise and extract a .civ5mod file automatically. Download this file and use Keka to extract it. Close Keka, and move the resulting com.aone.keka.plist file into ~/Library/Preferences/ to replace the existing file of the same name.
I no longer recommend Ez7z. It used to be available at MacUpdate.com, but the link seems to be broken as of January 2013. It is available at TechSpot, but TechSpot is one of those annoying download sites with lots of distracting links, and the app downloads as a .rar archive, so you need another extractor to get at the disk image to install it!
Whatever unzipping software you use, install it into your /Applications/ folder, drop the downloaded file onto its icon, and make sure that you end up with a single folder containing all the individual files (.xml, .lua, .dds, .mp3 ....) and subfolders that make up the mod.
6. Install the Mod
Move the extracted mod folder into the following folder to make it available for Civ5:
For the Steam version:
~/Documents/Aspyr/Sid Meier's Civilization 5/MODS
For the AppStore version *:
~/Library/Containers/com.aspyr.civ5campaign/Data/Library/Application Support/Civilization V Campaign Edition/MODS
7. Activate the mod
Launch Civ5. You should now see the Mods menu option on the main screen. Click it, and you should see a list of the mods you have installed. Click a checkbox to activate a mod. Click Next. Click 'Single Player" to proceed to the modified game setup screens where you can choose the Mod options to play. Do NOT click Back, as you will not see the Mod options in the standard game setup screens.
* If you can't find ~/Library on your Mac, please see the Notes near the top of this post.
Attachments
Last edited: