diff --git a/mmw-content/guides/groundcover/lawnmower-tutorial.md b/mmw-content/guides/groundcover/lawnmower-tutorial.md index f66e30e2..eaf74a1d 100644 --- a/mmw-content/guides/groundcover/lawnmower-tutorial.md +++ b/mmw-content/guides/groundcover/lawnmower-tutorial.md @@ -32,7 +32,7 @@ related articles: > > | Type | Name | > | --- | --- | -> | **Requirements** | - [[the-lawnmower\|The Lawnmower]]
- [[tes3conv\|Tes3conv]]
- [Python 3.5+](https://www.python.org/)
- [[tes3cmd\|Tes3cmd]] (optional)
- [[testool\|TESTool]] (optional) | +> | **Requirements** | - [[the-lawnmower\|The Lawnmower]]
- [[tes3conv\|Tes3conv]]
- [Python 3.5+](https://www.python.org/)
- [[MWModWiki/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index\|Tes3cmd]] (optional)
- [[testool\|TESTool]] (optional) | > | **Tutorial Files** | Any groundcover plugin you like that has not already had Lawnmower ran on it (the mod description will likely state whether this is the case) | ![[guides/groundcover/index#^groundcover-navbox|clean right]] @@ -160,7 +160,7 @@ With a couple of extra steps, the reference count of the output plugin can be gr Cleaning the output plugin of redundant `CELL` references involves two steps: -1. Delete the moved grass with [[tes3cmd|Tes3cmd]]. +1. Delete the moved grass with [[MWModWiki/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index|Tes3cmd]]. 2. Clean the plugin of any empty cells with [[testool|TESTool]]. The second step is useful for instances where Lawnmower has removed all grass from a cell, leaving an empty `CELL` record. diff --git a/mmw-content/guides/patches/creating-a-patch-for-an-esp.md b/mmw-content/guides/patches/creating-a-patch-for-an-esp.md index 0a91741e..746ae017 100644 --- a/mmw-content/guides/patches/creating-a-patch-for-an-esp.md +++ b/mmw-content/guides/patches/creating-a-patch-for-an-esp.md @@ -35,7 +35,7 @@ These use an additional ESP to make their changes and in most cases will need to ### Other ESP Patches - Utilizing Global Scripts - Built-in compatibility without the need for a separate patch -- [[tes3cmd|Tes3cmd]] BAT File +- [[MWModWiki/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index|Tes3cmd]] BAT File *** diff --git a/mmw-content/modding-tools/3d-modeling-tools/python-file-format-interface.md b/mmw-content/modding-tools/3d-modeling-tools/python-file-format-interface.md index 334883fc..2ada3c7b 100644 --- a/mmw-content/modding-tools/3d-modeling-tools/python-file-format-interface.md +++ b/mmw-content/modding-tools/3d-modeling-tools/python-file-format-interface.md @@ -32,7 +32,7 @@ description: A Python library developed by NifTools, capable of batch processing > | **Requirements** | Python | > | **Author** | [NifTools](https://www.niftools.org/) | -The **Python File Format Interface** (previously **'Pyffi'**) is a Python library developed by NifTools, capable of batch processing `.NIF` files as a command-line tool analogous to [[tes3cmd|Tes3cmd]].[^1] +The **Python File Format Interface** (previously **'Pyffi'**) is a Python library developed by NifTools, capable of batch processing `.NIF` files as a command-line tool analogous to [[MWModWiki/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index|Tes3cmd]].[^1] ## External Links diff --git a/mmw-content/modding-tools/generating-groundcover/the-lawnmower.md b/mmw-content/modding-tools/generating-groundcover/the-lawnmower.md index 8e9bab5b..cb24c346 100644 --- a/mmw-content/modding-tools/generating-groundcover/the-lawnmower.md +++ b/mmw-content/modding-tools/generating-groundcover/the-lawnmower.md @@ -112,7 +112,7 @@ These invisible marker meshes will appear in the Construction Set, but not in-ga ### Run Lawnmower on Entire Load Order -Using [[habasi|Habasi]] and [[tes3cmd|Tes3cmd]], Lawnmower can be ran on one's entire load order with the help of a BAT script. +Using [[habasi|Habasi]] and [[MWModWiki/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index|Tes3cmd]], Lawnmower can be ran on one's entire load order with the help of a BAT script. ``` rem generate cut grass mods diff --git a/mmw-content/modding-tools/merging-plugins/tes3merge.md b/mmw-content/modding-tools/merging-plugins/tes3merge.md index a2df3e49..e312e010 100644 --- a/mmw-content/modding-tools/merging-plugins/tes3merge.md +++ b/mmw-content/modding-tools/merging-plugins/tes3merge.md @@ -39,7 +39,7 @@ description: An object merging utility for patching mod conflicts for Morrowind, > | **Requirements** | [.NET 6 Runtime](https://dotnet.microsoft.com/en-us/download) | > | **Author** | [NullCascade](https://next.nexusmods.com/profile/NullCascade/about-me) | -**TES3Merge** is an [[modding-tools/merging-plugins/index|object merging]] utility for patching mod conflicts for _Morrowind_, intended as a replacement for older object merging utilities such as [[wrye-mash|Wrye Mash's]] mashed patch and [[tes3cmd|Tes3cmd's]] multipatch. +**TES3Merge** is an [[modding-tools/merging-plugins/index|object merging]] utility for patching mod conflicts for _Morrowind_, intended as a replacement for older object merging utilities such as [[wrye-mash|Wrye Mash's]] mashed patch and [[MWModWiki/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index|Tes3cmd's]] multipatch. ## External Links diff --git a/mmw-content/modding-tools/misc-tools/abots-deleveler.md b/mmw-content/modding-tools/misc-tools/abots-deleveler.md index dbb23dad..3452453f 100644 --- a/mmw-content/modding-tools/misc-tools/abots-deleveler.md +++ b/mmw-content/modding-tools/misc-tools/abots-deleveler.md @@ -27,10 +27,10 @@ description: A utility for converting all Leveled Lists in a plugin to potential > | Type | Name | > | --- | --- | > | **Links** | [Nexus Mods](https://www.nexusmods.com/morrowind/mods/45625) | -> | **Requirements** | [[tes3cmd\|Tes3cmd]] | +> | **Requirements** | [[MWModWiki/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index\|Tes3cmd]] | > | **Author** | [abot](https://next.nexusmods.com/profile/abot/about-me) (author), [OffworldDevil](https://next.nexusmods.com/profile/OffworldDevil/about-me) (publisher) | -**Abot's Deleveler** is a utility for converting all [[guides/leveled-lists/index|Leveled Lists]] in a plugin to potentially spawn at level 1 - so called 'deleveling' - through the use of [[tes3cmd|Tes3cmd]] BAT and Perl scripts. +**Abot's Deleveler** is a utility for converting all [[guides/leveled-lists/index|Leveled Lists]] in a plugin to potentially spawn at level 1 - so called 'deleveling' - through the use of [[MWModWiki/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index|Tes3cmd]] BAT and Perl scripts. The deleveling functionality has been adopted by at least one other tool, [[habasi|Habasi]], and as an MWSE mod with Operator Jack's Deleveler.[^2] The utility's usefulness is primarily to players who wish to increase the difficulty of Morrowind gameplay. However, one could use it as an auxiliary tool in the process of creating [[guides/patches/index|patches]] or reworks of existing mods. diff --git a/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd.md b/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd.md deleted file mode 100644 index f18bbb45..00000000 --- a/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Tes3cmd -aliases: - - Tes3cmd -tags: - - Tes3cmd - - Cleaning-Mods - - Dirty-Edits - - Perl - - Command-line-tool -description: A command-line tool for analysing, modifying and cleaning TES3 plugins. ---- - -![[maintenance-expand-article#^6fc39d|clean]] - -## About - -> [!infobox|n-th] -> -> ## Tes3cmd -> -> > [!caption|wfull center txt-s] -> > -> > ![[screenshot-of-tes3cmd-cleaning-a-plugin.png|center]] -> > Tes3cmd cleaning a plugin of duplicate records. -> -> ### Details -> -> | Type | Name | -> | --- | --- | -> | **Links** | [Github](https://github.com/john-moonsugar/tes3cmd/blob/master/tes3cmd) | -> | **Requirements** | none | -> | **Author** | John Moonsugar | - -**Tes3cmd** is a multi-purpose command-line tool written in Perl for analyzing, modifying and cleaning TES3 plugins. - -## External Links - -- **Danae's Journal**, ["Good Modding Practice: Checking Mods"](https://danaeplays.thenet.sk/good-modding-practice/) -- **Notes for Modmakers**, ["Tes3cmd"](https://morrowind-nif.github.io/Notes_RU/tes3cmd.htm?ms=CyAAAAAAEAAAAAAAABAAAAAAAAAAAEABEAgYQA%3D%3D&st=MA%3D%3D&sct=MA%3D%3D&mw=MzIw) #Language/Russian \ No newline at end of file diff --git a/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/Dump.md b/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/Dump.md new file mode 100644 index 00000000..41f7fd61 --- /dev/null +++ b/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/Dump.md @@ -0,0 +1,22 @@ + +One of tes3cmd's most basic functionalities is to read the contents of a plugin and see what exactly is in it. Tes3cmd is capable of dumping any [record type](https://en.uesp.net/wiki/Morrowind_Mod:Mod_File_Format) with varying degrees of readability. + +What this means for you, is that it's a great means to quickly get down and dirty in your entire load order, spot possible mod conflicts, and even extract parts of mods out to new plugins to make your own edits on top! Make sure you are familiar with the various record types mentioned on the [tes3cmd homepage](obsidian://open?vault=S3%20Vault&file=MWModWiki%2Fmmw-content%2Fmodding-tools%2Fmultipurpose-plugin-utilities%2Ftes3cmd%2Findex) before attempting to use dump. The article itself will mostly consist of usage examples and example outputs. + +> [!example Basic Dump Syntax] +> tes3cmd dump $PLUGIN_NAME.esp + + +> [!tip Saving to File] +> When using dump, you can save the output to a new file on any platform by using the following: `> filename.txt` +> >[!example Save to file] +> >tes3cmd dump --type NPC --id ".\*caius.\*" \*.es[mM][pP] > caius.txt + + +# Arguments/Options + +Dump has a few additional arguments you can supply when using it to change what records are displayed, and how they're displayed. + +## External Links +[Dump Subcommand](https://github.com/john-moonsugar/tes3cmd/wiki/tes3cmd-command-line-documentation#dump---_dump-records-as-text-for-easy-study) + diff --git a/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/Fixit.md b/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/Fixit.md new file mode 100644 index 00000000..a126e7fd --- /dev/null +++ b/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/Fixit.md @@ -0,0 +1,37 @@ +> [!danger Do Not EVER Use] +> +> Fixit is *extremely* dangerous. While its operation will be described here, it is not recommended to use it in any form. This includes the button which is bundled into certain versions of Wrye Mash. ***THIS WILL ALMOST CERTAINLY BURN SOMETHING TO THE GROUND.*** + +Fixit operates in four steps. + +## Clean All Plugins +Tes3cmd assumes it is in your `Data Files` folder and cleans everything it can find that resembles an actual Morrowind mod, eg files ending in `ESP` or `ESM` (not case-sensitive). This includes the vanilla ESM files and anything that doesn't need to be cleaned, along with things that do. The results will be unpredictable, and bad, and you are on your own at this point. +## Synchronizes Plugin Headers To Masters +This is only relevant for Morrowind.exe users, but for them, this *can* be very handy. Morrowind.exe tracks the size in bytes of plugins which other ones depend on, and emits errors if the actual size in one plugin doesn't match what another says it will be. + +So, for example, if you have one mod depending on TR, and a TR update has released since the mod was last updated, Morrowind.exe will yell at you about it every time you open the game. This step fixes that, but doesn't necessarily resolve any underlying issues with the update. For example, this error will be fixed, but if your mod depends on an NPC in TR_Data that no longer exists, tes3cmd can't help you here. + +If you need this, do it yourself. + +> [!example Sync] +> tes3cmd header --synchronize + + +## Generates A Patch For Merged Leveled Lists and More +No. For either MGE XE or OpenMW users, you can use Tes3Merge to create merged plugins. For OpenMW users, DeltaPlugin is usually preferred. + +## Resets Dates on Vanilla Files +This is an error that you should only get once per install with Steam versions of Morrowind, but it's a nasty one. Morrowind.exe uses file modification dates to prioritize loading content files and assets. What this means for you is that you may install replacement assets and never see them in-game, because the dates of Morrowind.bsa and friends are later than the mod's versions, so the assets are overridden. + +If you need this, do it yourself. + +> [!example Reset Dates] +> tes3cmd resetdates + + + + ## External Links +[Tes3cmd Wiki - ResetDates](https://github.com/john-moonsugar/tes3cmd/wiki/tes3cmd-command-line-documentation#resetdates---_reset-dates-of-bethesda-data-files-to-original-settings) + + + diff --git a/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index.md b/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index.md new file mode 100644 index 00000000..db7937e3 --- /dev/null +++ b/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index.md @@ -0,0 +1,55 @@ +--- +title: Tes3cmd +aliases: + - Tes3cmd +tags: + - Tes3cmd + - Cleaning-Mods + - Dirty-Edits + - Perl + - Command-line-tool +description: A command-line tool for analysing, modifying and cleaning TES3 plugins. +--- + +![[maintenance-expand-article#^6fc39d|clean]] + +## About + +> [!infobox|n-th] +> +> ## Tes3cmd +> +> > [!caption|wfull center txt-s] +> > +> > ![[screenshot-of-tes3cmd-cleaning-a-plugin.png|center]] +> > Tes3cmd cleaning a plugin of duplicate records. +> +> ### Details +> +> | Type | Name | +> | --- | --- | +> | **Links** | [Github](https://github.com/john-moonsugar/tes3cmd/blob/master/tes3cmd) | +> | **Requirements** | none | +> | **Author** | John Moonsugar | + +**Tes3cmd** is a multi-purpose command-line tool written in Perl for analyzing, modifying and cleaning TES3 plugins. For details on its usage, check the pages for each respective subcommand. + + +> [!warning Record Types] +> +> Before making use of tes3cmd, you may wish to familiarize yourself with the various [types of records](https://en.uesp.net/wiki/Morrowind_Mod:Mod_File_Format), or objects, you'll find inside a TES3 plugin. This information is crucial to effective use of the tool. + +> [!info Regex] +> +> Tes3cmd uses perl [regular expressions](https://perldoc.perl.org/perlre) as part of its syntax. Regular expressions, or regex, are extremely powerful, and equally scary. +> Be aware that `.*` means to match any number of occurrences of any character, so `caius.*` finds anything starting with `caius`, and `.*caius` finds anything ending with `caius`. This will be sufficient for most, if not all use cases. + +> [!warning OpenMW] +> +> Using tes3cmd in an OpenMW setup (without MO2) is somewhat different than an MGE XE one. The following documentation will assume all plugins are located within the `Data Files` folder of your Morrowind installation for ease of use. For the same reason, modders and players on OpenMW are recommended to use DeltaPlugin instead. + + +## External Links + +- **Danae's Journal**, ["Good Modding Practice: Checking Mods"](https://danaeplays.thenet.sk/good-modding-practice/) +- **Notes for Modmakers**, ["Tes3cmd"](https://morrowind-nif.github.io/Notes_RU/tes3cmd.htm?ms=CyAAAAAAEAAAAAAAABAAAAAAAAAAAEABEAgYQA%3D%3D&st=MA%3D%3D&sct=MA%3D%3D&mw=MzIw) #Language/Russian \ No newline at end of file diff --git a/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3lint.md b/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3lint.md index 24feddff..fce2e3cc 100644 --- a/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3lint.md +++ b/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3lint.md @@ -31,7 +31,7 @@ description: **Tes3lint** is a command-line tool by John Moonsugar for checking plugins for potential problems. -In addition to detecting common problems which are cleaned automatically by other tools, including Moonsugar's other tool [[tes3cmd|Tes3cmd]], tes3lint's features include: +In addition to detecting common problems which are cleaned automatically by other tools, including Moonsugar's other tool [[MWModWiki/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index|Tes3cmd]], tes3lint's features include: - Check for implicit dependency on Tribunal/Bloodmoon functions without having them as a master. - Display duplicate/modified INFO records. @@ -43,5 +43,5 @@ In addition to detecting common problems which are cleaned automatically by othe ## Usage -Like Moonsugar's other tool [[tes3cmd|Tes3cmd]], it is also written in Perl. However, unlike the former it requires that Perl itself is installed. Tes3lint is run via the command-line, but can also be run through [[wrye-mash|Wrye Mash Polemos Fork]] which features tes3lint support. +Like Moonsugar's other tool [[MWModWiki/mmw-content/modding-tools/multipurpose-plugin-utilities/tes3cmd/index|Tes3cmd]], it is also written in Perl. However, unlike the former it requires that Perl itself is installed. Tes3lint is run via the command-line, but can also be run through [[wrye-mash|Wrye Mash Polemos Fork]] which features tes3lint support.