Info:
Not every patch will result in a updated here. Please refer the ReadMe.txt for up to date updates.
What for is this tool:
If you want to edit your Total War savegame file with EditSF, it's a kind of time intensive to find certain entries in their ARRAY container you want to edit. This tool displays various tables with array numbers and additional information that helps you to identify the wanted array.
Meanwhile this tool has extended to a little editor.
Windows 7 and Windows 8 Version
Current Version: 1.5.4.1
Requirement: .NET Framework 4.5
Download at: Sourceforge
Windows XP Version
Current Version: 1.5.3.3 *
Requirement: .NET Framework
Download at: Sourceforge
(*) Updates will deployed only on request.
Data Pack Database
Description: data_rome2.pack/db as Microsoft SQL Server 2012 Database (LocalDB)
Rome2 Patch: 1.14.1
Download at: Sourceforge
It would be nice giving me reputation, if you think this tool is somehow useful.
- If Rome2 is mentioned then the base game "Rome 2" and extensions "Caesar in Gaul" and "Hannibal at the Gates" are also meant.
- If Shogun2 is mentioned then the base game "Shogun 2" and extensions "Rise of the Samurai" and "Fall of the Samurai" are also meant.
- This tool works for all versions of the supported games.
- Suggestions for further features are welcomed.
Warnings
- There are some basic plausibility checks implemented in this tool, but if entered unreasonable values e.g. rankings higher than 9, combobox entries which are not in list, movement points in million's range or unit max size in thousands, I do not assume responsibility.
- If preforming actions (like set movement points and change unit strength) that modify many values, the saving of the savegame may last longer. Depends on the computer specification of course.
- By installing a new version of this tool, your SaveParser.ini will be overwritten.
Supported Total War games and selectable tables
- Rome 2 (tables: character, faction, region, province, army, diplomacy, unit)
- Shogun 2 (tables: character, faction, region)
- Napoleon (tables: character, faction, region)
- Empire (tables: character, faction, region)
Installation
- simply unzip the downloaded zip file in any folder you want.
- open the SaveParser.ini file with an editor:
- modify the paths for EditSF and PFM. No value means the tool is in the same directory as SaveParser. Be sure not to add // at the end of the path values.
- modify the path for the table export. Be sure not to add // at the end of the path values.
- add your Rome 2 game installation directory behind the "gamePath_R2" entry. If you do not own Rome 2, leave it empty behind the equal-sign.
- add your Napoleon game installation directory behind the "gamePath_N" entry. If you do not own Napoleon, leave it empty behind the equal-sign.
- add your Empire game installation directory behind the "gamePath_E" entry. If you do not own Empire, leave it empty behind the equal-sign.
- modify the table columns options as needed. Detailed info in the Saveparser.ini itself.
- the libaries EsfLibrary.dll, Filetypes.dll, Common.dll and 7Zip.dll are the same as those from PFM. The newer creation date results from my compiling.
- Info: Neither any file will be copied to somewhere else except the installation directory nor any registry entries will be set.
Features
- parsing Savegame files for various tables (see above)
- ability to change directly in following tables:
- character:
- rank (Rome2 and Shogun2)
- skillPoints (Rome2 and Shogun2)
- subterfuge (Rome2)
- zeal (Rome2)
- authority (Rome2)
- ambition (Rome2)
- gravitas (Rome2)
- birthYear (Rome2 and Shogun2)
- faction:
- army: (Rome2 only)
- diplomacy: (Rome2 only)
- stance (allowed values: "neutral", "war", "defensive_allies", "military_allies")
- known (allowed values: "True" and "False", case sensivite)
- unit: (Rome2 only)
- Edit panel (Rome2 only)
- replenish or reduce armies (including garrisons) for a faction
- complete running (must run at least for one turn) research projects for a faction
- "add all projects" function adds all technologies as research projects to the faction. Their invested research points will be set to 9000. Since all technolgies (even non-faction adequate, already running and already reseached) will be added, the loading of the savegame may last longer, because the game will remove invalid projects. After the loading many projects (but not all) will be randomly immediately finished. Then after each "end turn" another project will be finished. Hint: to have more projects completed load the modified savegame in the game, save it and reload it.
- set movememt points for all characters' and armies' (units) of a faction for the present turn
- money distribution: see tooltip for "Distribute" button for details.
- mass birth year changing of all non-colonel characters of a faction.
- finish all constructions of a region's settlements
- re-enable politics for player faction, which is disabled after civil war.
- remove all 'famous battle' markers from campaign map.
Usage
- double click SaveParser.exe
- click in menu 'file' the menu item 'open savegame'
- select the savegame file you want to parse
- wait till the savegame file is loaded. The 'parse' button will be enabled if the savegame file is loaded
- enter the facton array index of the faction the data shall be displayed or click the button "Faction Array Index:"
- press the button 'parse'
Known issues
- for Napoleon and Empire historical names' keys will not be translated in the character table.
- saving can last rather long (up to 2 minutes), if game is quite advanced.
Result description for tables
character
Column Name |
Description |
faction |
array number of faction |
factionName |
faction name |
arrayIndex |
array number -> character is located in "CHARACTER_ARRAY [Array]" |
type |
character type (for Rome2 only non-colonel-type characters will be displayed) |
name |
name of character |
rank |
0-based, means: 0 = rank 1, 1 = rank 2 ... (editable for Rome2 and Shogun2) |
traitPoints |
traitsPoints that still can be placed (editable for Rome2 and Shogun2) |
subterfuge |
subterfuge value (editable for Rome2) |
zeal |
zeal value (editable for Rome2) |
ambition |
ambition value (editable for Rome2) |
gravitas |
gravitas value (editable for Rome2) |
authority |
authority value (editable for Rome2) |
birthDate |
not the game year, the pure value (editable) |
age |
age of character |
id |
character id |
skills |
list of skills |
traits |
list of traits |
Filter (Rome2): all, generals, agents, spies, champions, dignitaries
Controls:
- by double clicking a data row a Character Editor dialog opens (Rome2 only).
army (Rome2 only)
Column Name |
Description |
faction |
array number of faction |
arrayIndex |
array number -> army is located in "ARMY_ARRAY - [Array]" |
type |
type (army or navy) |
name |
name (generic or user defined) |
rank |
0-based, means: 0 = rank 1, 1 = rank 2 ... (editable for Rome2) |
traitPoints |
traitsPoints that still can be placed (editable for Rome2) |
units |
amount of units (double clicking this cell loads the unit table with faction index and army index as parameter) |
strength |
strength percentage of army |
commander |
name of the commander (double clicking this cell opens Character Editor dialog) |
Filter: armies, armies and garrisons
Controls:
- by double clicking the columns 'commander' or 'commanderID' the Character Editor dialog opens with the data of the commander (Rome2 only).
- by double clicking the column 'units' loads the unit table with the parameters faction and army of the selected row (Rome2 only).
faction
Column Name |
Description |
arrayIndex |
array number -> faction is located in "FACTION_ARRAY - [Array]" |
name |
internal name of faction |
id |
id of faction |
name |
internal name |
money |
money of faction |
armies |
amount of armies (armies and navies) (Rome2 only) |
units |
amount of units (Rome2 only) |
projects |
amount of researched projects (Rome2 only) |
project |
current project (Rome2 only) |
balance |
income minus upkeep (Rome2 only) |
Filter: all, only active, destroyed (Rome2 only)
diplomacy (Rome2 only)
Column Name |
Description |
arrayIndex |
array number -> diplomacy is located in "DIPLOMACY_RELATIONSHIPS_ARRAY - [ARRAY]" |
id |
id of faction |
name |
internal name of faction |
stance |
diplomatic stance (editable). if edited, the entry of the partner faction will be changed also. Allowed values: "neutral", "war", "defensive_allies", "military_allies" |
known |
determinates whether the faction is contactable (editable) |
Filter: all, only active
unit (Rome2 only)
Column Name |
Description |
faction |
array number of faction |
army |
array number of army |
arrayIndex |
array number of unit |
name |
internal unit name |
rank |
rank of unit (editable, max = 9) |
exp |
exp (%) of unit |
max |
max men of unit (editable) |
strength |
actual amount of men (editable) |
Filter: armies, armies and garrisons
region
Column Name |
Description |
arrayIndex |
array number of region |
name |
internal region name |
garrisonArmyId |
id of army that is used as this region's garrison (Rome2 only) |
controller |
name of faction that controlls this region (Rome2 only) |
Controls:
- by double clicking a data row a Region Editor dialog opens (Rome2 only).
province
Column Name |
Description |
arrayIndex |
array number of province |
name |
internal province name |
Controls:
- by double clicking a data row a Province Editor dialog opens (Rome2 only).
Description for Character Editor Dialog:
- Only background skill can be edited. If Skill 0 is not a background skill, the combobox is disabled.
- At opening the dialog the displayed subkey is not necessarily the proper subkey, but it represents the proper interal value.
- If you change the background skill (Skill 0), you must select a subkey which fits best to the faction of the editing character. The initially selected subkey may not be proper subkey.
- If you select a wrong subkey the game won't crash, but the background skill will be removed by the game.
- To remove an existing trait, select the first entry in the listbox named "(remove)"
Savegames tested at WinXP(SP2) and Win7(SP1) for all games (and many hours of game play at Rome2).
Since version 1.5.0.0, this tool will not run anymore at WinXP (.NET 4.0)
Credits
- A lot of thanks to Daniu for creating EditSF.
- A lot of thanks to lampuiho for providing the sample source for the accessing the game pack file.
Planned features
- Army editor dialog
- Unit editor dialog
- effect descriptions in Character Editor Dialog
- same functionality for Shogun2 as for Rome2
Bug Reporting
If reporting a bug please, check whether the version of the tool you are using is the lastest. If the error is still occuring, answering following questions would be useful:
- which version is displayed in menu "Info" and Win7- or XP-Version?
- which game is selected in the menu "Game"?
- which table is selected in the combobox "Display table:"?
- which file mode is selected: savegame or startpos?
- which action was performed (load, save, parse...)?
- which "Faction Array Index" is selected?
- game using mods that created the savegame? *
- savegame is modified with other tools before? *
(*) if yes, providing the savegame helps a lot.
Verions Log
1.5.4.1
- Character Editor dialog: one more trait slot added (request by nightowl)
1.5.4.0
- army table: by double clicking the columns 'commander' or 'commanderID' the Character Editor dialog opens with the data of the commander
- army table: by double clicking the column 'units' loads the unit table with the parameters faction and army of the selected row
- army table: columns 'commanderID' and 'id' are configurable
1.5.3.5
- character table: coloured rows for each character types (Rome2 only)
- SaveParser.ini: added faction.balance.display option added (setting to 'false' reduces parsing time for faction table slightly)
- Workaround for Rome2 Patch 2.0.0: by the game generated savegame can contain invalid entries (some or all) for ECONOMIC_FACTION history
- some filter renaming
- Fix: selected table and default value of Faction Array Index
1.5.3.4
- Savegames containing characters with more than 10 skills can be loaded, but only the first 10 will be displayed.
- Character Editor dialog: gravitas max value increased to 9999.
1.5.3.3
- table character (Rome2 only): family and portrait added and skills / background switch, their display options are configurable in SaveParser.ini.
- table army: commander name added
- menu item "edit config file" opens the file "SaveParser.ini" in the default editor.
- new SaveParser.ini entries (need to be set)
1.5.3.2
- Character Editor dialog: menu item "culture and order specific" added. If selected, only culture specific names will be offered in the names' comboboxes and splitted to their slots (forename, family-, clan-name, other). The menu item must be checked every time the dialog is opened again.
- Region Editor dialog: controller added
- schema_R2TW.xml modified
1.5.3.1
- region table for Rome2 contains controlling faction
- "Faction Array Index" button enabled for Rome2 -> displays the region that selected faction controls
1.5.3.0
- introduced "Region Editor" dialog for Rome2. Ability to change building turns already done
- "Edit" panel: finish all constructions of a region's settlements
1.5.2.4
- Fix: Rome2 (v2.0.0) can have broken entries for economic history (history - [X] / ECONOMICS_DATA ). Also EditSF has problems there. Those will be catched now, if no valid entry can be found, balance is displayed as "-999999";
- Fix: faction table filter removed for non-Rome2 games
1.5.2.3
- Bugfix: displaying tables if not having Rome2 installed
- removed unused columns in table faction for non-Rome2 games
1.5.2.2
- Startpos support for Rome2, Napoleon and Empire introduced. Switch in "File" menu.
- SaveParser.ini: path separator // changed to /
- Bugfix: export current table.
1.5.2.1
- Character Editor dialog: family introduced
- Bugfix: Character Editor dialog could not be opened if gravitas value higher than 250. New maximum value 1000.
- Bugfix: Shogun2 loading non-compressed savegames
- Bugfix: now proper faction names displayed if editing startpos.esf
1.5.2.0
- introduced "Province Editor" dialog for Rome2
1.5.1.3
- introduced "Reset agent action" in "Edit" panel. This funcation reset the ability to perform actions for all player's factions' agents. (Request by kurushimi0)
1.5.1.2
- Bugfix: Adding more than one new trait to a character resulted an error in the savegame.
1.5.1.1
- internal gender filter for character names comboboxes in Character Editor dialog.
- army table: generic army / navy names translated (but not all. e.g. Roman)
- added checkbox "Rebels" to groupbox "Money Distribution" in panel "Edit"
1.5.1.0
- introduced export table function -> new entry "exportPath" in SaveParser.ini must be modified.
- Rome2 faction table "projects", "project" and "balance" added.
- the default value for "Birth Year" in the panel "Edit" is set to game year minus 20.
1.5.0.7
- Fix for "add all projects", already reseached projects could be set to un-researched.
1.5.0.6
- re-implemented birth year in tab "Edit"
- SaveParser.ini plausibilites
1.5.0.5
- Fix in Data_Names.txt (historical names still missing for Napoleon and Empire)
1.5.0.4
- Fix for Shogun2, Napoleon and Empire
1.5.0.3
- Fix for application crash at character table parsing. Caused by character names' key(s) in the savegame which are not anymore included in local_en_rome2.pack and local_en.pack.
1.5.0.2
- more accurate interal filter for subkey background skills in Character Editor dialog (requested by magraev)
- Interal DB Stats Window. (difference at amount of entries between Table.CharacterName and Dic.CharacterName is reasoned because "Empire" and "Napoleon" are using name key and values)
1.5.0.1
- Bugfix: Add-Technologies fixed.
- Bugfix: only background skills will be offered in the combobox in the Character Editor
- Bugfix: Faction dialog not editable anymore
1.5.0.0
- using now game pack files for Rome2 instead of the Data_XXX.txt files - except a by Rome2 names reduced "Data_Name.txt", this will be still used for the other non-Rome2 games.
- introduced threshold fields for traits in Character Editor dialog
- Filetypes.dll and Common.dll from PFM added
- new entry in SaveParser.ini (see Installation section)
- some performance optimization
- WinXP not anymore supported.
1.4.5.3
- Data_Technolgies.txt modified.
- Data_Ancillaries.txt modified.
1.4.5.2
- changed behaviour of "Faction Array Index" button. Now it displays a combobox to select a faction by name.
- hourglass cursor for time-consuming processes (load and save savegame)
1.4.5.1
- introduced the buttons "Faction Array Index" in the "Parser" panel and "Faction(s)" in the "Edit" panel. Those buttons open a window with factionArrayIndex and factionName as help to identfy the factionArrayIndex you need to enter for table parsing. Before it was needed to parse the more time-consuming faction table to get this info.
- scrollbars in "Character Editor" window (request from nightowl)
- some minor process fixes.
1.4.5.0
- add all research projects to a faction (Rome2 only). Read tooltip over button or this file's "Edit panel" section.
- bugfix for complete research (only for first started research project spent point had been set to 9000)
- added some tooltip infos
- some typo corrections
1.4.4.0
- Introduced custom command in menu "Tools\open data file" and SaveParser.ini
- Introduced 'money distribution' functions
- Introduced ability to re-enable politics for player faction in 'Edit' panel
- Introduced function to remove all 'famous battle' markers from campaign map
1.4.3.4
- Bugfix in Character Editor Dialog: no background error
1.4.3.3
- Bugfix in Character Editor Dialog: SkillPoints (bug was in 14.3.2)
1.4.3.2
- Data_Portraits.txt added
- Character Editor Dialog: modifed value for birthYear recalculates age immediately
- Character Editor Dialog: age can be entered directly
- Character Editor Dialog: tooltips for editable controls with original values
- Character Editor Dialog: NumericUpDown for value inputs for better plausibility checks
- Data_Names.txt entries sorted (some names seems to double but the internal key value is different)
1.4.3.1
- Bugfix: character table direct edit for birthYear, ambition and gravitas for Rome2
- Data_Names.txt new names added
- SaveParser.ini introduced for setting tool paths (EditSF and PFM)
- Character Editor Dialog layout redesigned
- all data files to view in standard editor
1.4.3.0
- remove and add new traits in Character Editor Dialog
1.4.2.4
- Bugfixes for: gravitas, gender (which also affects the correct traits display in Character Editor Dialog)
1.4.2.3
- ambition and gravitas added to Character Edit Dialog and character table (request from tomice)
1.4.2.2
- internal filters for ancillary and wife-ancillary set in Character Editor Dialog
- internal filter for female or male characters set in Character Editor Dialog
1.4.2.1
- wife editable in Character Edit Dialog
- Bugfix: Sometimes as ancillary the character's wife could be displayed in Character Editor Dialog
- Disabling empty trait and ancillary comboboxes in Character Edit Dialog
1.4.2.0
- traits editable in Character Edit Dialog
- ancillary editable in Character Edit Dialog
- file Data_Traits.txt added to tool package
- file Data_Ancillaries.txt added to tool package
1.4.1.2
- column "known" introduced into table diplomacy (request from kurushimi0)
1.4.1.1
- Bugfixes: Character Editor Dialog: reopening dialog with edited character and not saving the background skill.
- added column age in table character
- character editor dialog amplified
1.4.1.0
- character editor dialog amplified (general data, background skill). Please read section "Description for Character Editor Dialog".
- Data_Skill.txt content reduced
- traitPoints renamed to skillPoints
- some bug fixes (MenuItems)
1.4.0.0
- Character editor dialog introduced, so far only existing name entries can be edited. (Rome2 only)
- Names.txt renamed to Data_Names.txt. Old Names.txt file can be deleted.
1.3.13.4
- added field garrisonArmyId to table region (Rome2 only)
- new Names.txt file with new entries for "Hannibal at the Gates"
1.3.13.3
- filter for table army added (Rome2)
- filter for table unit added (Rome2)
1.3.13.2
- all table columns are sortable (MyLibary.dll)
1.3.13.1
- in Edit panel multiple faction array index entires separated by semicolons are allowed. -1 for all is not valid.
- filter extended for table faction (Rome2)
- renamed saved filename appendix to "_SP" for "save savegame"
- inserted menuitem "save savegame as" in menu "File"
- inserted menuitem "open name file" in menu "Tools"
1.3.13.0
- in Edit panel for Rome2 added set movement points function
1.3.12.0
- introduced filter combox, see tables
- removed "active only faction" checkbox
1.3.11.1
- table unit rank, max and strength editable
1.3.11.0
- table diplomacy allowed stance values extended: "neutral", "war", "defensive_allies", "military_allies"
- removed debug window
1.3.10.3
- bug fix in parsing diplomacy table
1.3.10.2
- enabled checkbox "only active factions" also for table diplomacy
- new menu for tools (EditSF) (see "Installation")
- several code optimizations
1.3.10.1:
- fixed table diplomacy: enable input field "faction array index"
1.3.10.0:
- added table unit
- added function to complete running research projects of a faction (Rome2 only so far)
- added traits in table character (Rome2 and Shogun2 only)
- renamed level to rank
1.3.9.2:
- filter option for table faction for destroyed factions
- moved info text for faction number input to tooltip
- some renamings
1.3.9.1:
- in table faction armies and units added. (Rome2 only)
1.3.9.0:
- table diplomacy added for Rome2. In this table the stances of the factions between each other can be edited.
- plausibility check for faction ID input
- in faction table field id added
1.3.8.2:
- in character table field skills added for Rome2 and Shogun2
1.3.8.1:
- in army table field strength added for Rome2
1.3.8.0:
- in army table level and traitPoints are directly editable for Rome2
- removed garrison armies and navies from army table (Rome2)
1.3.7.0:
- in faction table money is directly editable
- in character table subterfuge, zeal and authority are directly editable for Rome2
- game specific character table (only columns are displayed which are also used in game)
- fixed bug for displaying multiple 'Edit' panels
1.3.6.0:
- in character table level and traitPoints are directly editable for Rome2 and Shogun2
- in Edit panel for Rome2 added reduce unit strength function
- error fixed when editing characters if all factions' characters are displayed in table
1.3.5.0:
- added amount of units to table army to Rome2
- shortened unit name
1.3.4.0:
- added table army to Rome2
- game tag displayed at GUI
1.3.3.3:
- added table region to all games
1.3.3.2:
- added tables region and provinces for Rome2
- added table region for Shogun2
1.3.3.1:
- added more GUI plausibilites
- editable columns' header font colour set to blue
1.3.3.0:
- BirthYear editable in parsing result table.
- moved 'save savegame' to 'File' menu
- removed change BirthYear ability at 'Edit' panel