LATEST RELEASE, VERSION 3.0 [2017-05-07] This package contains Windows command-line tools that can be used to work with zone files (*.czh_pc and *.czn_pc). This assumes you have some familiarity with the Windows command line. The SRZoneTool converts Saints Row zone files (".czh_pc" and ".czn_pc") to XML format which can be edited with any text editor, and then converts these XML files back into valid zone files. Zone files contain a large amount of data in a multitude of different formats. SRZoneTool converts all data to an XML format so it can be converted back to a zone file, but not all data is parsed. Unparsed data is converted to a list of bytes in hexadecimal. Parsed data is converted to easy-to-read named XML elements that can be easily edited. The following data is parsed by SRZoneTool: All fields in the zone header file (".czh_pc"). Object and Property fields in the zone data file (".czn_pc"). You can read about the data that is parsed in the "SR3 zone file format" thread written by Knobby from Volition. Why would you want to edit zone files? If you would like to change the location or orientation of an object on a map, you probably want to edit a zone file. What Saints Row games does this work with? Saints Row: The Third Saints Row IV Please Note: These tools do NOT work with Saints Row: Gat Out Of Hell. INSTALLATION Nothing needs to be installed. Just put the ".exe" files somewhere in your PATH and run them. TOOLS SRReadZone.exe Parses and displays the contents of a zone header file and the corresponding zone data file. Type the command with no parameters to display a usage message. SRZoneTool.exe Converts zone files to and from XML format. Type the command with no parameters to display a usage message. For more information about this tool, see the "SRZoneTool.html" document included in this package. SRZoneFinder.exe Finds zone files closest to a set of coordinates. Type the command with no parameters to display a usage message. SRPatchFile.exe Writes one or more bytes to specific locations in an existing file. Great for scripting! DOWNLOAD The executables are available in the package attached to this post. The source code and license is available in my GitHub repository at https://github.com/clarosa/SRZoneTools VERSION HISTORY 0.1 [2015-07-08] Initial release of SRReadZone tool. 0.2 [2015-07-09] Added "-n" normalize option to SRReadZone tool. 0.3 [2015-07-26] Initial release of SRZoneTool tool. 0.4 [2015-07-27] SRZoneTool now parses all known data structures. Can combine header and zone data in a single XML file. Full SR4 compatibility for all tools. 1.0 [2015-07-29] First official release. Updated XML format. Added SRReadZone.html document. 1.1 [2015-08-12] Added SRZoneFinder tool. 1.2 [2015-08-15] Added new command line options to SRZoneFinder tool. Reduced default verbosity in SRZoneTool. 1.3 [2015-09-16] Updated SRReadZone tool to parse zone file section type 0x2233 (crunched reference geometry) up to and including object coordinates. 2.0 [2015-09-27] Changes to SRZoneTool XML format (see details in readme.txt). Additional XML file validation. 2.1 [2016-10-17] Added "--position" and "--type" options to SRReadZone. 2.2 [2016-10-26] Added SRPatchFile tool. 2.3 [2016-12-18] Added object type names in SRReadZone and SRZoneTool. Changed all <description> elements to XML comments. 2.4 [2017-04-25] Added "audio_emitter" object type name in SRReadZone and ZRZoneTool. 2.5 [2017-05-01] Added the complete (?) list of object type names to SRReadZone and ZRZoneTool, contributed by Minimaul. 3.0 [2017-05-07] Updated SRZoneTool to parse and convert zone file section type 0x2233 (crunched reference geometry) up to and including object coordinates. Can still read XML files created by version 2.x. SEE ALSO If you'd like to learn more about Zone Files, here are some great links: Traffic and world zone questions - a detailed description of the various types of zone files and how they're used SR3 zone file format - lots of detail about the internal format of zone files Tutorial: How to Move a Nav Point THANK YOU I want to express my sincere appreciation to Knobby at Volition for all the wonderful help and information he's provided which allowed me to make this tool. If you have any questions/comments, I'd love to hear them!