Command line tool to access and extract data from SimCity 4 save files.
The latest stable release can be downloaded here
--info Basic info about the save game
--extract Extracts an Index Entry's data from the file using it's TGI or TypeId (formatted as "E86B1EEF E86B1EEF 286B1F03" or "E86B1EEF")
--list Lists all contents of the file
--list-records Lists all compressed records in the save game
--list-entries Lists all index entries (data) in the save game
--region-info Displays the contents of the region subfile
--logging Enables logging from the parsing library, useful for debugging
--json Outputs any results in a JSON encoded file
--do-not-decompress Does not decompress any extracted data
--help Displays this help message
Multiple commands can be specified at a time as long as a path to a SC4 save game is given.
# Displays the contents of the RegionView subfile of a city
SC4Extractor "City - Interpol.sc4" --region-info
# Displays the contents of the RegionView subfile in json format
SC4Extractor "City - Interpol.sc4" --region-info --json
# Lists all IndexEntries in the save game
SC4Extractor "City - Interpol.sc4" --list-entries
# Extracts data for the IndexEntry with the specific TypeGroupInstance
SC4Extractor "City - Interpol.sc4" --extract "A9DD6FF4 E98f9525 00000001"
# Extracts data for the IndexEntry with the specific TypeId, does not attempt to decompress the result
SC4Extractor "City - Interpol.sc4" "C9BD5D4A" --do-not-decompress
# Extract the data for multiple IndexEntries
SC4Extractor "City - Interpol.sc4" "E86B1EE,E86B1EEF,286B1F03" "CA027EDB CA027EE1 00000000" "C9BD5D4A"
# Multiple commands can be specified at a time
SC4Extractor "City - Interpol.sc4" --region-info --list-entries --list-records --info --extract "A9DD6FF4 E98f9525 00000001" "E86B1EE,E86B1EEF,286B1F03" "CA027EDB CA027EE1 00000000" "C9BD5D4A" "6A0F82B2" "49CC1BCD"
MIT License
Copyright (c) 2023 Matthew Carney