Tools: Unit and Building Editors: Caligula & Hadrian

[GodsPetMonkey]

Presenting – Caligula, a unit editor for Rome: Total War, and Hadrian, a building editor for Rome: Total War!

Caligula
Current version (R:TW & R:TW-BI) - 0.6.0 - Download
0.5.x Legacy version (for RTW 1.2, no longer being updated) – 0.5.6 - Download
Hadrian
Current version – 0.4.6 - Download

You can always find the latest versions and news on these programs at;
https://forums.totalwar.org/vb/showthread.php?t=38858
http://www.twcenter.net/downloads/db...mods&cat_id=23

Caligula
Current version – 0.5.6
New in this version –
Bug fixes.

Guides –
Batch Processing (Currently out of date)
Adding New Units

Caligula is a program designed to assist in the creation, editing and deletion of units in various text files used by RTW. But rather then just try to put a prettier face on the already easy to mod files, Caligula is designed to make the process much faster with less repetitive work then otherwise would be possible.
Some examples of how Caligula tries to make things easier in the ability to import model names for using in the units (which tend to be long and annoying), automatic generation of the repetitive enum data, and batch processing of units, helping to make lots of small, similar changes much easier.

Hadrian
Current version – 0.4.6
New in this version –
Bug fixes

Guides –
Adding new buildings
Adding Units to Buildings

What Caligula is for units, Hadrian is for buildings.
I have also attempted to make jobs much easier with Hadrian, simplifying the way in which you can associate units to buildings, as well as easing enum and descriptions, which tie into the game UI.

Caligula v0.6.0

For R:TW and R:TW-BI

By - Samuel Roehr (aka GodsPetMonkey)
sroehr@gmail.com

You can always find the latest version, information and guides @ -
https://forums.totalwar.org/vb/showthread.php?t=38858
http://www.twcenter.net/downloads/db/?mod=245

ALWAYS BACKUP YOUR FILES! Caligula isn’t infallible, indeed, he's kind of unstable, so don’t come screaming if exiles your files to the neither regions of the empire!

Guides - Here are some guides to using Caligula.
http://www.users.on.net/~roehr/RTW/Guides/NewUnits.htm
http://www.users.on.net/~roehr/RTW/Guides/Batch.html

Information - You will need some VB6 runtimes in order to execute this program, at a guess, these would include
- MSCOMCTL.ocx - http://www.majorgeeks.com/files/mscomctl.zip
- COMDLG32.ocx - http://www.ascentive.com/support/new...b/COMDLG32.OCX
- msvbvm60.dll - http://www.microsoft.com/downloads/d...displaylang=en (thanks Soulflame!)

Put the OCX files you get into your /windows/system32 directory. the DLL is in a self installer. It will also work if you place the files in the same directory as caligula.exe

Caligula is a program that is designed to allow GUI editing of RTW's unit file. It also supports the unit model, enums and description files. Caligula is designed for both new and advanced users, and it can be easy to use the more advanced features and cause the game to stop working. Always be mindful of the hardcoded limits imposed by CA.

Batch Processing - One of the biggest weaknesses of the Caligula editor is how it can take forever to make a number of similar changes to many units, and due to the layout of the export_descr_unit.txt file, its hard to do using find/replace functions in common text editors.
To solve this issue, I have started to implement a "Batch Processing" feature in Caligula, and the first stage of this is now ready to be used!
It currently only supports mathematical operations (as they are the easiest to develop, being all very similar in operation, despite the large number of
attributes) but is powerful none the less, and very easy to use.
To use the Batch Processing facilities, just click on the "Batch" tab, select the category of units you wish to process, enter a search string (optional, if
an exact match of the string entered is found in the units "Type" attribute, it will then be processed), select the attribute you wish to modify from the
"Attribute" drop down box, select the effect you wish to apply (at this stage, all mathematical operations, Add, Subtract, Multiply, Divide and Equals, in
that order) and finally enter the amount by which you wish to affect the attribute using the effect. When that’s all done, press the "Process Button" and it
shall be so!
A few notes, and warnings. This feature is very much under constant development, so things may change at a later date, its also very dangerous to the
integrity of your export_descr_unit.txt file, Caligula wont stop you modifying attributes to ranges which cause havoc with RTW (no different to editing by
hand, but harder to visually confirm) a classic example here is increasing unit sizes beyond 60. On the other hand, it does fix up attributes with decimal
points that shouldn’t have them, rounding them off to the nearest whole number (several attributes support decimal figures, and this isn’t applied to these).

Revision History -
0.6.0 - Added BI support. BI only options are marked [BI]. These may cause non-BI games to crash if enabled!
Several minor bug fixes
Many minor interface changes

0.5.6 - Fixed up the interface somewhat

0.5.5 - More bug fixes

0.5.4 - Fixed several minor bugs

0.5.3 - Altered the workings of adding a new unit. Clicking the "Add New Unit" button now saves the data currently entered to the new unit. Clicking "Add blank Unit" performs the same action as the old "Add New Unit"
Greatly Expanded the Batch Processing search functionality

0.5.2 - Completely rewrote the batch processing, making it more efficient and much easier for me to maintain and add to it
Added the ability to search by "Class" (eg. light, missile) to Batch Processing. Its just a quick example showing where I plan to take this feature

0.5.1 - Fixed a crash with units that have 3 officers

0.5.0 - Added Batch Processing

0.4.1 - Improved file handling code dramatically

0.4.0 - Fixed up some minor bugs
Some interface changes
Added support for editing unit descriptions
Added unit enum generator
Fixed major bug with cancel button in open/save dialogs
Selecting 'ships' category now works properly
Added ability to import 'mounts', which populates the mounts dropdown box on the 'Unit Details' tab
Fixed up several attribute lists, should now have all of them (I hope!)

0.3.3 - Added several attributes that aren’t noted in the comments at the top of the unit file

0.3.2 - Several interface enhancements
Added "Add New Unit" button and functionality
Added "Remove Unit" button and functionality

0.3.1 - Enabled autocomplete-as-you-type for selected dropdown boxes
Added Unit Category drop down box, now you have to select a category of units, then select a unit from that category

0.3.0 - Added Model Data editing capabilities

0.2.2 - Added listing of all models into the "Soldier and "Officer"s dropdown boxes

0.2.1 - Fixed some minor interface issues

0.2.0 - First public release! Reads, edits and saves RTW Unit Files!

0.1.0 - Testing release, Full read functionality, limited write.

Hadrian v0.4.6

By - Samuel Roehr (aka GodsPetMonkey)
sroehr@gmail.com

You can always find the latest version, information and guides @ -
https://forums.totalwar.org/vb/showthread.php?t=38858
http://www.twcenter.net/downloads/db/?mod=244

ALWAYS BACKUP YOUR FILES!

Guides - Here are some guides to using Hadrian.
http://www.users.on.net/~roehr/RTW/G...drianGuide.htm
http://www.users.on.net/~roehr/RTW/G...obuildings.htm

Information - You will need some VB6 runtimes in order to execute this program, at a guess, these would include
- MSCOMCTL.ocx - http://www.majorgeeks.com/files/mscomctl.zip
- COMDLG32.ocx - http://www.ascentive.com/support/new...b/COMDLG32.OCX
- msvbvm60.dll - http://www.microsoft.com/downloads/d...displaylang=en (thanks Soulflame!)

Put the OCX files you get into your /windows/system32 directory. the DLL is in a self installer.


Hadrian is a program that is designed to allow GUI editing of RTW's building file. It also supports the enums and description files. Hadrian is designed for both new and advanced users, and it can be easy to use the more advanced features and cause the game to stop working. Always be mindful of the hardcoded limits imposed by CA.

Basic Guide - This guide will help you to enable a unit to be built by a certain structure. You must know the unit you want to use beforehand!
First, fire up Hadrian, then open your export_descr_buildings.txt file, then select the base building complex from the left most dropdown box at the top of the screen. Then select the particular iteration of the building to the right of that. Now select the capabilities tab.
If the building you selected can already build the unit, and you just want to enable it for a certain faction, select the unit from the "Units" dropdown box, and then add the faction by typing its name (or culture) in the editbox below the factions list box (note, you can remove the others by highlighting them and pressing the R button, if there are none in there, it will be enabled for all factions to be built) and press the A button, adding it to the list. Then press the E button below the "Units" drop box, then hit "Save Changes" and finally, press "Save" and select a file to save to. Your done, copy the file and rename appropriately.
If the unit has to be added to the building, proceed to fill out the relevant fields. Make sure you put 'recruit' (ALL lower case!!!) in the "Type" editbox and the "Name" editbox matches the 'type' entry from your export_descr_unit.txt file. When ready, press the A button, then hit "Save Changes" and finally, "Save". That’s it, make sure you copy the file and rename appropriately, and it should work. If the game CTDs, please make sure all your inputs where correct before contacting me about it.

Remember, if you don’t know what it does, leave it as it is!

Revision History -
0.4.6 - More bug fixes

0.4.5 - Minor bug fixes

0.4.4 - Fixed an issue with adding units to buildings with out any units prior

0.4.3 - Added ability to import a list of unit 'Names' (Types) from a export_descr_unit.txt file
Added "Cascade" button to the recruitment section of the building's capabilities. This button will copy the selected recruit into all buildings above this one (by level) it the same complex
Fixed up some bugs with adding building capabilities

0.4.2 - Fixed an issue where a units "Magic Number" wouldn't be displayed when selected in building capabilities
Renamed "Magic Number" to "Starting Experiance"

0.4.1 - Fixed issue with negative figures for bonuses
Increased file handling flexibility

0.4.0 - Fixed several interface issues
Fixed several minor bugs
Added ability to edit /text/export_buildings.txt
Added ability to automatically generate export_descr_buildings_enums.txt from /text/export_buildings.txt
Made some of the file handling more robust

0.3.2 - Fixed an issue that prevented Hadrian from reading the buildings file from RTR 3.0

0.3.1 - Fixed up some UI issues

0.3.0 - Added "Create New Complex" button and functionality
Added "Remove Complex" functionality
Added the ability to add a new building (level) to a complex by use of the "Levels:" listbox
Added the ability to remove a building (level) from a complex by use of the "Levels:" listbox
Many bugfixes

0.2.1 - Added autocomplete-as-you-type functionality for a limited number of dropdown boxes

0.2.0 - First public release! Reads, edits and saves RTW building Files!

0.1.0 - Testing release, Full read functionality.