Click 'New' in the small window that has popped up and browse to your mod's directory, click 'OK'
Select the now present mod in the list window and press 'Load'
A small DOS window will appear and inform you if some required files are missing
Add any files missing and repeat the above steps number 2 and 4
Once it has stopped scrolling (without file missing errors) you can access the EDU and modelDB details in their respective tabs (File, Model) in the application's window.
Required: .Net v2.0 or better (you should have it if you have kingdoms installed).
Usage:
Unpack and run. Point at your mod folder (not the data folder).
The "vanillas" folder should always accompany the .exe (lazy gracul).
Description:
This tool is a complete EDU+BMDB editor, allowing easy creation/modification of units in MTW2.
It's mostly allows for a fast double-single click editing of things that are hard to maintain.
Also, includes a module to import unit models from other mods, without having to copy the files by hand.
There are two parts to this thing - the log and the gui.
In the log you'll be able to find any serious errors that might be inside your files.
The GUI mode uses colour-coding, in order to draw modders attention.
Things marked as lightred are either misspelled properties or file paths that dont exist.
Things marked as light-orange are paths that work as they are found in vanillas packs.
You'll also have two options of saving the files - sorted or unsorted.
Sorted EDU means spitting out an edu file with units categorized.
Sorted BMDB will be cleared of any unused models - be it whole models or only the unused faction entries.
This tool will not overwrite any of your files! However the files should be up and ready for a rename & copy.
For those that like to look at the tool before they download it [and a small tutorial]:
Spoiler for images:
In work:
dds preview so you can actually look what kind of texture you have.
unit import, so you can import whole units in a matter of a couple clicks.
Check the spoiler to see what can be threw out in the log.
HAVE FUN!
Spoiler Alert, click show to read:
Modeldb stuff:
[Info] Model '%i %s' is never used.
Simple as that, the model is never referenced in any files, in any form.
[Info] Model '%i %s' does not need the texture entries for faction '%s' (or merc).
Same as above, only now the model and some of its factions are used.
[Error] Model '%i %s' uses an unknown skeleton type '%s'.
The skeleton which is attached to the model cannot be found in descr_skeleton, or your file is messed up so the parser reads something else as the skeleton.
High-priority error, if indeed the parser reports a fancy string then requires fixing before you can proceed.
[Info] Model '%i %s' has a duplicated faction entry in the (figure/attachment) textures.
In this case the latter entry will be used.
[Info] Model '%i %s' has different faction entries in the figure and attachment texture sections. Figure textures include faction '%s'.
Your model has for example. defined france only as the figure entry and milan as the attachment. Both shall be omitted.
EDU stuff:
[Error] Unit '%s'[%THE LINE WHICH CAUSED THE ERROR%] uses an unknown model '%s'.
Pretty straight forward. The name in brackets will tell you if its the soldier, armour_ug_models or officer line.
[Warning] Unit '%s'[%THE LINE WHICH CAUSED THE ERROR% & %THE ERA/OWNERSHIP%] is owned by faction x without texture entries in model x.
Getting deeper, now we check all the ownerships and era ownerships vs the models. Seems we have a silver surfer as we dont have an entry.
[Warning] Unit '%s'[%s&%s] is a mercenary without the 'merc' texture entries in model '%s' (export_descr_units or battle_models).
We have a silver-surfer merc. Note, that if the unit is build-able by a faction on the campaign map it is still using the merc entries for the textures, so any additional faction entries beside the merc ones are actually redundant and will be omitted.
[Error] Unit '%s'[%the variable we were searching for%] insufficient number of variables (line no. %exact line of error occurrence%).
[Error] Unit '%s'[%s], too many variables (line no. %i).
[Error] Unit '%s'[%s], insufficient number of variables (line no. %i).
Self-explanatory.
[Error] Unit '%s' has an uncomplete or messed up definition. Omitting this unit from the rest of the checks (line no. %i).
Meaning we have messed up the edu structure for the unit x, with the line of error occurrence.
[Error] Unit '%s'[x], has too many definitions (line no. %i).
Meaning we have too many "era" "officer" or "banner" definitions. Or we define the same era twice.
[Error] Unit '%s'[%s&%s] has different count levels in the armour definitions (line no. %i).
We have a unit with different levels of armour upg in the models and levels line.
[Error] Unit '%s' beyond edu limit of 500 units.
Self-explanatory.
[Info] Unit '%s' uses different models as the first upgrade and the soldier line.
In this case, the default upgrade takes priority over the soldier models for the engine, so the unit is displayed correctly (if the first upgrade is ok that is). Still, this is undesired.
[Error] Unit '%s'[mount] requests an unknown mount '%s' (descr_mount or export_descr_unit).
[Error] Unit '%s'[ship] requests an unknown ship type '%s' (export_descr_unit or descr_ship).
[Error] Unit '%s'[engine] requests an unknown engine type '%s' (export_descr_unit or descr_engine).
[Error] Unit '%s'[stat_pri] requests an unknown projectile '%s' (export_descr_unit or descr_projectile).
Self-explanatory.
[Error] Unit '%s'[%s] is owned by an unrecognized faction/culture '%s' (export_descr_unit or descr_sm_factions).
Self-explanatory, probably typos.
[Info] Unit '%s'[%s] uses the 'all' ownership while still having defined individual factions (export_descr_unit).
[Info] Unit '%s'[%s] is owned more then once by faction '%s' (export_descr_unit).
[Info] Unit '%s'[%s] is owned more then once by faction '%s' due to inheritance from culture '%s' (export_descr_unit).
[Info] Unit '%s'[%s] is owned by all the factions from the '%s' culture. Consider switching to the use of a culture definition (export_descr_unit or descr_sm_factions).
[Info] Unit '%s'[%s] is owned by every faction. Consider using 'all' (export_descr_unit).
Self-explanatory
EDB:
[Info] Unit '%s'[edb line. %i] can be recruited by 'all' while still having defined individual factions (export_descr_unit).
[Error] Unit '%s'[edb line. %i] can be recruited by an unrecognized faction/culture '%s' (export_descr_unit or descr_sm_factions).
Perhaps typo, better check.
[Info] Unit '%s'[edb line. %i] can be recruited more then once by faction '%s' (export_descr_unit).
[Info] Unit '%s'[edb line. %i] can be recruited more then once by faction '%s' due to inheritance from culture '%s' (export_descr_unit).
[Info] Unit '%s'[edb line. %i] can be recruited by all the factions from the '%s' culture. Consider switching to the use of a culture definition (export_descr_unit or descr_sm_factions).
[Info] Unit '%s'[edb line. %i] can be recruited by every faction. Consider using 'all' (export_descr_unit).
[Info] Unit '%s' can't be recruited anywhere and is not a mercenary (export_descr_buildings).
Self-explanatory.
[Warning] Unit '%s'[edb line. %i] can be recruited by faction '%s' without an ownership (export_descr_buildings or export_descr_unit).
The engine will not let us recruit an unit like this.
Other:
[Error] Mount '%s' has no entry in the battle_models.modeldb file.
We have defined a mount in the descr_mount but don't have an entry for it.
[Error] Faction '%s' uses an unknown culture '%s' (descr_sm_factions or descr_culture).
Perhaps a typo?
[Info] Culture '%s' seems to be abandoned (descr_culture).
Meaning we never reference any faction or the culture itself in the unit files.
[Error] Faction '%s' does not have an accent specified (descr_accent).
Self-explanatory.
[Error] Accent '%s' unrecognized faction '%s' (descr_accent or descr_sm_factions).
Self-explanatory.
[Warning] Character '%s' is owned by faction '%s' without a texture entries in model '%s'.
A stratmap linked char does not have the appropriate texture entries.
[Warning] Character '%s' does not have the texture entries for the slave faction. Every character should have this entry in case of a rebel spawn.
Self-explanatory.
[Warning] Unit '%s' does not have a response on the battlemap for faction '%s'->accent '%s' with voice type '%s'.
Our unit does not have a 'confirmation' voice defined in export_descr_sounds_units_voice. This is the voice "SSStradiots!" when you select a stradiots units etc.
[Warning] Unit '%s'[accent] uses an unknown accent '%s' (export_descr_units or export_descr_sounds_units_voice).
[Warning] Unit '%s'[class] uses a class tag '%s' not yet having any voices. Consider adding a voice_type line to use an existing voice_type (export_descr_units or export_descr_sounds_units_voice).
[Warning] Unit '%s' uses an unknown voice type '%s' (export_descr_units or export_descr_sounds_units_voice).
Self-explanatory.
[Info] Opening default %s
Cannot find the file in your mod dir, the one from vanilla folder shall be used.
[Info] Printing out additional data for easy export_descr_sounds_units_voice debugging in edsuv.txt.
If any voice errors are detected, the edsuv file will hold an easy to use list of units with voices. Excellent for a quick-fix.
Hello, nice tool. It doesn't work for all my mods, but it does work for some!
I have a problem. The editior saves files in different names than the actual files.. While i do know what edu and eu stands for, i don't know what the words for attrib, edsuv and voice are?
Export_descr_unit = EDU.. But the others i don't know?
Last edited by Mr_Nygren; April 17, 2016 at 01:31 PM.
Be your friend's, true friend. Return gift for gift. Repay laughter, with laughter again
but betrayal with treachery.
Last edited by Kilgore Trout; April 17, 2016 at 02:58 PM.
Roland searched the continent for the man who'd done him in
He found him in Mombasa in a barroom drinking gin
Roland aimed his Thompson gun - he didn't say a word
But he blew Van Owen's body from there to Johannesburg
edsuv - export_descr_sounds_units_voice, it's a summary of that file that the editor uses for reference (I think)
voice - lists problems with voices (missing sound entries)
attrib - not sure as I never had an entry in there
edsuv - export_descr_sounds_units_voice, it's a summary of that file that the editor uses for reference (I think)
voice - lists problems with voices (missing sound entries)
attrib - not sure as I never had an entry in there
None of the above are game files.
Okey thank you for the information.
I prefer the old school method when transfering units. But this tool is very useful for adding attributes, text and pictures.
I tried adding units but got more problems than the old method gave me. I hate filling in everything myself. So i prefer to copy and paste.
Be your friend's, true friend. Return gift for gift. Repay laughter, with laughter again
but betrayal with treachery.
I found this tool very useful for cleaning up unused files in my mod before uploading, considering that a unit_model folder can contain more then half of the mod's files size wise. Sorting of the EDU entries comes very handy, too.
I found this tool very useful for cleaning up unused files in my mod before uploading, considering that a unit_model folder can contain more then half of the mod's files size wise. Sorting of the EDU entries comes very handy, too.
You mean that it removes unused textures, attachments and meshes?
That's something i will use later as i just pasted every mesh, texture and attachment-file to make things easier.
Be your friend's, true friend. Return gift for gift. Repay laughter, with laughter again
but betrayal with treachery.
You have to do removing by hand - the first time the tool analyzes your EDU it lists in it's log all the present errors which include:
unused models - [Info] Model '15 spanish_viceroy' is never used (battle_models).
unneeded textures - [Info] Model '10 mount_pony' does not need the figure texture entry for faction 'russia' (battle_models).
Last edited by Kilgore Trout; April 28, 2016 at 04:49 PM.
Roland searched the continent for the man who'd done him in
He found him in Mombasa in a barroom drinking gin
Roland aimed his Thompson gun - he didn't say a word
But he blew Van Owen's body from there to Johannesburg
I figured out how to save my files! This is a wonderful tool. Thanks for your help Gigantus!
But just to make sure I've got this right - This Unit Editor is only for the edu and battle_modelsmodeldb files, I will have to move the actual mesh, texture, and attachments files by hand myself - correct?
Last edited by Kilgore Trout; April 28, 2016 at 04:45 PM.
Roland searched the continent for the man who'd done him in
He found him in Mombasa in a barroom drinking gin
Roland aimed his Thompson gun - he didn't say a word
But he blew Van Owen's body from there to Johannesburg
Hello Gigantus, does the tool work for TATW submods ? I get "something werid happened while reading model gorgoroth_beast_riders" message but nothing appears in the logs!