Supported
About This File
Mod Manager for SimCity 4 plugins.
This program handles the process of downloading and installing SimCity 4 plugins, including all their dependencies.
It helps you assemble a full Plugins folder very quickly, and also keeps your plugins up-to-date and organized.
Usage
- Prerequisites:
-
Download: Choose between
- the desktop application for Windows 10+,
- the desktop application for Linux, and
- the cross-platform web-app for other platforms.
-
Verify the checksum of the downloaded ZIP file against the checksums published on Github (optional).
-
Extract the contents of the downloaded ZIP file to any location of your choice.
-
At first launch of the application, it guides you through the initial setup: creating a new Profile and configuring the location of your Plugins folder.
-
Go to Find Packages to search and select packages to install (for example cyclone-boom:save-warning). There are already more than 5000 plugins with compatible metadata to choose from. Once satisfied, go to the Dashboard and hit Update to download and install the plugin files. Files are downloaded directly from Simtropolis or other sites like SC4Evermore, ToutSimCities, SimCityKurier (archived), Hide and Seek! (archived) and GitHub.
-
If you are signed in to Simtropolis, watch out for the “Install with sc4pac” button on the STEX. It appears for plugins that can be installed with sc4pac. Start small and gradually build up your Plugins folder. Don't download everything at once.
-
Install null-45:startup-performance-optimization-dll if you use the Windows digital edition of the game. (This adds support for plugin file paths exceeding the 260 character limit on Windows, which could otherwise be a problem for a small number of packages that use deeply-nested, long file names.)
-
Install memo:lua-sandbox-dll if you use the Windows digital edition of the game. (This provides a more secure environment for your plugins by preventing mods from using unsafe Lua functions.)
-
Be aware that Simtropolis has a download limit of 20 files per day for guests. To avoid this limit, go to Settings and set up your personal authentication token for Simtropolis (step-by-step guide). Alternatively, simply continue the installation process the next day.
Plugins folder structure
050-load-first 060-config 075-my-plugins (your existing manually installed plugins) 100-props-textures 110-resources 140-ordinances 150-mods 170-terrain 180-flora 200-residential 300-commercial 360-landmark 400-industrial 500-utilities 600-civics 610-safety 620-education 630-health 640-government 650-religion 660-parks 700-transit 710-automata 770-network-addon-mod 895-my-overrides (your manually installed zzz-folders) 900-overrides
Packages are installed into subfolders prefixed by an even number, as the order in which files are loaded by the game is important. This ensures a consistent load order. Files you install manually should be put into subfolders prefixed by an odd number (ideally before 900-overrides).
Migrating an existing Plugins folder
If you already have a non-empty Plugins folder and want to switch to sc4pac, start by moving the bulk of your manually installed files into a new subfolder 075-my-plugins and your zzz-folders into 895-my-overrides to ensure correct load order. Once you install more and more packages and dependencies with sc4pac, delete the corresponding older, redundant, manually installed files to avoid duplication or version conflicts. If a dependency was installed with sc4pac, there is no need to keep older manually installed copies of it.
In the long run, create additional odd-numbered subfolders for better organization of your manually installed files and to fine-tune load order.
Managing multiple Plugins folders
The sc4pac GUI supports creating multiple Profiles. For example, you could use a unique Profile for each of your Regions. Each Profile corresponds to a Plugins folder.
Important: Make sure to select distinct locations for all your Plugins folders to avoid interference between Profiles.
You can use the SC4 launch parameter -UserDir:"..." to start the game with a custom location for the Plugins folder.
Uninstalling
- Uninstall all packages for each Profile (see Dashboard → Profile → Delete options).
- Delete the download cache folder (see Dashboard).
- Remove the profiles configuration folder (see Settings).
- Finally, delete the folder containing the sc4pac program files.
Documentation
Visit the Troubleshooting & FAQ section of the sc4pac Website for more information, or the development & support thread.
To make your own uploads installable with sc4pac, see the topic about the sc4pac STEX integration.
Credits
A big thank you for contributions to sc4pac: @smf_16 @nos.17 @Zasco @Flann @Shadow Assassin @Cyclone Boom @CorinaMarie @Null 45 @Ulisse Wolf @timdmackey.
What's New 1.6.0 View Changelog
Released
Changes since version 1.4.3
- This release introduces a 2-column split-view layout.
- Improved detection of download failures when a server is down for maintenance. If you still experience the "extraction failed" error, either "Redownload & Reinstall" the affected package, or delete the affected file from the cache folder.
-
Packages with INI configuration files now install the INI files into the root of the Plugins folder, but named as
_sc4pacnew.ini. To activate the INI files, rename them by removing_sc4pacnewfrom their name. - Added a button to open the Plugins folder to show the installed files of a package.
- Fixed an issue that prevented installing DLLs on Windows.
- Whenever plugins containing Lua scripts are about to be installed, sc4pac now shows an optional warning about this. For added security, install memo:lua-sandbox-dll.
- Fixed a Windows issue launching the app from a folder containing special characters.
- When creating a new Profile, the default Plugins folder location is not preselected anymore.
Upgrading from previous versions:
Simply extract the ZIP file. You can remove the previous application files in favor of the newly extracted files.
-
44
-
2
-
10
