-
Notifications
You must be signed in to change notification settings - Fork 0
/
3-wryemashusage.html
1690 lines (1688 loc) · 181 KB
/
3-wryemashusage.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
---
layout: default
title: Wrye Mash Usage
---
<h1 class="header1">{{ page.title }}</h1>
<hr>
<h1 class="grhead1">Main Table of Contents</h1>
<div id="tableOfContents" class="grid-toc">
<div class="toc1">
<h2 class="grhead2">General</h2>
<h3 class="grhead3"><a href="index.html">Welcome</a></h3>
<h3 class="grhead3"><a href="10-contribute.html">Contribute: Generate Wiki pages from Text Files</a></h3>
<h2 class="grhead2">Wrye Bash Related</h2>
<h3 class="grhead3"><a href="2-wryebashfeatures.html">Wrye Bash Features</a></h3>
<h3 class="grhead3"><a href="3-wryemashusage.html">Wrye Mash Usage</a></h3>
<h3 class="grhead3"><a href="4-generalusage.html">General Usage</a></h3>
<h3 class="grhead3"><a href="5-advancedusage.html">Advanced Usage</a></h3>
</div>
<div class="toc2">
<h3 class="grhead3"><a href="6-technicalreferences.html">Technical References</a></h3>
<h3 class="grhead3"><a href="8-tomeofalt3rn1ty.html">Tome of Alt3rn1ty</a></h3>
<h2 class="grhead2">Morrowind Related</h2>
<h3 class="grhead3"><a href="9-morrowindandbeyond.html">Morrowind And Beyond</a></h3>
<h3 class="grhead3"><a href="14-testoolghostwheel.html">TES Plugin Tool (TESTool) 1.3 Docs</a></h3>
<h2 class="grhead2">Oblivion Related</h2>
<h3 class="grhead3"><a href="7-tomeofpsymon.html">Tome of Psymon - BAIN Mod Installation Projects</a></h3>
<h3 class="grhead3"><a href="13-oblivionandbeyond.html">Oblivion And Beyond</a></h3>
</div>
</div>
<p class="empty"> </p>
<div>
<!-- Needed, sets the top of the page just before the H1 Title -->
<h1 class="header1" id="WryeMash">Wrye Mash</h1>
<p class="list-1">• Latest Version: <a href="https://github.com/Wrye-Bashers/Wrye-Mash/releases" >Wrye Mash</a></p>
<p class="list-1">• Discussion: <a href="https://www.afkmods.com/index.php?/topic/5068-wipz-wrye-mash/" >AFK Mods Forums</a></p>
<p class="empty"> </p>
<h2 class="header2" id="Contents">Contents</h2>
<p class="list-1">• <a href="#QuickStart">3.1 Quick Start</a></p>
<p class="list-1">• <a href="#AlternateIconsfortheColorBlind">3.2 Alternate Icons for the Color Blind</a></p>
<p class="list-2">• <a href="#MaintainYourLoadOrder">3.2.1 Maintain Your Load Order</a></p>
<p class="list-2">• <a href="#ChangeModLoadOrder">3.2.2 Change Mod Load Order</a></p>
<p class="list-2">• <a href="#MergingLeveledLists">3.2.3 Merging Leveled Lists</a></p>
<p class="list-2">• <a href="#RepairingaSaveGame">3.2.4 Repairing a Save Game</a></p>
<p class="list-2">• <a href="#AddingRemovingModsFromaSaveGame">3.2.5 Adding/Removing Mods From a Save Game</a></p>
<p class="list-2">• <a href="#UsinganUpdatedVersionofaMod">3.2.6 Using an Updated Version of a Mod</a></p>
<p class="list-2">• <a href="#TweakMorrowindini">3.2.7 Tweak Morrowind.ini</a></p>
<p class="list-2">• <a href="#ManageTextureReplacers">3.2.8 Manage Texture Replacers</a></p>
<p class="list-2">• <a href="#SwitchBetweenSaveProfiles">3.2.9 Switch Between Save Profiles</a></p>
<p class="list-2">• <a href="#GeneralAdvice">3.2.10 General Advice</a></p>
<p class="list-1">• <a href="#Features">3.3 Features</a></p>
<p class="list-1">• <a href="#UpdatingFromPreviousVersion">3.4 Updating From Previous Version</a></p>
<p class="list-1">• <a href="#WryeMashSettings">3.5 Wrye Mash Settings</a></p>
<p class="list-1">• <a href="#Installation">3.6 Installation</a></p>
<p class="list-2">• <a href="#GetandInstall">3.6.1 Get and Install</a></p>
<p class="list-2">• <a href="#WryeMashStandalone">3.6.2 Wrye Mash Standalone</a></p>
<p class="list-2">• <a href="#StartingWryeMash">3.6.3 Starting Wrye Mash</a></p>
<p class="list-2">• <a href="#NonStandardMorrowindPythonDirectories">3.6.4 Non-Standard Morrowind/Python Directories</a></p>
<p class="list-2">• <a href="#IfMashWontStart">3.6.5 <font class="red">If Mash Won't Start</font></a></p>
<p class="list-1">• <a href="#Usage">3.7 Usage</a></p>
<p class="list-2">• <a href="#MorrowindInstallDirectory">3.7.1 Morrowind Install Directory</a></p>
<p class="list-2">• <a href="#Overview">3.7.2 Overview</a></p>
<p class="list-1">• <a href="#InstallersTab">3.8 Installers Tab</a></p>
<p class="list-2">• <a href="#GettingStarted">3.8.1 Getting Started</a></p>
<p class="list-2">• <a href="#Overview1">3.8.2 Overview</a></p>
<p class="list-2">• <a href="#PackageDetails">3.8.3 Package Details</a></p>
<p class="list-2">• <a href="#PackageStructure">3.8.4 Package Structure</a></p>
<p class="list-2">• <a href="#SkippedFiles">3.8.5 Skipped Files</a></p>
<p class="list-2">• <a href="#DocFileSweeping">3.8.6 Doc File Sweeping</a></p>
<p class="list-2">• <a href="#Ordering">3.8.7 Ordering</a></p>
<p class="list-2">• <a href="#ModNameAliasing">3.8.8 Mod Name Aliasing</a></p>
<p class="list-2">• <a href="#PackageCommands">3.8.9 Package Commands</a></p>
<p class="list-2">• <a href="#PackageHeaderCommands">3.8.10 Package Header Commands</a></p>
<p class="list-1">• <a href="#ModsTab">3.9 Mods Tab</a></p>
<p class="list-2">• <a href="#ModsList">3.9.1 Mods List</a></p>
<p class="list-2">• <a href="#ModDetails">3.9.2 Mod Details</a></p>
<p class="list-2">• <a href="#UsingLoadLists">3.9.3 Using Load Lists</a></p>
<p class="list-2">• <a href="#FileCommands">3.9.4 File Commands</a></p>
<p class="list-2">• <a href="#Usingmlox">3.9.5 Using mlox</a></p>
<p class="list-2">• <a href="#Usingtes3cmd">3.9.6 Using tes3cmd</a></p>
<p class="list-2">• <a href="#ExportImportDialog">3.9.7 Export/Import Dialog</a></p>
<p class="list-2">• <a href="#ExportImportScripts">3.9.8 Export/Import Scripts</a></p>
<p class="list-2">• <a href="#ImportLCVSchedules">3.9.9 Import LCV Schedules</a></p>
<p class="list-2">• <a href="#ImportMergedLists">3.9.10 Import Merged Lists</a></p>
<p class="list-2">• <a href="#ImportReplacer">3.9.11 Import Replacer</a></p>
<p class="list-2">• <a href="#RenumberRefs">3.9.12 Renumber Refs</a></p>
<p class="list-2">• <a href="#RepairRefs">3.9.13 Repair Refs</a></p>
<p class="list-2">• <a href="#CopytoEsmEsp">3.9.14 Copy to Esm/Esp</a></p>
<p class="list-2">• <a href="#SortRecords">3.9.15 Sort Records</a></p>
<p class="list-2">• <a href="#Statistics">3.9.16 Statistics</a></p>
<p class="list-2">• <a href="#Updaters">3.9.17 Updaters</a></p>
<p class="list-1">• <a href="#SavesTab">3.10 Saves Tab</a></p>
<p class="list-2">• <a href="#SavesList">3.10.1 Saves List</a></p>
<p class="list-2">• <a href="#SaveDetails">3.10.2 Save Details</a></p>
<p class="list-2">• <a href="#Profiles">3.10.3 Profiles</a></p>
<p class="list-2">• <a href="#FileCommands2">3.10.4 File Commands</a></p>
<p class="list-2">• <a href="#Remove">3.10.5 Remove</a></p>
<p class="list-2">• <a href="#JournalBrowser">3.10.6 Journal Browser</a></p>
<p class="list-2">• <a href="#LoadMasters">3.10.7 Load Masters</a></p>
<p class="list-2">• <a href="#MapNotes">3.10.8 Map Notes</a></p>
<p class="list-2">• <a href="#RepairAll">3.10.9 Repair All</a></p>
<p class="list-2">• <a href="#UpdateMap">3.10.10 Update Map</a></p>
<p class="list-2">• <a href="#Review">3.10.11 Review</a></p>
<p class="list-2">• <a href="#Statistics3">3.10.12 Statistics</a></p>
<p class="list-1">• <a href="#DocBrowser">3.11 Doc Browser</a></p>
<p class="list-2">• <a href="#UsingtheDocBrowser">3.11.1 Using the Doc Browser</a></p>
<p class="list-2">• <a href="#WikiTextFormat">3.11.2 Wiki Text Format</a></p>
<p class="list-2">• <a href="#Notes">3.11.3 Notes</a></p>
<p class="list-2">• <a href="#Suggestions">3.11.4 Suggestions</a></p>
<p class="list-1">• <a href="#Doubling">3.12 Doubling</a></p>
<p class="list-2">• <a href="#DoublingTheory">3.12.1 Doubling Theory</a></p>
<p class="list-2">• <a href="#LoadOrderMaintenance">3.12.2 Load Order Maintenance</a></p>
<p class="list-2">• <a href="#ModUpdating">3.12.3 Mod Updating</a></p>
<p class="list-2">• <a href="#MasterListUpdating">3.12.4 Master List Updating</a></p>
<p class="list-2">• <a href="#RepairRefsCommand">3.12.5 Repair Refs Command</a></p>
<p class="list-2">• <a href="#RepairAllCommand">3.12.6 Repair All Command</a></p>
<p class="list-1">• <a href="#Mish">3.13 Mish</a></p>
<p class="list-2">• <a href="#MishCommands">3.13.1 Mish Commands</a></p>
<p class="list-1">• <a href="#Extending">3.14 Extending</a></p>
<p class="list-2">• <a href="#Internationalization">3.14.1 Internationalization</a></p>
<p class="list-2">• <a href="#PythonandwxPython">3.14.2 Python and wxPython</a></p>
<p class="list-2">• <a href="#MechanicsEditorsandNavigation">3.14.3 Mechanics: Editors and Navigation</a></p>
<p class="list-2">• <a href="#GettingStarted4">3.14.4 Getting Started</a></p>
<p class="list-2">• <a href="#CodeLayout">3.14.5 Code Layout</a></p>
<p class="list-1">• <a href="#DataandExtras">3.15 Data and Extras</a></p>
<p class="list-2">• <a href="#DataRefRemovers">3.15.1 Data: Ref Removers</a></p>
<p class="list-2">• <a href="#DataRefReplacers">3.15.2 Data: Ref Replacers</a></p>
<p class="list-2">• <a href="#Extras">3.15.3 Extras</a></p>
<p class="list-1">• <a href="#Versions">3.16 Versions</a></p>
<p class="list-1">• <a href="#ReuseandCredits">3.17 Reuse and Credits</a></p>
<p class="list-2">• <a href="#License">3.17.1 License</a></p>
<p class="list-2">• <a href="#CreditsThanks">3.17.2 Credits/Thanks</a></p>
<p class="list-2">• <a href="#Contact">3.17.3 Contact</a></p>
<p class="empty"> </p>
<h2 class="header2" id="QuickStart">3.1 - Quick Start</h2>
<p><B><I>Do you find long docs scary?</I></B> Here's a quick guide to Mash's most popular features.</p>
<p class="empty"> </p>
<h2 class="header2" id="AlternateIconsfortheColorBlind">3.2 - Alternate Icons for the Color Blind</h2>
<p><a href="http://mw.modhistory.com/download-55-15458" >Wrye Mash Icons by Bruno13069</a></p>
<p class="empty"> </p>
<h3 class="header3" id="MaintainYourLoadOrder">3.2.1 - Maintain Your Load Order</h3>
<p class="list-1">• You only have to do this once...</p>
<p class="list-1">• Go to Mods tab, right click on "File" column header and make sure that "Lock Times" is checked.</p>
<p class="list-1">• For more information, see <B><I><a href="#LoadOrderMaintenance" >Load Order Maintenance</a>.</I></B></p>
<p class="empty"> </p>
<h3 class="header3" id="ChangeModLoadOrder">3.2.2 - Change Mod Load Order</h3>
<p class="list-1">• Go to mods tab, and select the mod you want to reorder.</p>
<p class="list-1">• Edit the "Modified" date/time field to the date/time you want.</p>
<p class="list-1">• Click Save.</p>
<p class="empty"> </p>
<h3 class="header3" id="MergingLeveledLists">3.2.3 - Merging Leveled Lists</h3>
<p class="list-1">• Copy "Mashed Lists.esp" from the mopy\Extras folder to your Data Files folder.</p>
<p class="list-1">• Select the mods you want to load from the Mods tab.</p>
<p class="list-1">• Right click on "Mashed Lists.esp" in the Mods tab and select "Import: Merged Lists".</p>
<p class="list-1">• For more information, see <B><I><a href="#ImportMergedLists" >Import Merged Lists</a>.</I></B></p>
<p class="empty"> </p>
<h3 class="header3" id="RepairingaSaveGame">3.2.4 - Repairing a Save Game</h3>
<p class="list-1">• Go to the Saves tab and right click on the save game, then select "Repair All".</p>
<p class="list-1">• For more information, see <B><I><a href="#RepairRefsCommand" >Repair Refs Command</a>.</I></B></p>
<p class="empty"> </p>
<h3 class="header3" id="AddingRemovingModsFromaSaveGame">3.2.5 - Adding/Removing Mods From a Save Game</h3>
<p class="list-1">• Go to Mods tab and check the mods that you want to use.</p>
<p class="list-1">• Go to Saves tab and select the save game you want to play.</p>
<p class="list-1">• Right click on the top of the Masters List, and select "Sync to Load List".</p>
<p class="list-1">• Click "Save". The checkbox for the save game should turn purple.</p>
<p class="list-1">• For more information, see <B><I><a href="#MasterListUpdating" >Master List Updating</a>.</I></B></p>
<p class="empty"> </p>
<h3 class="header3" id="UsinganUpdatedVersionofaMod">3.2.6 - Using an Updated Version of a Mod</h3>
<p class="list-1">• <B><I>You only need to do this if the new version of the mod adds or removes references from the game!</I></B></p>
<p class="list-1">• Put both new and old versions of the Mod in the Data Files directory.</p>
<p class="list-1">• Go to Mods tab, right click on the <B><I>new</I></B> mod and select "Updaters...".</p>
<p class="list-1">• Click on the "Add" button, select the old mod and click Open.</p>
<p class="list-1">• Close the Updaters dialog.</p>
<p class="list-1">• Go to the Saves tab, and select the save game that you want to update.</p>
<p class="list-1">• Right click on the top of the Masters List, and select "Update".</p>
<p class="list-1">• Right click on the old mod and select "Change To...".</p>
<p class="list-1">• Select the new mod in the file dialog and then click "Open".</p>
<p class="list-1">• The renamed master should turn bright green (instead of the usual pale green).</p>
<p class="list-1">• Click Save.</p>
<p class="list-1">• For more information, see <B><I><a href="#ModUpdating" >Mod Updating</a>.</I></B></p>
<p class="empty"> </p>
<h3 class="header3" id="TweakMorrowindini">3.2.7 - Tweak Morrowind.ini</h3>
<p class="list-1">• Settings in Morrowind.ini control aspects of the game like light attenuation, weather lighting, moon size and appearance, etc. You can tweak Morrowind.ini by hand, or by applying mit files.</p>
<p class="list-1">• To apply an mit file...</p>
<p class="list-1">• Go to mods tab, right click on main column header and select "INI Tweaks...". This will bring up a file selection dialog.</p>
<p class="list-1">• Select one of the mit files from Morrowind\Data Files\Mits and click Open. This will apply the changes in the mit file to Morrowind.ini.</p>
<p class="empty"> </p>
<h3 class="header3" id="ManageTextureReplacers">3.2.8 - Manage Texture Replacers</h3>
<p class="list-1">• <B><I>Setup</I></B></p>
<p class="list-2">• Create a directory called "Replacers" in your Data Files directory.</p>
<p class="list-2">• Unpack/unzip the replacer package that you want to use into the Replacers directory. The name of the directory will be the name of the replacer.</p>
<p class="list-3">• E.g., "E-Icons Blue Star", or "Redoran, Carnajo" or "Redoran, Lady Rae".</p>
<p class="list-2">• The replacer's directory structure can be one of two forms:</p>
<p class="list-3">• Just like the Data Files directory structure;</p>
<p class="list-4">• Replacers</p>
<p class="list-5">• Bob's Replacement Set</p>
<p class="list-6">• Icons (if you have icons)</p>
<p class="list-6">• Meshes (if you have meshes)</p>
<p class="list-6">• Textures (if you have textures)</p>
<p class="list-3">• Just the textures (for texture replacers only)</p>
<p class="list-4">• Replacers</p>
<p class="list-5">• E-Icons, Blue Star</p>
<p class="list-6">• dds files</p>
<p class="list-5">• Redoran, Lady Rae</p>
<p class="list-6">• dds files</p>
<p class="list-3">• Note that most texture replacement packs have the second form.</p>
<p class="list-1">• <B><I>Usage</I></B></p>
<p class="list-2">• Go to Mods tab, right click on the main column header and select "Replacers..." — this will bring up a checkbox list of the available replacers.</p>
<p class="list-2">• Checking a replacer will apply it. (Large replacer collections may take a while to apply.)</p>
<p class="list-2">• Unchecking a replacer will remove it.</p>
<p class="empty"> </p>
<h3 class="header3" id="SwitchBetweenSaveProfiles">3.2.9 - Switch Between Save Profiles</h3>
<p class="list-1">• Go to Saves tab and right click on column header, then go to Profiles menu.</p>
<p class="list-1">• Choose Edit... to add, rename, and remove profiles.</p>
<p class="list-1">• Choose a profile to switch to it. Current savegames and Morrowind.ini will be archived, and the new profile's savegames and Morrowind.ini will be loaded.</p>
<p class="empty"> </p>
<h3 class="header3" id="GeneralAdvice">3.2.10 - General Advice</h3>
<p class="list-1">• <B><I>Run Repair All</I></B></p>
<p class="list-2">• Run Repair All on old save files — this will often find problems to fix.</p>
<p class="list-2">• Run Repair All once in a while after editing Master lists.</p>
<p class="list-1">• <B><I>Use Duplicate</I></B></p>
<p class="list-2">• Before making major changes to a save file, create a duplicate and make the changes on it.</p>
<p class="empty"> </p>
<h2 class="header2" id="Features">3.3 - Features</h2>
<p class="list-1">• <B><I>Manage Mod Files and Load List</I></B></p>
<p class="list-2">• Select load mods from a list that can be sorted by: File Name, Modification date, Size, Mod Author, Load Order, Selection State and file type (Esm/Esp).</p>
<p class="list-2">• Select mods by loads lists which you define. E.g., define a Bethesda Mods list, or an LGNPC or Astarsis Heads list.</p>
<p class="list-2">• Hide rarely used mods. (Yes, there's an Unhide command too!)</p>
<p class="list-2">• Delete and Duplicate Mods.</p>
<p class="list-2">• Edit file name, modification date, author, description and master list.</p>
<p class="list-2">• Automatically reset modification dates after file has been modified. (This substantially reduces doubling problems.)</p>
<p class="list-1">• <B><I>Manage Save Games</I></B></p>
<p class="list-2">• View a list of your save games sorted by: File Name, Save Name, Player Name, Current Cell, Load Status (see below).</p>
<p class="list-2">• Delete, Duplicate and Hide Save Games.</p>
<p class="list-2">• Edit file name, Save Name and master list.</p>
<p class="list-1">• <B><I>Reduce/Eliminate Doubling</I></B></p>
<p class="list-2">• See potential doubling before it happens. (Status boxes in save game and</p>
<p> master lists.)</p>
<p class="list-2">• Automatically reset modification dates.</p>
<p class="list-2">• Update save game files to handle changes to the masters that it depends</p>
<p> on and to the current load list.</p>
<p class="list-2">• Repair References in existing files.</p>
<p class="list-1">• <B><I>Browse Mod Documents</I></B></p>
<p class="list-2">• Browse documents for all mods with the <a href="#DocBrowser" >Doc Browser</a>.</p>
<p class="list-1">• <B><I>Run Additional Commands</I></B></p>
<p class="list-2">• View File Statistics. See the number and size of record types in any file.</p>
<p class="list-1">• <B><I>Create Your Own Utilities</I></B></p>
<p class="list-2">• Wrye Mash provides libraries and an interface that make it (relatively) easy to define new save and file munching utilities and make them through the Wrye Mash interface.</p>
<p class="list-2">• You can also define your own command line utilities for munching on data files. (The result is not as pretty as adding your utility to Wrye Mash, but it's a lot easier to do, and allows you to ignore the roughly twice as complex interface code.)</p>
<p class="list-1">• <B><I>Modify Anything</I></B></p>
<p class="list-2">• Because the entire source code is available, and because no special tools are required, you can modify whatever you like.</p>
<p class="list-2">• Of course, making modifications that don't break the program requires care, but some things are relatively easy and safe to modify</p>
<p class="list-3">• Context Menu structure.</p>
<p class="list-3">• Status icons and highlight colors.</p>
<p class="list-3">• Toolbar/launcher buttons.</p>
<p class="empty"> </p>
<h2 class="header2" id="UpdatingFromPreviousVersion">3.4 - Updating From Previous Version</h2>
<p class="empty"> </p>
<p><B>Remove the following three files:</B></p>
<p class="list-1">• mash.exe</p>
<p class="list-1">• MSVCP71.dll</p>
<p class="list-1">• MSVCR71.dll</p>
<p class="empty"> </p>
<h2 class="header2" id="WryeMashSettings">3.5 - Wrye Mash Settings</h2>
<p><img src="img/settings.jpg" width="475" height="245" alt="Settings Window"></p>
<p class="empty"> </p>
<p>The Installers and Installers Data folders have been updated. However, you can specify the old location if you choose.</p>
<p class="empty"> </p>
<p><B>Old locations</B></p>
<p class="empty"> </p>
<p class="list-1">• [Path]\Morrowind Mods\Bash (installers.dat)</p>
<p class="list-1">• [Path]\Morrowind Mods\Bash Installers (All installers *.zip, *.rar, *.7z)</p>
<p class="empty"> </p>
<p><B>New locations</B></p>
<p class="empty"> </p>
<p class="list-1">• [Path]\Morrowind Mods\Installers Data (installers.dat)</p>
<p class="list-1">• [Path]\Morrowind Mods\Mash Installers (All installers *.zip, *.rar, *.7z)</p>
<p class="empty"> </p>
<h2 class="header2" id="Installation">3.6 - Installation</h2>
<h3 class="header3" id="GetandInstall">3.6.1 - Get and Install</h3>
<p class="list-1">• Wrye Mash is written in <a href="http://www.python.org/doc/Summary.html" >python</a> and uses the <a href="http://wxpython.org/what.php" >wxPython GUI library</a> to provide the interface. So before you can run Wrye Mash, you'll need to download both of these.</p>
<p class="list-1">• <B>Download and Install Python 2.7.12</B></p>
<p class="list-1"> Download link: <a href="https://www.python.org/downloads/release/python-2712/" >Python 2.7.12</a></p>
<p class="list-1">• <B>Download and Install wxPython 2.8.0.1 Unicode</B></p>
<p class="list-1"> Download link: <a href="https://sourceforge.net/projects/wxpython/files/wxPython/2.8.12.1/wxPython2.8-win32-unicode-2.8.12.1-py27.exe/download" >wxPython 2.8.12.1 Unicode for python 2.7</a>.</p>
<p class="list-1">• <B>Unzip Wrye Mash XX.zip:</B></p>
<p class="list-1"> Unzip the files <I>into your Morrowind installation directory.</I> If you've done this correctly, you'll find mash.py and other mash files under Morrowind\Mopy.</p>
<p class="empty"> </p>
<h3 class="header3" id="WryeMashStandalone">3.6.2 - Wrye Mash Standalone</h3>
<p>You can download a standalone EXE that doesn't require Python to be installed.</p>
<p class="list-1">• <B>Wrye Mash 88 Standalone</B></p>
<p class="list-1"> Download link: <a href="https://github.com/Wrye-Code-Collection/Wrye-Mash/releases" >Wrye Mash 88 Standalone</a></p>
<p class="empty"> </p>
<h3 class="header3" id="StartingWryeMash">3.6.3 - Starting Wrye Mash</h3>
<p class="list-1">• <B><I>Double click</I></B> the "Wrye Mash.exe" in the Mopy directory.</p>
<p class="list-1">• If this doesn't work, see <a href="#NonStandardMorrowindPythonDirectories" >Non-Standard Morrowind/Python Directories</a> or <B><I><a class="red" href="#IfMashWontStart" >If Mash Won't Start</a></I></B></p>
<p class="empty"> </p>
<h3 class="header3" id="NonStandardMorrowindPythonDirectories">3.6.4 - Non-Standard Morrowind/Python Directories</h3>
<p class="list-1">• <B><I>Do this if either Morrowind or Python is in a non-standard directory.</I></B></p>
<p class="list-2">• Wrye Mash is not a regular program, but rather a script file. To run Mash, the Wrye Mash shortcut needs to tell Windows to: 1) find the Python script file interpreter (<B>pythonw.exe</B>), and 2) use it to run the <B>mash.py</B> script file that is located in the 3) <B>Morrowind\Mopy</B> directory.</p>
<p class="list-2">• Ordinarily the Wrye Mash shortcut does this pretty easily, but if either Python or Morrowind is in a non-standard directory, then you need to alter it to point to the new directories. The rest of this section shows you how to do that.</p>
<p class="list-1">• Copy the "Wrye Mash for Python 2.x" shortcut and give the copy a new name (e.g., "My Mash 2.x") — this protects your changes from being overwritten by future Mash releases.</p>
<p class="list-1">• Right click on the new shortcut, select <B>Properties</B>. This will open the Properties window for the shortcut.</p>
<p class="list-1">• Go to the <B>Shortcut</B> tab in the Properties window.</p>
<p class="list-1">• If <B><I>Morrowind</I></B> is in a non-standard directory, then edit the <B>Start In</B> field to be</p>
<p class="list-2"> <code>[Morrowind Directory Path]\Mopy</code> <B><I>(e.g.</I></B> <code>H:\Games\Morrowind\Mopy</code> <B><I>)</I></B></p>
<p class="list-1">• If <B><I>Python</I></B> is in a non-standard place. then edit the <B>Target</B> field to be:</p>
<p class="list-2"> <code>"[PythonPath]" mash.py</code> <B><I>(e.g.</I></B> <code>"C:\Python24\pythonw.exe" mash.py</code> <B><I>)</I></B></p>
<p class="empty"> </p>
<h3 class="header3" id="IfMashWontStart">3.6.5 - <font class="red">If Mash Won't Start</font></h3>
<p class="list-1">• <B><I>If Mash refuses to start, or quits after quickly flashing up a window...</I></B></p>
<p class="list-1">• <B>Check your Mash Shortcut</B></p>
<p class="list-2">• Most users who have problems with Mash simply need to tweak the <B>Start In</B> and/or <B>Target</B> fields of the shortcut. (See <a href="#NonStandardMorrowindPythonDirectories" >Non-Standard Morrowind/Python Directories</a> for more info.)</p>
<p class="list-2">• If that's fine, then there may be a bug with Mash, or a problem with your setup. You can usually figure out the problem by creating a <B><I>bug dump</I></B> and reviewing it. And if you can't puzzle it out, someone on the Elder Scrolls forums may be able to help.</p>
<p class="list-1">• <B>Getting the Bugdump</B></p>
<p class="list-2">• Open a command shell (Start: Programs: Accessories: Command Prompt).</p>
<p class="list-2">• <B>chdir</B> to the Mopy directory. "chdir" means "change directory". E.g.: <code>chdir C:\Program Files\Bethesda Softworks\Morrowind\Mopy</code></p>
<p class="list-2">• Type: <code>c:\python24\python.exe mash.py 0</code></p>
<p class="list-3">• If you have a different version/location of python, adapt the first argument accordingly.</p>
<p class="list-3">• That's the number zero at the end, <I>not</I> the letter 'o'.</p>
<p class="list-2">• Doing this will cause any error messages that Mash generates on start to spew to the command shell. This is the bugdump.</p>
<p class="list-1">• <B>Dealing with the Bugdump</B></p>
<p class="list-2">• First, <B><I>look at it!</I></B> — especially the last several lines — this will often give you a good clue as to what the problem is, and you may be able to resolve it on your own.</p>
<p class="list-2">• Common Problems</p>
<p class="list-3">• <B><I>Can't find mash.py:</I></B> Make sure that you chdir to the Mopy directory first.</p>
<p class="list-2">• If that doesn't help, then go to the forums and post the whole bugdump. Preferably, you should post the dump in the <B><I>Relz/Help</I></B> topic (see <a href="#WryeMash" >Discussion</a> link at top of page) or you can start a new topic. Be sure to mention "Wrye Mash" in the text of the post.</p>
<p class="list-2">• <B><I>Hint:</I></B> Control-C does not work in the command line window, but you can still copy text from it by selecting the text, and then hitting the <B>Enter</B> key.</p>
<p class="empty"> </p>
<h2 class="header2" id="Usage">3.7 - Usage</h2>
<h3 class="header3" id="MorrowindInstallDirectory">3.7.1 - Morrowind Install Directory</h3>
<p class="list-1">• If you have a non-standard Morrowind Install directory, then the first time you start, Mash will ask for the correct location. In subsequent startups, Mash will remember the new directory and go directly to it without asking you.</p>
<p class="empty"> </p>
<h3 class="header3" id="Overview">3.7.2 - Overview</h3>
<p class="list-1">• The interface is divided into two tabs: <B><I>Mods and Saves.</I></B> Each of these is in turn divided into a list and a details view.</p>
<p class="list-1">• Commands are accessed through <B><I>context menus</I></B> which are invoked by right-clicking on either an item or a column heading. The image above shows the context menu for the mod list column header.</p>
<p class="list-1">• There is also a <B><I>Morrowind Launch</I></B> button at the left side of the status bar.</p>
<p class="empty"> </p>
<h2 class="header2" id="InstallersTab">3.8 - Installers Tab</h2>
<p>The Installers tab provides a mod package installer facility (called Bain). It makes mod installation simpler, and perhaps more importantly, it makes mod UN-installation simple and safe. It's also useful for resolving resource file conflicts between different mods.</p>
<p class="empty"> </p>
<p>Bain has been backported from Wrye Bash — hence the name "Bain", aka Bash Installers. (Yes, I probably should call it "Main", but that would be too boring.) If you're familiar with Timeslip's OBMM or MWMM, then Bain is fairly similar, but has some substantial advantages (and some disadvantages) compared to them. For a comparison, see <a href="http://www.uesp.net/wiki/Tes4Mod:Wrye_Bash/Bash_vs._OBMM" >Bash vs. OBMM</a>.</p>
<p class="empty"> </p>
<p>Note that if you have been using the <a href="#ManageTextureReplacers" >Replacers Feature</a>, then you should upgrade/switch to using Bain instead, since Bain completely supercedes Replacers.</p>
<p class="empty"> </p>
<h3 class="header3" id="GettingStarted">3.8.1 - Getting Started</h3>
<p>Here's a brief getting started guide. You may have to read sections further down before this section makes full sense.</p>
<p class="list-1">• <B>Terminology: Package</B></p>
<p class="list-2">• A "package" is a collection of esps, esms and/or resource files. Everything listed under the Installers tab is a package. Packages can be either archive files in (zip, 7z or rar format) or directories (aka <a href="#ProjectPackages" >Projects</a>).</p>
<p class="list-1">• <B>Initialization</B></p>
<p class="list-2">• When you first visit the Installers tab after starting Mash, Bain will need to go through an initialization process. If you've done this before, and no new packages are installed, and the machine is "warm", then it will take on the order of ten seconds.</p>
<p class="list-2">• However, if you have just added a bunch of packages, then Bain will take longer to initialize, since it will need to scan all new/modified packages.</p>
<p class="list-2">• <B><I>In particular, the first time you start Bain, it will take a long time (on the order of three to ten minutes) to initialize.</I></B> Enjoy your coffee break. :D</p>
<p class="list-1">• <B>Reducing Init Times</B></p>
<p class="list-2">• You can disable Bain entirely by unchecking "Enabled" in the column context menu on the Installers tab. (Note that this does <B><I>not</I></B> erase previously stored info. I.e. it's safe to disable Bain and then later re-enable it if you prefer.)</p>
<p class="list-2">• You can choose to "Avoid on Startup" (again from column context menu). This will cause Mash to try to avoid the Installers tab when it starts up. And since Bain won't initialize until you visit the Installers tab, you'll save a bit of time if you weren't planning on visiting it anyway.</p>
<p class="list-1">• <B>Install Directory</B></p>
<p class="list-2">• As noted below, Bain looks for packages in the <B>Morrowind\Installers</B> directory. Easiest way to get started with Bain is to just grab all your old mod archives and move them to the Installers directory. Then return to the Installers directory to see Bain's evaluation.</p>
<p class="list-2">• If you're a modder with existing project directories, you can move those to the Installers directory too.</p>
<p class="list-1">• <B>Reviewing Package Status</B></p>
<p class="list-2">• Some packages may be green, but most (even ones that you have previously installed) will likely be red. (Even if you have installed a package, Bain's <a href="#DocFileSweeping" >Doc File Sweeping</a> means that some files will be in unexpected places.</p>
<p class="list-2">• For each package, you can select it, and then review its details in the Debug text box. In particular, look for Missing and Overridden files.</p>
<p class="list-2">• You can install package as desired (though you may want to change their <a href="#Ordering" >order</a> first.)</p>
<p class="list-2">• For complex packages, you will likely want to configure their sub-packages before activating them.</p>
<p class="list-2">• For packages with unrecognized structure (grey checkbox and name), you'll need to restructure the package's directories and files to something more like what Bain expects before you can install them.</p>
<p class="empty"> </p>
<h3 class="header3" id="Overview1">3.8.2 - Overview</h3>
<p>Bain will search for and display packages from the (new) <B>Morrowind\Installers</B> directory. Mods (either archives or projects) can then be installed or uninstalled, and their status can be reviewed in the details pane on the right.</p>
<p class="list-1">• <B>Checkmarks</B></p>
<p class="list-2">• Installed packages will be marked with a "+".</p>
<p class="list-1">• <B>Icon Colors</B></p>
<p class="list-1"> Icon colors indicate the degree to which the package is synchronized with the Morrowind\Data Files directory:</p>
<p class="list-2">• Green: Package is fully synced. Note that a package can be green even if it is not "Active". E.g. if you have two identical packages and one is (fully) installed, then it will be green and checked. But the identical package will also be green — since it too is fully synced with the data directory.</p>
<p class="list-2">• Red: Some files in the package are missing from the data directory.</p>
<p class="list-2">• Orange: All package files are present in the data directory, but some esps/esms are not identical. (E.g. another package installed an alternative version of that file, or the user modified the file after installation.)</p>
<p class="list-2">• Yellow: All package files are present in the data directory, but some resource files are not identical. (E.g. another package installed an alternative version of that file, or the user modified the file after installation.)</p>
<p class="list-2">• White: This is relatively rare. It just means that the package is configured in a way that it has no files to install. This can happen for complex packages where none of the sub-packages are checked.</p>
<p class="list-2">• Grey: This indicates that the package has a structure that Bain does not recognize, and so cannot install.</p>
<p class="list-2">• Red X: The package is corrupt and/or incomplete. You'll likely see this for packages that you are currently downloading into the Installers directory.</p>
<p class="list-1">• <B>Icon Shape</B></p>
<p class="list-2">• Diamond: A <a href="#ProjectPackages" >project</a>, i.e. a subdirectory in the Installers directory.</p>
<p class="list-2">• Square: A mod package archive. Note that only rar, 7z and zip formats are supported.</p>
<p class="list-1">• <B>Text Colors</B></p>
<p class="list-2">• Blue: Indicates a package with sub-packages. The files to be installed, and thus the install state of the package will depend on which sub-packages you have activated.</p>
<p class="list-2">• Grey: This indicates that the package has a structure that Bain does not recognize, and so, cannot install.</p>
<p class="list-1">• <B>Text Background</B></p>
<p class="list-2">• Orange: Indicates that the install is dirty. This will occur for packages for which the configuration has been altered (either by altering active sub-packages and esmps, or by altering the package itself). This can be repaired by running Anneal or Anneal All.</p>
<p class="list-2">• Yellow: Indicates that the package has "underrides" i.e. some of its installed files <I>should</I> be overridden by higher order packages. This may happen after reordering mods that have already been installed. It can be repaired by running Anneal or Anneal All.</p>
<p class="list-2">• Grey: Indicates that some files present in the package will <B><I>not</I></B> be installed. This is usually due to a complex structure that is only partially handled by Bain, but can also be due to having files that Bain refuses to install (exe's, dlls, sub-archives, etc.)</p>
<p class="empty"> </p>
<h3 class="header3" id="PackageDetails">3.8.3 - Package Details</h3>
<p>Details for the currently selected package will be show on the right. There are (currently) three fields here:</p>
<p class="list-1">• <B>Info Tabs</B></p>
<p class="list-1"> The tabs at the top display several types of information relevant to the current mod. Note that much of this information is dependent on the install status of the mod and sometimes its order.</p>
<p class="list-2">• General: Shows summary info and the files to be installed — as determined by sub-package, esp/m, voice filtering, etc.</p>
<p class="list-2">• Matched: Shows files which are identical to current data directory files.</p>
<p class="list-2">• Missing: Files which are missing from the data directory.</p>
<p class="list-2">• Mismatched: Files which are present in the data directory, but which aren't identical to the package's version of those files.</p>
<p class="list-2">• Conflicts: Shows which other packages will conflict the current package and for what files. Note that if a given file is mismatched, but the mismatch isn't due to other packages, then it won't appear. This report can be modified to show inactive conflicts and/or lower order conflicts through <a href="#PackageHeaderCommands" >Package Header Commands</a>.</p>
<p class="list-2">• Underridden: Shows packages which <I>should</I> be overridden, but are not, due to install order errors. This can be corrected by running Anneal or Anneal All.</p>
<p class="list-2">• Dirty: Shows files which the package previously installed, but which now should be removed or altered due to a reconfiguration of the package. Dirty files can be cleared by running Anneal or Anneal All.</p>
<p class="list-2">• Skipped: Shows which files in the package were <a href="#SkippedFiles" >skipped</a> by Bain.</p>
<p class="list-1">• <B>Sub-Packages</B></p>
<p class="list-1"> This will be blank unless the package has sub-packages. You can determine which of these to install simply by checking the ones you want. Note that sub-packages are installed in the order they appear. So if different subinstallers have different versions of the same file, then the subinstaller that is later in the list (and active) will win.</p>
<p class="list-1">• <B>Esp/m Filtering</B></p>
<p class="list-1"> This tab can be used to filter out specific esps and esms from packages. This is intended for use with packages that provide alternate and optional mods. Note that Esp/m filtering is applied <I>after</I> sub-package filtering. E.g. it may be easier to turn off a sub-package entirely rather than disable individual espms from it.</p>
<p class="list-1">• <B>Comments</B></p>
<p class="list-1"> This is a field where you can enter comments about the package. Useful for keeping track of what the package is supposed to do, etc.</p>
<p class="empty"> </p>
<h3 class="header3" id="PackageStructure">3.8.4 - Package Structure</h3>
<p>Bain recognizes three package structures:</p>
<p class="list-1">• <B>Simple</B></p>
<p class="list-2">• If the package has esps, esms or bsa's at the top level, or if it has any of the regular Morrowind\Data Files subdirectories (e.g. Meshes, Textures) at that level, then it will be categorized as a simple package.</p>
<p class="list-1">• <B>Complex</B></p>
<p class="list-2">• If a package is not simple, but has subdirectories which appear simple (have esps/esms/bsas and/or have standard sub-directories), then it will be categorized as complex.</p>
<p class="list-2">• In this case, each top level subdirectory (that appears simple), will be treated as a sub-package, and you'll be able to activate or deactivate it as desired before installing.</p>
<p class="list-1">• <B>Complex/Simple</B></p>
<p class="list-2">• If a package is complex, but has only one sub-package, then it will appear as a simple package in the interface. (I.e. there will be no sub-package options.)</p>
<p class="empty"> </p>
<h3 class="header3" id="SkippedFiles">3.8.5 - Skipped Files</h3>
<p>Bain will skip over (never install) certain types of files in the package.</p>
<p class="list-1">• <B>Silent Skip</B></p>
<p class="list-1"> A few files are skipped silently. Files in this group are: Thumbs.db files, and the omod conversion directory and its subfiles.</p>
<p class="list-1">• <B>Directory Skipping</B></p>
<p class="list-1"> Bain will skip files from directories that it does not recognize. I.e. it will only install files that go directly into the Morrowind\Data Files directory or one of its regular subdirectories (Meshes, Textures, Sound, etc.). Files from irregular directories will be skipped. If this happens, you'll find them listed in the Skipped pane on the right.</p>
<p class="list-1">• <B>Extension Skipping</B></p>
<p class="list-1"> Bain will skip files with certain extensions - mostly executables (exe, dll, dlx) and subarchives (7z,zip, etc.). Again, these will be listed in the debug pane on the right. (But only if they're not already skipped because of the directory that they're in.)</p>
<p class="empty"> </p>
<h3 class="header3" id="DocFileSweeping">3.8.6 - Doc File Sweeping</h3>
<p>In order to prevent clutter and centralize doc file storage, Bain will sweep files that appear to be doc files into Morrowind\Data Files\Docs. Also, files named simply readme.txt (or readme.doc, etc.) will be renamed according to the package name before being swept into the Docs directory.</p>
<p class="empty"> </p>
<h3 class="header3" id="Ordering">3.8.7 - Ordering</h3>
<p>Bain assigns an install order to all packages. When packages are installed and/or uninstalled, the order is considered in determining which files will actually be installed/uninstalled.</p>
<p class="list-1">• <B>General</B></p>
<p class="list-2">• Install order is shown the table in the "Order" column.</p>
<p class="list-2">• All packages are moved to just before the ==Last== marker when Bain first encounters them.</p>
<p class="list-2">• Order can be changed by right clicking on a package (or group of selected packages) and selecting "Move To". Just enter the position to which the packages should be moved. If you're moving many packages at once, they'll keep their relative order, with the "oldest" moving to the specified position, and the others following after it.</p>
<p class="list-1">• <B>Last</B>_</p>
<p class="list-2">• Last is a special marker entry that Bain automatically adds to the archive list. It corresponds to the position at which any newly encountered packages are inserted. if you want specific packages (e.g. your personal projects) to always have high order, then move them to <I>after</I> the ==Last== marker.</p>
<p class="list-1">• <B>Install Order</B></p>
<p class="list-2">• When you install a package, then the order of higher packages will be respected. I.e. if the package being installed conflicts with a higher order package that's already active, then it <B><I>won't overwrite</I></B> the files from the higher package. Rather, only the files that don't conflict with higher packages will be installed. (However, if you want to overwrite later packages, then you can use the "Install Last" command, which will move the selected packages to the end of the list and then install them.)</p>
<p class="list-1">• <B>Uninstall Order</B></p>
<p class="list-2">• Uninstalling a package will also respect order. Specifically, files that are owned by higher order packages will be left in place. More than that, files that <I>aren't</I> owned by the package being uninstalled will also be left in place. (Hence manually edited mods and files will be left in place.)</p>
<p class="list-2">• Also, if a lower order package installed an identical version of a given file, then that file will not be removed. (I.e. ownership will cede to the lower order file.)</p>
<p class="list-2">• By the way, you can "uninstall" packages that aren't active. This is useful for cleaning out the files from packages that you have previously installed.</p>
<p class="list-1">• <B>Auto-Annealing</B></p>
<p class="list-2">• When you uninstall packages, Bain will also attempt to "anneal" the file system by restoring any files from active packages that were previously blocked by the packages being uninstalled. If you prefer that Bain <I>not</I> auto-anneal files, then you can deactivate "Auto-Anneal" from the context menu of the column header.</p>
<p class="empty"> </p>
<h3 class="header3" id="ModNameAliasing">3.8.8 - Mod Name Aliasing</h3>
<p>If you make a practice of renaming your installed espm files (as I do), then Bain will not be able to match the mod in the package to the installed file. So to adjust for that, you can define a mod aliasing database.</p>
<p class="list-1">• <B>Setup</B></p>
<p class="list-2">• After installing Mash, look for Data Files\Mash\Official_Local_default.csv, and copy it to "Official_Local.csv" in the same directory.</p>
<p class="list-1">• <B>Updating</B></p>
<p class="list-2">• Open "Official_Local.csv" in your favorite spreadsheet program. Note that the file format is csv (comma separated values). <B><I>When making changes be sure to save it in the same CSV format (with comma separators)!</I></B></p>
<p class="list-2">• You'll see that the file has two columns.</p>
<p class="list-3">• On the left is "Official" which is the "official" name of the mod, i.e. the name of the mod that you'll find in the archive package that you downloaded.</p>
<p class="list-3">• On the right is "Local", which is the "local" name of the mod, i.e. the name you prefer for the mod.</p>
<p class="list-3">• The way this works is simple — when mash encounters a mod with a specified official name, it will map it to the local name. All install, uninstall, etc. commands will then act as if the file in the mod actually had the local name.</p>
<p class="list-2">• So to define entries, the easiest thing to do is:</p>
<p class="list-3">• Open Mash and go to the Installers tab. Find a mod for which you have changed the name.</p>
<p class="list-3">• Go to the Missing tab, select and copy the name of the missing mod, then paste that into the Official column.</p>
<p class="list-3">• Go to the Mods Tab, select the mod and copy it's name from the detail view on the right and paste that into the Local column next to the official name.</p>
<p class="list-3">• Save changes to the csv file. (Be sure to save in CSV format!)</p>
<p class="list-3">• Return to Mash Installers tab. Mash should immediately recognize the updated file and adjust for its changes.</p>
<p class="list-2">• Of course, you don't have to change mods one at a time. You can do a bunch at once and then save the file, then return to Mash/Bain.</p>
<p class="empty"> </p>
<h3 class="header3" id="PackageCommands">3.8.9 - Package Commands</h3>
<p>The following commands are available from context menu of packages.</p>
<p class="list-1">• <B>File</B></p>
<p class="list-2">• <B>Open:</B> Open package(s) in the file system.</p>
<p class="list-2">• <B>Duplicate:</B> Duplicate package.</p>
<p class="list-2">• <B>Delete:</B> Delete the package(s).</p>
<p class="list-1">• <B>Archive Info</B></p>
<p class="list-2">• <B>Refresh:</B> Refreshes all info for selected packages. Useful for updating info when package has been modified outside of Mash.</p>
<p class="list-2">• <B>Move To...</B> Moves selected packages(s) to specified position. If multiple packages are active, they'll retain their relative order, but move as a block to the selected position.</p>
<p class="list-1">• <B>Configuration</B></p>
<p class="list-2">• <B>Has Special Directories:</B> Ordinarily, Bain will only recognize a limited set of subdirectories of the Data directory — and files that come from other directories will be skipped over. However if a package has special directories (usually restricted to OBSE scripts), checking this option will cause Bain to recognize these special directories as valid subdirectories (and thus allow them to be installed).</p>
<p class="list-1">• <B>Install</B></p>
<p class="list-2">• <B>Anneal:</B> Will "anneal" the selected file(s). This will install any missing files and correct any install order errors (aka "underrides").</p>
<p class="list-2">• <B>Install:</B> Will do an "in-order" install. I.e. it will fully install the package except for files that are masked by higher order packages.</p>
<p class="list-2">• <B>Install Missing:</B> The same as Install, except that it only installs missing files — i.e. it will not override any currently existing files.</p>
<p class="list-2">• <B>Install Last:</B> Moves the package to the end of the order list and installs it.</p>
<p class="list-2">• <B>Uninstall:</B> Uninstalls the package. If Auto-Anneal is active, then files from lower order packages will automatically be restored as necessary.</p>
<p class="list-1">• <B>Project</B></p>
<p class="list-2">• <B>Unpack to Project:</B> (Archives only.) Unpack the archive to a project.</p>
<p class="list-2">• <B>Sync from Data:</B> (Projects only.) Synchronize the project with files from the Morrowind\Data Files directory. This is essentially the reverse of "Install" for projects since it copies from the Morrowind\Data Files directory to the project rather than the other way around.</p>
<p class="empty"> </p>
<h3 class="header3" id="PackageHeaderCommands">3.8.10 - Package Header Commands</h3>
<p>The following commands are available by right clicking on the column header of the Installers tab:</p>
<p class="list-1">• <B>Sorting</B></p>
<p class="list-2">• <B>Sort by Active:</B> Active installers will be sorted to the top.</p>
<p class="list-2">• <B>Projects First:</B> If this is checked, then project packages will be sorted to the top of the table.</p>
<p class="list-1">• <B>Actions:</B></p>
<p class="list-2">• <B>Open:</B> Opens the Installers directory in Windows Explorer.</p>
<p class="list-2">• <B>Refresh Data:</B> Rescans the Data directory and all project directories. Since this operation takes a little while, this scan is ordinarily done only once per Mash session. So, if you have manually edited the directories after that one-time scan, you should run this command to update Bain to the changes.</p>
<p class="list-2">• <B>Full Refresh:</B> This does a full refresh of all data files. Notably this will recalculate CRCs for all files (ordinarily CRCs are only calculated for files that seem to have changed). Running this command will likely take 5-15 minutes.</p>
<p class="list-2">• <B>Anneal All:</B> This will install any missing files (for active installers) and correct all install order and reconfiguration errors.</p>
<p class="list-1">• <B>Availability</B></p>
<p class="list-2">• <B>Avoid at Startup:</B> Toggles Mash to avoid the Installers tab on startup, thus avoiding unnecessary data scanning. Unless you're spending a lot of time in the Installers tab, you should Enable this.</p>
<p class="list-2">• <B>Enabled:</B> This enables/disables Bain itself. Preferred setting: Enabled (checked).</p>
<p class="list-1">• <B>Behavior</B></p>
<p class="list-2">• <B>Clean Data Directory:</B> If this is checked, then any empty subfolders of the Morrowind\Data Files directory will be deleted.</p>
<p class="list-2">• <B>Show Inactive Conflicts:</B> If checked, then the conflicts report will show conflicts with inactive as well as active mods. Usually only active conflicts are of interest, however sometimes its useful to review all conflicting packages.</p>
<p class="list-2">• <B>Show Lower Conflicts:</B> If checked, then the conflicts report with show conflicts with lower order packages. If you're only interested in higher order conflicts, the uncheck this to remove some clutter from the report.</p>
<p class="empty"> </p>
<h2 class="header2" id="ModsTab">3.9 - Mods Tab</h2>
<p><img src="img/Wrye Mash_01.png" width="723" height="535" alt="Mods Tab"></p>
<p class="empty"> </p>
<h3 class="header3" id="ModsList">3.9.1 - Mods List</h3>
<p class="list-1">• <B><I>Sorting</I></B></p>
<p class="list-2">• Sort Mod list items by (left) clicking on a column header, or by using the sort submenu of the column popup menu.</p>
<p class="list-2">• Reverse a sort by redoing it. E.g., left click on the File column header twice in a row.</p>
<p class="list-3">• "Load Order" is the exception — it will always appear in correct order.</p>
<p class="list-2">• Force ESMS to the top of the list by selecting "Sort by Type" from the context menu.</p>
<p class="list-2">• Force selected mods to the top of the list by selecting "Sort by Selection" from the context menu.</p>
<p class="list-1">• <B><I>Selecting Load Mods</I></B></p>
<p class="list-2">• Select load mods by clicking on the checkbox next to their file name.</p>
<p class="list-2">• Note: When a mod is selected, its master mods will also be selected.</p>
<p class="list-2">• Conversely, when an esm is unselected, any mods that depend on it will also be unselected.</p>
<p class="list-1">• <B><I>Line Colors</I></B></p>
<p class="list-2">• <B><I>Blue:</I></B> An esm file.</p>
<p class="list-2">• <B><I>Pink:</I></B> A file that shares a modification date/time with another file. Not a problem unless they're both selected, in which case, the lines turn...</p>
<p class="list-2">• <B><I>Red:</I></B> A file that shares a modification date/time with another file — with both files being selected. This should definitely be corrected! Use details view to change the modification date of one of the files by a second or more.</p>
<p class="list-2">• <B><I>Orange:</I></B> Overloaded Exclusion Group (See below.)</p>
<p class="list-1">• <B><I>Checkbox Colors</I></B></p>
<p class="list-2">• Checkbox colors indicate the "health" of the mod file's master files. See <a href="#MasterListUpdating" >Master List Updating</a> below. Basically, with mod files, you're okay unless the checkbox is red — which indicates that a master file is missing.</p>
<p class="list-1">• <B>Exclusion Groups</B></p>
<p class="list-2">• Oftentimes users will have different versions of the same mod, or different mods which do the same sort of thing in an incompatible way. Exclusion groups can be used to help flag these mods so that you don't accidentally load more than one at once. When an exclusion group is violated, all violating mods will be highlighted in orange.</p>
<p class="list-2">• Defining an exclusion group is easy — just change the name of the mod to include a comma. The part of the name before the comma is the exclusion group.</p>
<p class="empty"> </p>
<h3 class="header3" id="ModDetails">3.9.2 - Mod Details</h3>
<p class="list-1">• Make changes to the file in the details view.</p>
<p class="list-1">• <B><I>File Name</I></B> Change the file name.</p>
<p class="list-2">• Note that changes to the file name are <B><I>not</I></B> automatically reflected in any mods that have the current mod as their master. See Doubling below.</p>
<p class="list-1">• <B><I>Modification Time</I></B> Change the file modification time.</p>
<p class="list-2">• Note that this affects file order. See Doubling below.</p>
<p class="list-1">• <B><I>Author</I></B> Change the author name.</p>
<p class="list-1">• <B><I>Description</I></B></p>
<p class="list-2">• Edit the mod description.</p>
<p class="list-1">• <B><I>Masters List</I></B></p>
<p class="list-2">• The masters list show the esm files that the current mod depends on, and the load order (modIndex) of that master.</p>
<p class="list-2">• While there's rarely a need to edit the masters of a mod, if the need does arise, you can use the masters list to do so. <B><I>It is recommended that you be familiar with editing masters of save games before you attempt to edit masters of mods.</I></B></p>
<p class="list-2">• For more information, see <a href="#ModUpdating" >Mod Updating</a> below.</p>
<p class="empty"> </p>
<h3 class="header3" id="UsingLoadLists">3.9.3 - Using Load Lists</h3>
<p><img src="img/Wrye Mash_03.png" width="395" height="216" alt="Using Load Lists"></p>
<p class="list-1">• Aside from using checkboxes to select and unselect mods, you can also use load lists. These are accessed through the column context menu.</p>
<p class="list-1">• <B><I>None:</I></B> Unselects all files.</p>
<p class="list-1">• <B><I>Save List...</I></B> Saves your currently selected files to a new load list.</p>
<p class="list-1">• <B><I>Edit Lists...</I></B> Allows you to delete and rename previously defined load lists.</p>
<p class="list-1">• <B><I>[Load List]</I></B> Selecting a load list causes all of its files to be selected.</p>
<p class="list-1"> This action is not exclusive, but <I>additive</I> — i.e., the files will be selected <I>in addition</I> to the currently selected files.</p>
<p class="empty"> </p>
<h3 class="header3" id="FileCommands">3.9.4 - File Commands</h3>
<p><img src="img/Wrye Mash_04.png" width="361" height="222" alt="File Commands"></p>
<p class="list-1">• <B><I>File Operations</I></B></p>
<p class="list-2">• <B><I>Backup</I></B> Create a backup of the file. Note that backups are also automatically created (see "Revert to Backup" below). If you want to be sure that you can late restore from a specific point, use Duplicate or Snapshot instead.</p>
<p class="list-2">• <B><I>Duplicate</I></B> Creates a duplicate of the file in the mods directory.</p>
<p class="list-2">• <B><I>Snapshot...</I></B> Creates a snapshot copy of the current mod in a subdirectory (Mash\Snapshots).</p>
<p class="list-3">• Snapshots are indicated by appending to "-l.n.m" to the root of the file name. E.g., "My.esp" becomes "My-01.esp" or "My Mod v1.01.esp" becomes "My Mod v1.01-01.esp".</p>
<p class="list-3">• Note that Mash will automatically generate the next available snapshot number. However, you are free to choose a different number if you like.</p>
<p class="list-3">• Also, if there's an existing version line (e.g., "Version NN.MM-LL") in the description field of the mod, then it will update with the new version plus snapshot number when the snapshot is saved.</p>
<p class="list-2">• <B><I>Delete</I></B> Deletes the file... <B><I>Permanently.</I></B></p>
<p class="list-3">• Also deletes all backups and temp files, but <B><I>not</I></B> snapshots.</p>
<p class="list-2">• <B><I>Hide</I></B> Moves the file to a subdirectory (Mash\Hidden).</p>
<p class="list-3">• Use this on seldom used mods to keep them from cluttering the mods listing.</p>
<p class="list-3">• This is especially useful when modding, since the TESCS Data Files list cannot be sorted.</p>
<p class="list-3">• Note that there's a corresponding "Unhide..." command in the column context menu.</p>
<p class="list-3">• If the file's group is defined (e.g. Heads), and if the Mash\Hidden directory has a subdirectory with the same name (e.g. Mash\Hidden\Heads), then the file will be hidden in it.</p>
<p class="list-2">• <B><I>Sort</I></B> Reorders selected mods to make them sort in alphabetical order.</p>
<p class="list-3">• Modified time of first mod is set to earliest modified time of set. Other mods follow it at one minute increments.</p>
<p class="list-3">• <B><I>WARNING: Some mods must be loaded in a certain order (e.g., a patch mod must be loaded after the original). Sort may break that required ordering! Use sort with extreme caution! Note too that there is no "undo" command for sort!</I></B></p>
<p class="list-2">• <B><I>Revert to Backup</I></B> Reverts the file to the last Backup made of it.</p>
<p class="list-3">• Mash will make a backup of a file the first time it is significantly changed in an application session.</p>
<p class="list-3">• E.g., if you make two or three changes to a file in a given application session, then only the first change will generate a backup.</p>
<p class="list-2">• <B><I>Revert to First Backup</I></B> Same as Revert to Backup, only it reverts to the very first backup that Mash made of the file.</p>
<p class="list-3">• The first backup is generated the first time that Mash alters a file, and is never overwritten. Hence it is guaranteed to be free of any problem that Mash might introduce.</p>
<p class="list-3">• Of course, this also may mean that it's badly out of date!</p>
<p class="list-2">• <B><I>Revert to Snapshot</I></B> Reverts the file to a selected snapshot.</p>
<p class="empty"> </p>
<h3 class="header3" id="Usingmlox">3.9.5 - Using mlox</h3>
<p class="list-1">• If Mlox is installed somewhere within the Morrowind directory, you will be able to use mlox with Wrye Mash</p>
<p class="list-2">• They are accessed through the mod context menu</p>
<p class="list-2">• <B><I>Launch Mlox</I></B> lanuches mlox (You must have mlox.exe in Mopy/mlox)</p>
<p class="list-2">• <B><I>Sort Using Mox</I></B> sorts your load list using the mlox rules</p>
<p class="list-2">• <B><I>Revert Changes</I></B> reverts the load order to how it was before you sorted it</p>
<p class="empty"> </p>
<h3 class="header3" id="Usingtes3cmd">3.9.6 - Using tes3cmd</h3>
<p class="list-1">• If tes3cmd is installed in the Morrowind directory or Data Files directory, you will be able to use tes3cmd with Wrye Mash</p>
<p class="list-2">• To use the *clean* command, select any number of mods, right click select Tes3cmd > Clean</p>
<p class="list-2">• To use the *Fixit* command, open the mod context menu and select Tes3cmd > Fixit</p>
<p class="empty"> </p>
<h3 class="header3" id="ExportImportDialog">3.9.7 - Export/Import Dialog</h3>
<p class="list-1">• From the mods context menu, select <B><I>Export: Dialog</I></B> to export all dialog</p>
<p> text to a file, or select <B><I>Import: Dialog</I></B> to reimport dialog text from a file.</p>
<p class="list-2">• The purpose of these functions is to facilitate spellchecking and general text editing. Accordingly, <B><I>only the text of the dialog is exported.</I></B> (I.e., this is a more focused dialog export/import than the similar TESCS function.)</p>
<p class="list-1">• <B><I>Format</I></B></p>
<p class="list-2">• Exported text is sorted by speaker/topic. However, imported text may be in any order, and can be trimmed to a subset of the originally exported set of entries.</p>
<p class="list-2">• Lines beginning with '#' signs are comments and are ignored. Feel free to add additional comment lines to the exported file — they'll be ignored in import.</p>
<p class="list-2">• Lines beginning with '@' encode the dialog type, topic and info entry number. <B><I>Do not alter these lines!</I></B></p>
<p class="list-1">• <B><I>Trimming</I></B></p>
<p class="list-2">• Text is automatically trimmed to some degree on import...</p>
<p class="list-2">• Leading and trailing spaces and new lines are trimmed.</p>
<p class="list-2">• Some characters are replaced or deleted: curly quotes are straightened; single character ellipses are replaced with multi-character ellipses; reserved characters (@, #) are deleted.)</p>
<p class="list-2">• Any remaining text over 511 bytes will be trimmed. If such trims are made, a window will popup detailing them.</p>
<p class="empty"> </p>
<h3 class="header3" id="ExportImportScripts">3.9.8 - Export/Import Scripts</h3>
<p class="list-1">• These paired commands will export all scripts in a mod to a text file, and then subsequently reimport them.</p>
<p class="list-1">• Note that after importing, you must manually recompile (in TESCS) any scripts that have been changed.</p>
<p class="empty"> </p>
<h3 class="header3" id="ImportLCVSchedules">3.9.9 - Import LCV Schedules</h3>
<p class="list-1">• Generates LCV schedule scripts from an LCV schedule text file, and inserts the scripts into the current mod file.</p>
<p class="list-2">• <B><I>Note: This feature is only useful for modders working with LCV Schedules.</I></B></p>
<p class="list-1">• <B><I>Schedule Generation Steps</I></B></p>
<p class="list-2">• Generate the text file.</p>
<p class="list-3">• The current LCV release includes its source text file. This can be used as example when developing the schedule for a new location, or as starting point, when modifying an existing schedule.</p>
<p class="list-3">• The source text file must contain the complete schedule for at least one location.</p>
<p class="list-2">• Select the esp to import schedules to and use the Import: LCV Schedules command on it.</p>
<p class="list-2">• Open the esp in TESCS and make in extra modifications that are required:</p>
<p class="list-3">• Be sure to include the current LCV Schedules esp in your load list.</p>
<p class="list-3">• Add state variables (SC_TownName_State)</p>
<p class="list-3">• Add scriptholders for the master scripts, and place them as needed.</p>
<p class="list-4">• Id: SC_TownName</p>
<p class="list-4">• Name: TownName Schedule</p>
<p class="list-4">• Model: EditorMarker.nif</p>
<p class="list-4">• Script: SC_TownName_Master</p>
<p class="list-3">• Add any extra items needed. E.g., boats for fishermen, etc.</p>
<p class="list-2">• Compile scripts, either manually or by using the <B><I>Recompile All</I></B> command.</p>
<p class="list-3">• If you only imported a schedule for one town, then recompiling by hand is probably simplest.</p>
<p class="list-3">• If you imported schedule for several towns, then <B><I>Recompile All</I></B> is probably best.</p>
<p class="list-3">• Errors in your schedule files are most likely to show up during the compile process. To fix them, go back and fix your text file, then re-import and recompile.</p>
<p class="list-2">• Save esp</p>
<p class="list-3">• Note that <B><I>Recompile All</I></B> typically recompiles several base Morrowind scripts: DagothUrCreature1, EndGame, Float and LorkhanHeart. After you save, you should use the Details view to delete these modified scripts from your esp. Then reload the esp and save again to completely eliminate these bogus scripts.</p>
<p class="empty"> </p>
<h3 class="header3" id="ImportMergedLists">3.9.10 - Import Merged Lists</h3>
<p class="list-1">• <B><I>Overview</I></B></p>
<p class="list-2">• Leveled lists determine what creatures you will encounter and what items you will find in various containers. Mods that add creatures or items to the world generally modify these lists. However, if two or more mods modify the same list, then the last mod to load will delete any additions/changes made be previous mods.</p>
<p class="list-2">• This function combines changes made to the same leveled lists from different mods and saves the combined list to the current mod.</p>
<p class="list-1">• <B><I>Usage</I></B></p>
<p class="list-2">• <B><I>This function is only available for mods whose author is "Wrye Mash".</I></B> This is a safety feature to prevent overwriting the load lists of a normal mod.</p>
<p class="list-3">• If you don't have such a mod available, then <B><I>start by copying "Mashed Lists.esp"</I></B> from Mopy\Extras to the Data Files folder.</p>
<p class="list-3">• Note that you may want to have <B><I>different versions of the Mashed List esp</I></B> for different load sets. If this is the case, just duplicate one Mashed List esp and rename it as desired.</p>
<p class="list-2">• If you have a copy of <B><I>Merged_Leveled_Lists.esp</I></B> (produced by TesTool), then remove it from your load list. You won't need it anymore. Note too that you won't need to use the <B><I>Leveled List Resquencer</I></B> tool. The Import Merged List lists are already resequenced.</p>
<p class="list-2">• <B><I>Make sure you have your full load list loaded, then right click on the "Mashed Lists" esp and select "Import: Merged Lists".</I></B></p>
<p class="list-2">• Don't forget to update the masters on your save game when you're done.</p>
<p class="list-1">• <B><I>Tech Notes</I></B></p>
<p class="list-2">• Mash's Merge List function is a bit more efficient that TesTools — if there's no need to merge lists, then it won't.</p>
<p class="list-2">• In merging lists, Mash ignores lists from any of the three Bethesda Masters, under the assumption that anything in them will also be in any plugin that tries to modify them.</p>
<p class="list-2">• In merging lists, Mash ignores any mod whose author is "Wrye Mash".</p>
<p class="list-2">• When merging two lists:</p>
<p class="list-3">• <I>Chance None</I> is set to Chance None of last mod to change list.</p>
<p class="list-3">• <I>Calculate for Each Item</I> is true if it's true for either list.</p>
<p class="list-3">• <I>Calculate from All Levels</I> is true if it's true for either list.</p>
<p class="list-3">• All entries from the first list, plus any new items in the second list will be included in the merged list.</p>
<p class="list-3">• A deletion of a leveled list will be ignored unless the deletion comes from the last mod to modify that list.</p>
<p class="empty"> </p>
<h3 class="header3" id="ImportReplacer">3.9.11 - Import Replacer</h3>
<p class="list-1">• <B><I>Overview</I></B></p>
<p class="list-2">• Ref replacers allow you to systematically replace one set of references with another. For example you can "NOMify" a mod that adds towns by systematically replacing empty bottles with equivalent NOM bottles; and static ovens, grills, cauldrons and kegs with equivalent NOM activators.</p>
<p class="list-1">• <B><I>Setup</I></B></p>
<p class="list-2">• Select Import: Edit Replacers, and use the resulting dialog to add a replacer file. Be sure that the file that you have selected is a replacer file!</p>
<p class="list-1">• <B><I>Usage</I></B></p>
<p class="list-2">• Select Import: [Replacer Name]. You'll receive a report on all replacements made and records imported.</p>
<p class="list-1">• <B><I>Tech Notes</I></B></p>
<p class="list-2">• The mod replacer file defines which object ids's are to be replaced and with what object ids, and (optionally) which source mod to copy records from.</p>
<p class="list-2">• If multiple replacements are defined, then each of the replacements objects will be used in turn. E.g. for NOM, the first morrowind kegstand will be replaced with a beer barrel, the second will be replaced with a wine barrel, etc.</p>
<p class="list-2">• If you define a source mod (srcmod), then the replacer will grab a copy of each object id used from the srcMod and copy it to the target mod. E.g., if the user only replaces bottles, then only bottle object definitions will be imported into the target mod. If you don't define a srcmod, then nothing will be imported.</p>
<p class="list-2">• In the mod, only the id of the placed object will be changed. Thus, the replacement should work at the coordinate/orientation used by the original, <B><I>and the original should not have extra info that is incompatible with the replacements type!</I></B></p>
<p class="list-2">• I.e., if the original is a soulgem and includes info on the type of soul included, then the replacement should not be anything but another soulgem.</p>
<p class="list-2">• This means that you have to know what you're doing when you're defining a replacement. (Probably the main limitation is not replacing soulgems or things that have uses.)</p>
<p class="list-2">• Be aware that ref replacement doesn't do any spell checking... So be sure that both the original and replacement items are spelled correctly.</p>
<p class="empty"> </p>
<h3 class="header3" id="RenumberRefs">3.9.12 - Renumber Refs</h3>
<p class="list-1">• This is an advanced feature intended to reduce the likelihood of <a href="http://www.uesp.net/wiki/Tes3Mod:Mod_Conflicts#Local_References" >local refs conflicts</a> between mods. It works by renumbering the local refs placed by the esp, so that instead of starting objectIndex numbers at 1, it starts them at some random number between 1,000 and 10,000 (or a user selected number between 1 and 100,000.)</p>
<p class="list-1">• <B><I>Notes</I></B></p>
<p class="list-2">• This feature is <B><I>experimental!</I></B> Seems okay so far, but it does something a little unexpected and perhaps Morrowind engine won't like that.</p>
<p class="list-2">• The main problem with doing this is that every time TESCS is used to edit the esp, it will renumber the object indexes starting from 1. So, this feature is best used by end users rather than by modders. (Since end users don't re-edit the esps.)</p>
<p class="list-2">• This command remembers the starting object index numbers for each mod. If used a second time on the same mod, it will default to the same starting index number it used last time. So, if you have to edit the esp with TESCS, just run the command again.</p>
<p class="list-1">• <B><I>Usage</I></B></p>
<p class="list-2">• [Optional] Duplicate the original mod and make changes to the duplicate rather than the original. If you're going to modify an esp that is already in use by save games, you'll need to do this (and create and use an updater) in order to prevent doubling.</p>
<p class="list-2">• After selecting the command, you can either accept the suggested first value (randomly chosen between 1,000 and 10,000), or manually enter a value between 1 and 100,000.</p>
<p class="empty"> </p>
<h3 class="header3" id="RepairRefs">3.9.13 - Repair Refs</h3>
<p class="list-1">• See <a href="#Doubling" >Doubling</a> below.</p>
<p class="empty"> </p>
<h3 class="header3" id="CopytoEsmEsp">3.9.14 - Copy to Esm/Esp</h3>
<p class="list-1">• Copies the esm to an esp and vice versa.</p>
<p class="empty"> </p>
<h3 class="header3" id="SortRecords">3.9.15 - Sort Records</h3>
<p class="list-1">• This sorts the file records so that they can be more easily found in the TESCS Details view.</p>
<p class="list-1">• <B><I>Ordering Details</I></B></p>
<p class="list-2">• TES files are only semi-ordered. Some records <B><I>must</I></B> be in a certain order, e.g. DIALs and their associated INFO's form a block. Other records seem to have a record preferred by TESCS/Morrowind, while other types of records are loosely intermixed (e.g., most object type records).</p>
<p class="list-2">• The sort record commands follows both the required and preferred record order rules, but also orders records more strictly by record type and by record id (when available, and when not in conflict with other rules). This stricter ordering makes records easier to find.</p>
<p class="list-1">• <B><I>Inherited Order</I></B></p>
<p class="list-2">• Records that are modifications of pre-existing records (i.e., records inherited from master esms and even from esps selected in the load list) will be reordered when TESCS saves the esp file so that the inherited records are moved to the top of their TESCS save group (e.g., the "most objects" group), in the order that TESCS originally saw them in — which is fairly disordered.</p>
<p class="list-2">• However, it seems to be safe to use the Sort Records command on the Bethesda esms themselves. (But don't be surprised if Mash hangs for a minute or so while sorting Morrowind.esm!) Once this is done, when saving your esp, the modified records will still be moved up, but at least they'll be ordered by record type and id.</p>
<p class="empty"> </p>
<h3 class="header3" id="Statistics">3.9.16 - Statistics</h3>
<p class="list-1">• Displays statistics for the file's record types.</p>
<p class="empty"> </p>
<h3 class="header3" id="Updaters">3.9.17 - Updaters</h3>
<p class="list-1">• See <a href="#Doubling" >Doubling</a>.</p>
<p class="empty"> </p>
<h2 class="header2" id="SavesTab">3.10 - Saves Tab</h2>
<p><img src="img/Wrye Mash_02.png" width="724" height="534" alt="Saves Tab"></p>
<p class="empty"> </p>
<h3 class="header3" id="SavesList">3.10.1 - Saves List</h3>
<p class="list-1">• <B><I>Checkbox Colors</I></B></p>
<p class="list-2">• Checkbox colors indicate the "health" of the mod file or save files master files. See <a href="#MasterListUpdating" >Master List Updating</a> below.</p>
<p class="empty"> </p>
<h3 class="header3" id="SaveDetails">3.10.2 - Save Details</h3>
<p class="list-1">• Make changes to the file in the details view.</p>
<p class="list-1">• <B><I>File Name</I></B> Change the file name.</p>
<p class="list-1">• <B><I>Save Name</I></B> Change the save name. This is the save name that appears in the in-game game load list.</p>
<p class="list-1">• <B><I>Masters List</I></B></p>
<p class="list-2">• The masters list show the esm and esp files that the current save game depends on, and the load order (modIndex) of that master. Editing the masters list of a save game is probably the most common use of Mash, since it is the action that is necessary to prevent doubling. For more information, see <a href="#ModUpdating" >Mod Updating</a> below.</p>
<p class="list-2">• <B><I>Copy List:</I></B> Right click on the column header of the master list and select this command to copy the list of masters to the clipboard.</p>
<p class="list-3">• This is useful for forum postings where you want help debugging your load list, or just want to show off how many mods you have loaded! Note that this list is more useful than the list in the morrowind.ini file, since it lists the mods in load order.</p>
<p class="list-3">• Copy list will also <B><I>include the version number</I></B> of the master if the description field of the master <B><I>includes a line like "Version ####".</I></B> Note that this is the same version labeling scheme that the Snapshot command uses.</p>
<p class="empty"> </p>
<h3 class="header3" id="Profiles">3.10.3 - Profiles</h3>
<p class="list-1">• You can now define several different savegame profiles and easily switch between them. Each <I>profile</I> consists of a set of savegames and a Morrowind.ini file.</p>
<p class="list-1">• Use the Profile menu (found on the column header context menu) to edit and switch between profiles.</p>
<p class="list-1">• If you wish to move savegame files between profiles:</p>
<p class="list-2">• Load the profile currently containing the savegames to be moved.</p>
<p class="list-2">• Select the files, then right click on the slected files and select <I>File: Move To...</I> Use the directory dialog to specify to select a destination profile (i.e., one of the subdirectories of Saves\Mash\Hidden).</p>
<p class="empty"> </p>
<h3 class="header3" id="FileCommands2">3.10.4 - File Commands</h3>
<p class="list-1">• Same as for <a href="#FileCommands" >Mods Tab: File Commands</a> above.</p>
<p class="list-1">• Except... <B><I>Hide</I></B> has been replaced with <B><I>Move To...".</I></B></p>
<p class="list-2">• Move To moves the selected save files to the specified directory. Usually this will be one of the subdirectories of Saves\Mash\Hidden, since these subdirectories correspond to your Profiles (see below).</p>
<p class="empty"> </p>
<h3 class="header3" id="Remove">3.10.5 - Remove</h3>
<p class="list-1">• There are several commands for removing different types of references and other data from save files.</p>
<p class="list-1">• <B><I>Debris Cells</I></B></p>
<p class="list-2">• This removes all references in cells that have been visited, but are not supported by the current set of masters. Typically this is used to cleanup exterior cells that were added by mods that have since been removed.</p>
<p class="list-2">• Note that if you have intentionally placed objects into such cells (e.g., a traveling ship), then those objects <B><I>will be lost!</I></B></p>
<p class="list-1">• <B><I>Spawned Creatures</I></B></p>
<p class="list-2">• This removes all lvcr (leveled creature) references from the file.</p>
<p class="list-2">• In other words, it resets all spawn points.</p>
<p class="list-2">• <B><I>Warning:</I></B> Some of the major creature/npc mods create herds of creatures and/or groups of NPCs. Typically only one of the npcs/creatures in these groups are associated with the spawn point. So resetting the spawn point only removes that single npc/creature. To fully clear npc/creature groups use a object list remover (see below).</p>
<p class="list-2">• For a savegame, this has the effect of resetting all spawn points.</p>
<p class="list-1">• <B><I>Removers (Object Lists)</I></B></p>
<p class="list-2">• Removers allow you to <B><I>remove all instances of arbitrary lists of objects from the game.</I></B> The only instances not removed will be those instances that reside in cells that match the list of "Safe Cells".</p>
<p class="list-2">• <B><I>Warning! If the remover that you use includes standard containers, you should be sure that your safe cells list includes you stash cells — e.g., your stronghold, mansion, etc.</I></B></p>
<p class="list-2">• <B><I>Setting up Removers:</I></B></p>
<p class="list-3">• First, select "Edit Safe Cells..." and make sure that your stash cells, e.g., stronghold, mansion, etc. are included in it. Note that a safe cell named "Balmora" would protect all cells whose name begins in "Balmora".</p>
<p class="list-3">• Next, select "Edit Removers..." and select one or more of the files in Mopy\Data. This will add that(those) file(s) to the list of removers. Close the edit box when done. The new remover will now appear on the remover menu.</p>
<p class="list-2">• <B><I>Using a remover:</I></B></p>
<p class="list-3">• Use the Remove: [Name of Remover] command on the savegame.</p>
<p class="list-2">• <B><I>Remover Files</I></B></p>
<p class="list-3">• You can easily create your own remover file...</p>
<p class="list-3">• Remover files are just plain text files, with each line listing an object to be removed. Blank lines and any text after a '#' character are ignored.</p>
<p class="list-3">• Objects to be removed should be first on the line and surrounded by quotes. Anything after that will be ignored.</p>
<p class="list-3">• Hint: if you use the export feature in TESCS, the resulting file will be in the right format to use as a remover. But be sure to edit it first! There are many unique and scripted objects which should not be reset in the game.</p>
<p class="empty"> </p>
<h3 class="header3" id="JournalBrowser">3.10.6 - Journal Browser</h3>
<p class="list-1">• Shows the journal entries for the selected save.</p>
<p class="list-1">• Note: <B><I>Journal browsing is a memory hog</I></B> and will slow down switching between save files! If you're not using it, close the window.</p>
<p class="empty"> </p>
<h3 class="header3" id="LoadMasters">3.10.7 - Load Masters</h3>
<p class="list-1">• This causes the save game's master files to be loaded.</p>
<p class="list-2">• Note that unlike Load Lists, this function is <B><I>exclusive, not additive.</I></B> I.e., <B><I>only</I></B> the masters of the save file will be selected.</p>
<p class="empty"> </p>
<h3 class="header3" id="MapNotes">3.10.8 - Map Notes</h3>
<p class="list-1">• From the saves context menu, select <B><I>Map Notes</I></B> to extract all of the notes that you have added to the map for that save game.</p>
<p class="list-1">• Map Note Tips:</p>
<p class="list-2">• Add map notes by double clicking anywhere on the map while viewing it.</p>
<p class="list-2">• Notes attached to a cell are visible from the map square for any door that leads to that cell. E.g., map notes placed in a cave will be visible not only while in that cave but in the landscape outside.</p>
<p class="list-2">• So, for caves, tombs, etc. place the note inside the cave if possible.</p>
<p class="empty"> </p>
<h3 class="header3" id="RepairAll">3.10.9 - Repair All</h3>
<p class="list-1">• See <a href="#Doubling" >Doubling</a> below.</p>
<p class="empty"> </p>
<h3 class="header3" id="UpdateMap">3.10.10 - Update Map</h3>
<p class="list-1">• Updates the world map to reflect added and removed landmasses. Use this after adding or removing mods with landmasses, and using Repair All.</p>
<p class="list-1">• Draws the borders around the visible map area.</p>
<p class="list-2">• Note that lands located outside of this area will never be drawn. I.e., if you're inside, you should see the land; if you're outside, you should see nothing but blue ocean.</p>
<p class="list-1">• Draws a grid with spacing of 5 cells centered on the center of the 0, 0 cell.</p>
<p class="list-2">• Want to use a COE (Center on exterior) console command? Now you can easily figure out what the coordinates are!</p>
<p class="list-2">• You can disable the gridline drawing by unchecking <B>World Map Gridlines</B> on the column header context menu. <I>However</I> if you've previously drawn the map with the gridlines enabled, you may still see some gridline remnants on the land masses that you've visited. These will not disappear until you re-visit the corresponding cells.</p>
<p class="list-1">• <B><I>Notes</I></B></p>
<p class="list-2">• If you see marked cells for landmasses that have been removed, try using <B>Repair All</B> first.</p>
<p class="empty"> </p>
<h3 class="header3" id="Review">3.10.11 - Review</h3>
<p class="list-1">• This is something of a miscellaneous function of uncertain use. Perhaps it will grow later. For now...</p>
<p class="list-1">• <B><I>Detached Global Scripts</I></B></p>
<p class="list-2">• This a list of global scripts that have a reference file with an invalid reference. This can happen normally, even with startup scripts, or it can happen as the result of mods being added or removed.</p>
<p class="list-2">• Most global scripts operate independently of references, but a few operate within the context of specific references (i.e., objects in the world). If Morrowind loses track of this reference, then it assigns an invalid reference to the script. So a script presence on this list <I>may</I> indicate problem.</p>
<p class="empty"> </p>
<h3 class="header3" id="Statistics3">3.10.12 - Statistics</h3>
<p class="list-1">• Displays statistics for the file's record types.</p>
<p class="empty"> </p>
<h2 class="header2" id="DocBrowser">3.11 - Doc Browser</h2>
<p class="list-1">• You can easily and quickly scan through your mod's document files (readme's) from the Doc Browser window. Supported doc types: text files, html and mht (html archives).</p>
<p class="list-1">• To show the Doc Browser window, select "Readme..." from the mod's context menu.</p>
<p class="empty"> </p>
<h3 class="header3" id="UsingtheDocBrowser">3.11.1 - Using the Doc Browser</h3>
<p class="list-1">• When you the Doc Browser is showing and you click on the name of a Mod in the Mods Tab, Mash will try to show the document for that mod in the Doc Browser window. If Mash does not know which document to associate with the mod, it will show a blank page.</p>
<p class="list-1">• To associate a document with a mod:</p>
<p class="list-2">• Select the mod in the Mods Tab.</p>
<p class="list-2">• Switch to the Doc Browser and click on "Set Doc..." and use the file dialog to find the document.</p>
<p class="list-1">• To disassociate a document with a mod:</p>
<p class="list-2">• Use "Set Doc..." again to pick a different doc. <B><I>Or...</I></B></p>
<p class="list-2">• Use "Forget Doc..."</p>
<p class="list-1">• To change the name of a document, click on the "Rename Doc..." button, and use the file dialog to pick a new name/location. The document will be renamed and/or moved to the new directory.</p>
<p class="list-1">• To view a different document:</p>
<p class="list-2">• Select the document on the Mods tab. <B><I>Or...</I></B></p>
<p class="list-2">• Use the mod name combo box to select the desired mod.</p>
<p class="list-1">• To make a text document editable, click the "Edit Doc..." button.</p>
<p class="list-2">• Note that editable docs will stay editable until you unset "Edit Doc...".</p>
<p class="list-2">• Also the Edit doc setting is remembered separately for each mod. As you switch between mods, the "Edit Doc..." button will return to the remembered state for that document.</p>
<p class="list-2">• Any changes to the document will be automatically saved when the mod is changed, the document window is closed or the edit button is unclicked.</p>
<p class="list-2">• To create a new document, just use "Set Doc..." and pick a file name that doesn't exist yet. This will give you a blank document template - and any changes to it will save automatically, creating the new file.</p>
<p class="empty"> </p>
<h3 class="header3" id="WikiTextFormat">3.11.2 - Wiki Text Format</h3>
<p class="list-1">• If the mod's doc file is a <B>.txt</B> file in wrye wiki text format, an html version of it will be automatically generated as needed, and this html version will be shown when the doc Browser is not in edit mode.</p>
<p class="list-1">• <B><I>Format Documentation and Template:</I></B></p>
<p class="list-2">• The wiki text format is documented in <B>Data Files\Docs\Mash Readme Template.txt</B>.</p>
<p class="list-2">• When you create a new readme document (by using "Set Doc..." to a file that doesn't exist yet), you'll be given a template wiki text file. The template will be based either on the Template above, or on <B>Data Files\Docs\My Readme Template.txt</B> if it exists.</p>
<p class="empty"> </p>
<h3 class="header3" id="Notes">3.11.3 - Notes</h3>
<p class="list-1">• If you rename a mod in the mods tab, Mash will move the document association to the new name.</p>
<p class="list-1">• Similarly, if you copy a mod, the new copy will be associated with the same document.</p>
<p class="list-1">• Documents can be stored in different directories.</p>
<p class="list-1">• If you <I>delete</I> a mod, then Mash will forget about its document (but won't delete it). However, if you <I>Hide</I> a mod, Mash will remember the document, and you'll still be able to select it from the Doc Browser's mod name combo box.</p>
<p class="empty"> </p>
<h3 class="header3" id="Suggestions">3.11.4 - Suggestions</h3>
<p class="list-1">• You may want to move your docs from the Data Files directory to a new Data Files\Docs directory. This will reduce clutter somewhat and make documents easier to find.</p>
<p class="empty"> </p>
<h2 class="header2" id="Doubling">3.12 - Doubling</h2>
<h3 class="header3" id="DoublingTheory">3.12.1 - Doubling Theory</h3>
<p class="list-1">• <B><I>Full Explanation</I></B></p>
<p class="list-2">• What follows is an extremely abridged summary of the long answer given in <a href="https://wryemusings.com/Wrye%20Mash.html" >Wrye Matching</a>.</p>
<p class="list-1">• <B><I>Background: Reference Ids</I></B></p>
<p class="list-2">• So, you start Morrowind, load your last saved game, and find yourself in Balmora. There on the bridge is the same MCA character. There at your feet is the potion that you just dropped. Over there is the door that you opened. And it occurs to you... How does Morrowind keep track of all this stuff? How does it know <I>this</I> potion is supposed to be here? How does it know <I>that</I> door needs to be open?</p>
<p class="list-2">• The answer is <B><I>reference ids</I></B> — every object that you see in the game world has an unique numerical id attached to it, defining it. When you load a set of mods (as you do when Morrowind starts up), Morrowind first recreates the world in a "virgin" (i.e. unchanged state). Then, when you load a savegame, it reapplies all the changes that you made — killing bandits, filling quests, opening doors, moving NPCs, etc. It makes those changes by matching the reference ids stored in the savegame against the reference ids as calculated for the virgin gameworld (i.e. for the set of loaded mods).</p>
<p class="list-2">• Unfortunately this matching/updating process can go wrong sometimes. <B><I>Doubling</I></B> is the most obvious such problem. But other problems can happen, e.g., changes meant for a bar door might be applied to an NPC. These mismatches might be invisible, might cause weird behavior, or might cause CTDs. As people have found in the past, if enough of them pile up (e.g., after repeatedly changing the mod list), you <I>will</I> get corrupted unplayable games.</p>
<p class="list-2">• Note that <B><I>all</I></B> of these problems are caused by mismatches between reference ids! E.g. from your loaded mod list, Morrowind determines that the referenceid number for that door should be 345672-05, but your savegame thinks that the reference id for the door should be 345672-07, or maybe 345674-05. So the secret to avoiding doubling, etc. is simply preventing such mismatches. Well, easier said then done, unfortunately!</p>
<p class="list-2">• So, a little more background... Each reference id is actually two numbers: the <B><I>ObjectIndex</I></B> and the <B><I>ModIndex.</I></B> For each mod, the objectindex is unique, i.e., there's only one "1292" objectindex in each mod. The modindex, on the other hand is simply the order of the source mod in the load list. Morrowind.esm loads first, so it has modindex == 1. Tribunal and Bloodmoon if loaded, are usually numbers 2 and 3 respectively. Okay, but how about objects that don't really belong to a particular mod? E.g. an arrow that you bought and dropped on the ground? Simple enough, these objects belong to the savegame itself, and are given the special modindex of 0.</p>
<p class="list-2">• That's the basic story. There are a lot of exceptions and complications (e.g., spawnpoints), but that's the basics, so let's go on...</p>
<p class="list-1">• <B><I>Reasons for Reference Mismatching</I></B></p>
<p class="list-2">• If you change the mod load order — either by adding new mods that want to load before your current mod, or by resaving a mod (which changes its modification date, and thus load order), then the ModIndex numbers will be mismatched.</p>
<p class="list-2">• Also, if a mod has had new references added, then many of its objectIndexes of existing references will be changed. This is because TESCS completely renumbers all references when the mod is saved.</p>
<p class="list-2">• There are quite a few technicalities and qualifications here, but that's the gist of it.</p>
<p class="list-1">• <B><I>Morrowind Repair Work</I></B></p>
<p class="list-2">• If the load order changes, Morrowind tries to correct ModIndex numbers. If only the load order has changed (i.e., exactly the same files with the same names are present), then it seems to do a pretty good job of adapting.</p>
<p class="list-2">• But if new mods are added or if old mods are given new names, it gets confused and its repair often fails.</p>
<p class="list-2">• Note that the effect of this failure may not be immediately apparent, and the effects may oscillate under certain conditions — e.g., doors may disappear and reappear with each new load change.</p>
<p class="list-1">• <B><I>Doubling Prevention/Repair</I></B></p>
<p class="list-2">• So to prevent/fix doubling, you need to do several things:</p>
<p class="list-3">• Prevent modification date related mod disordering. <B><I>(See <a href="#LoadOrderMaintenance" >Load Order Maintenance</a>.)</I></B></p>
<p class="list-3">• Adjust ModIndex numbers to account for new load ordering. (I.e. complete the job that Morrowind does partially.) <B><I>(See <a href="#MasterListUpdating" >Master List Updating</a>.)</I></B></p>
<p class="list-3">• Repair existing damaged games files by removing existing corrupted records. <B><I>(See <a href="#MasterListUpdating" >Master List Updating</a>.)</I></B></p>
<p class="list-3">• Adjust for changes to objectIndex numbering from mod modification. <B><I>(See <a href="#ModUpdating" >Mod Updating</a>.)</I></B></p>
<p class="empty"> </p>
<h3 class="header3" id="LoadOrderMaintenance">3.12.2 - Load Order Maintenance</h3>
<p class="list-1">• In order to prevent doubling and to get correct behavior out of mods, it is important that they load in the correct order. Since mod load order is determined by their modified time, it is important to be able to set and keep fixed the modified time.</p>
<p class="list-1">• <B><I>To set the load order of a mod,</I></B> just edit the Modified field of the mod in the details view.</p>
<p class="list-1">• <B><I>To keep the modified time fixed,</I></B> Turn on the "Lock Times" feature in the column context menu of the Mods Tab. When this is done, Mash will memorize the modified times for all files that it sees. Then, whenever Mash launches, or comes to the foreground, it will check to see if any Modified times have changed, and if so, reset them to the earlier memorized values.</p>
<p class="list-1">• Note: If you want <B><I>to use a non-Mash load ordering utility,</I></B> you'll first need to turn off "Lock Times". When you're finished with the external ordering utility, turn Lock Times back on. It will reset to use the times set by the other utility.</p>
<p class="empty"> </p>
<h3 class="header3" id="ModUpdating">3.12.3 - Mod Updating</h3>
<p class="list-1">• As described above, adding references to (or removing references from) an</p>
<p> existing mod is likely to cause doubling. Part of the cause of this is reordering of the mod (which is fixed by <B><I>Lock Times</I></B> ), but the other cause is ObjectIndex renumbering. Fixing this second problem requires that the objectIndex numbers be remapped in the save file (e.g., remap object number 123 to number 234). This can be done in Mash, but requires several stages.</p>
<p class="list-1">• <B><I>Procedure</I></B></p>
<p class="list-2">• <B><I>First,</I></B> there must be *separate mod files for the original mod and for the</p>
<p> updated mod,* and these mod files must have different names (e.g., "AoScrye 1.1.esp" and "AoScrye 1.15.esp").</p>
<p class="list-3">• For modders, *it's okay to continue to modify the original mod, so long</p>
<p> as you do not add or remove refs, and so long as you do not change the id of any placed refs!*</p>
<p class="list-3">• If you need to add or remove refs, then these changes need to be made</p>
<p> on a new version of the mod. (Just use the File: Duplicate command and rename the new copy as desired.)</p>
<p class="list-2">• <B><I>Second,</I></B> you need to generate an "Updater" for each old/new version pair.</p>
<p class="list-3">• Select the new version of the mod in the Mods tab and then select</p>
<p> "Updaters..." from the context menu. This will popup a new dialog which will list the updaters available for that mod.</p>
<p class="list-3">• Click on "Add" and select the old version of the mod. This will create</p>
<p> the updater, which will now be shown in the list. If some of your save games depend on even older versions (e.g., "AoScrye 1.0.esp"), then you can add additional updaters for those.</p>
<p class="list-2">• <B><I>Third,</I></B> update the masters list of the save game that you want to update.</p>
<p class="list-3">• In the saves tab, select the save game you want to update, and, in its</p>
<p> master list, change the name of the old esp version to the new esp version. I.e., click on the old name and then either edit the master name in place, or use the context menu to select the new master. If you've done this correctly, then the updated master will be highlighted in dark green. (Masters that have been changed, but <I>don't</I> have an updater applied are highlighted in pale green.)</p>
<p class="list-1">• <B><I>Merged Plugins</I></B></p>
<p class="list-2">• If you have a save game that is dependent on one or more plugins which are</p>
<p> merged into combined plugin, then you can define an Updater from the original plugin(s) to the merged plugin.</p>
<p class="list-3">• E.g., if your save game depends on "Alpha.esp" and "Beta.esp" and these</p>
<p> are then merged to form "Gamma.esp", then you can define updaters as above and then, in the save game master list, rename both "Alpha.esp" and "Beta.esp" to "Gamma.esp".</p>
<p class="list-3">• Note that should work well, so long as the merged files do not place the</p>
<p> same type of object into the same cell. However, even in this case, running Repair All should fix any problems.</p>
<p class="empty"> </p>
<h3 class="header3" id="MasterListUpdating">3.12.4 - Master List Updating</h3>
<p class="list-1">• <B><I>Master/Save/Mod Health</I></B></p>
<p> <img src="img/checkbox_red_on.png" width="16" height="16" alt="Red"></p>
<p> <img src="img/checkbox_orange_on.png" width="16" height="16" alt="Orange"></p>
<p> <img src="img/checkbox_yellow_on.png" width="16" height="16" alt="Yellow"></p>
<p> <img src="img/checkbox_green_on.png" width="16" height="16" alt="Green"></p>
<p> <img src="img/checkbox_blue_on.png" width="16" height="16" alt="Blue"></p>
<p> <img src="img/checkbox_purple_on.png" width="16" height="16" alt="Purple"></p>
<p class="list-2">• In the master list, checkbox colors indicate the "health" of that</p>
<p> master. Blue is best, red is worst. Green, yellow and orange represent intermediate levels of health.</p>
<p class="list-2">• In the saves and mods list, the checkbox color is the same as the least</p>
<p> healthy of its masters. I.e. if, for a save, one master is orange and the rest are green, then the save's checkbox will be orange. The exception to this is purple, which is a sort of "superblue".</p>
<p class="list-2">• More specifically, and from worst to best, the meanings of master colors</p>
<p> are:</p>
<p class="list-3">• <B><I>Red:</I></B></p>
<p> The master is missing. Either the mod file has been removed, or</p>
<p> its name has been changed.</p>
<p class="list-3">• <B><I>Orange:</I></B></p>
<p> The master file is out of load order compared to the rest of the</p>
<p> masters in the master list.</p>
<p class="list-3">• <B><I>Yellow:</I></B></p>
<p> The master file's size has changed since the game was last</p>
<p> saved. This likely indicates a change to the mod file — which may result</p>
<p> in objectIndex caused mismatching.</p>
<p class="list-3">• <B><I>Green:</I></B></p>
<p> The master file is in order compared to the other files in the master list, but is out of order compared to the files in the current load list.</p>
<p class="list-3">• <B><I>Blue:</I></B></p>
<p> The master file is synced, has the right size and is in the right order.</p>
<p class="list-3">• <B><I>Purple:</I></B></p>
<p> This will only appears for saves. It indicates that not only are all of the masters synced, but also that no extra masters are loaded. If a save is blue (not purple), then the load list contains an extra esp that the save is not yet dependent on. If you play the save, then the save will become dependent on that new master.</p>
<p class="list-2">• For save games, you want every master to be blue - i.e. you want the save</p>
<p> itself to be blue.</p>
<p class="list-2">• Mod files have much less problems than save files — so it's sufficient if</p>
<p> all masters are orange or better. I.e., as long as the master is present, it should be okay. For this reason, for mod files, "green" is considered to be perfect health.</p>
<p class="list-1">• <B><I>When to Update Masters</I></B></p>
<p class="list-2">• If the save game checkbox color is blue, then it's fine — there's no</p>
<p> need to edit it.</p>
<p class="list-2">• If the save game checkbox color is green, then its master list is fine,</p>
<p> but it not compatible with the current load list. You can use the "Load Masters" to sync load list with the master list. Note that the load list does not have to be exactly the same as the master list. It can have additional load files, so long as those files will load <I>after</I> the files in the save games master list.</p>
<p class="list-2">• Otherwise, you should edit the load list.</p>
<p class="list-1">• <B><I>Updating the Load List</I></B></p>
<p class="list-2">• If you like, you can create a duplicate or snapshot of the file before</p>
<p> you edit it. But remember that Mash also will automatically create a backup that you can revert to. So, creating a duplicate is simply an extra measure of safety.</p>
<p class="list-2">• Bring up the context menu for the masters list column header, select</p>
<p> "Edit", and then click "Yes" in the dialog that appears. Doing this will result in some initial cleaning of the list:</p>
<p class="list-3">• Master files will be placed in the correct order.</p>
<p class="list-3">• Missing files will be renamed if Mash thinks it knows what the new</p>
<p> name is. Otherwise the missing master will be unchecked.</p>
<p class="list-3">• The correct file size will be applied.</p>
<p class="list-3">• Note that files that have had their name or size changed will now be</p>
<p> highlighted in green.</p>
<p class="list-2">• If all masters are checked and are either green or blue, then you're</p>
<p> probably done and can save your changes. Otherwise, continue...</p>
<p class="list-2">• You can rename masters by editing their label directly or by using the</p>
<p> "Change to..." command from the master item popup menu. (Right click on the master name.) This will bring up a dialog allowing you to select an esm or esp.</p>
<p class="list-3">• You can change esm references to esp references and vice versa.</p>
<p> (E.g., suppose you depending on an esp that has since been converted to an esm.)</p>
<p class="list-3">• You can change different existing masters to point to the same new master.</p>
<p> You might do this if you merged several head mods. (Note that merging may</p>
<p> cause objectIndex doubling — so hopefully the merge has been done in such a way as to prevent that.) When the file is saved, these different master references will be merged into a single reference.</p>
<p class="list-3">• If the rename has an Updater associated with it (i.e., from "AoScrye 1.1.esp" to "AoScrye 1.15.esp"), then the new name will highlighted in dark green. Otherwise, the rename will be highlighted in pale green. (See <a href="#ModUpdating" >Mod Updating</a> above for more information.)</p>
<p class="list-2">• You can unselect masters that you want removed.</p>
<p class="list-3">• Note that this will delete any changes that you made to that objects</p>
<p> references from your save game.</p>
<p class="list-2">• You can use the "Sync to Load List" command from the column context menu.</p>
<p class="list-3">• This will uncheck unmatched masters and add additional masters as</p>
<p> necessary.</p>
<p class="list-2">• <B><I>Suggested Action</I></B></p>
<p class="list-3">• In the mods tab, first select the mods that you want to run with.</p>
<p class="list-3">• Then switch to the save tab. If the save you want to use is not blue, then</p>
<p> begin editing the master list for it.</p>
<p class="list-3">• If there are any missing masters, then rename them. Also check the</p>
<p> autorenames (look for green highlighted items) to see if they look right.</p>
<p class="list-3">• Then use "Sync to Load List, do a final inspection and save the file.</p>
<p class="list-3">• Then use <B><I>Repair All</I></B> on the file (see below).</p>
<p class="empty"> </p>
<h3 class="header3" id="RepairRefsCommand">3.12.5 - Repair Refs Command</h3>
<p class="list-1">• <B><I>Note:</I></B> For save games, the Repair Refs command has been extended into the Repair All command. Repair All performs all of the work of the Repair Refs command, plus additional cleanup, which is described <a href="#RepairAllCommand" >below</a>.</p>
<p class="list-1">• This Repair All function attempts to repair references and other records damaged by past changes to file list.</p>
<p class="list-1">• Note: If the health of the file is not Blue or Green, then you should to update the master list before you can use the Repair All command.</p>
<p class="list-1">• When you run Repair All, you'll either get a report that no repairs were necessary, or you'll get a report of repairs that were made. Repairs will take the form of either rematches or deletions.</p>
<p class="list-1">• Rematches: The Repair All function compares the object id for each reference with the object id expected from the save files master list for the references combined modIndex and objectIndex. If they those id's don't match, then Repair All tries to find a different value of modIndex for with the id's do match. If it finds such a match and if that match is not already used by another reference, then it switches the reference to use the new modIndex. This is a rematch.</p>
<p class="list-1">• If Mash can't find a non ambiguous match, then it will report "NO MASTER" and delete the reference.</p>
<p class="list-1">• If Mash finds a match, but it's already in use, then it will report "DOUBLE" and delete the reference.</p>
<p class="list-1">• Also if Mash finds a reference that is marked as "Deleted" but has a modIndex of 0 (meaning that it's owned by the save file, not any of its masters), then Mash will delete the reference. Note that a save game needs to remember when a master file reference is deleted, but should not remember when a save-game owned reference is deleted — since there's no need to do so. These bad deletes seem to be responsible for doors, NPCs, etc. that disappear and reappear with every change in the load list.</p>
<p class="empty"> </p>
<h3 class="header3" id="RepairAllCommand">3.12.6 - Repair All Command</h3>
<p class="list-1">• In addition to repairing refs, as described <a href="#RepairRefsCommand" >above</a>, Repair All performs several other cleanup tasks...</p>
<p class="list-1">• <B><I>Remove Orphan Contents</I></B></p>
<p class="list-2">• Content records (CREC, CNTC and NPCCC) records that have become disassociated with a place reference are removed.</p>
<p class="list-1">• <B><I>Remove Debris Records</I></B></p>
<p class="list-2">• Sometimes gameplay leaves a modified copy of a database object even after the mod that "owns" that database object is no longer in the load list. This is common for globals (GLOBs), but also occurs for a variety of other records (NPC_s, LEVCs, etc.).</p>
<p class="list-2">• The list of object ids in the save game is compared against the object ids provided by the game's master files, and records that are unmatched are deleted.</p>
<p class="list-2">• Exceptions: Some items are intentionally created in game (new spells, enchanted items). Also, the MonthsToRespawn global is created during gameplay. These records are excepted from the Debris removal process.</p>
<p class="list-1">• <B><I>Remove Overriding Lists</I></B></p>
<p class="list-2">• Mods that modify leveled lists through the addToLev and removeFromLev script commands will cause copies of those (modified) leveled lists to be added to the savegame itself. This approach conflicts with the use of leveled list mergers since the savegame copy of the leveled list will override even the merged leveled list esp. Accordingly, the scripted approach is now considered obsolete. Mods should no longer use the leveled list script commands.</p>
<p class="list-2">• However, this still leaves the problem of cleaning savegames that are contaminated by older leveled list modifications. Repair All will now (as of version 0.70) do this.</p>
<p class="list-3">• Repair All will remove any leveled list in the savegame if more than one master mod has a copy of the list. (Thus unique lists belonging to a single mod may still use script commands.)</p>
<p class="list-2">• Note however, that if an older script modifying mod is still present in your load list, it will most likely continue to read the leveled list back into the savegame. The solution to this is to update/patch the offending mod to no longer use the leveled list script commands.</p>
<p class="list-2">• For more info, including a list of problematic mods (and updates/patches for them) see: <a href="http://www.uesp.net/wiki/Tes3Mod:Leveled_Lists" >UESP Leveled Lists</a>.</p>
<p class="empty"> </p>
<h2 class="header2" id="Mish">3.13 - Mish</h2>
<p>Mish is a command line interface to the features of mash. At the moment [5/30/2005], there are a couple of features that you can access from it that you can't access from the GUI. Also, with a bit of python coding you can do some pretty nice useful mangling of tes3 files.</p>
<p class="empty"> </p>
<h3 class="header3" id="MishCommands">3.13.1 - Mish Commands</h3>
<p class="list-1">• <B><I>Using Mish</I></B></p>
<p class="list-2">• Chdir to the mopy directory and then (if you have python environment fully defined), type mish commandName [arguments].</p>
<p class="list-2">• If you don't have the python environment fully defined, then type:</p>
<p class="list-2"> <code>python mish.py commandName [arguments]</code></p>
<p class="list-2">• I'm assuming that you at least have the python.exe in your command path.</p>
<p class="list-2">• If you're confused, but desirous of learning more, go to python.org and look for info on setting up your python environment.</p>
<p class="list-1">• <B><I>refInfo</I></B></p>
<p class="list-2">• This command will give you info on the refs in a file. Typically, I use this for finding which references are changed from the faster.</p>
<p class="list-2">• Usage:</p>