Difference between revisions of "Category:TES5Edit"

→‎Closing Remarks & Credits: Fixed link cs.elderscrolls.com to cs.uesp.net (historical reference TES4Edit )
imported>Sharlikran
(→‎Closing Remarks & Credits: Fixed link cs.elderscrolls.com to cs.uesp.net (historical reference TES4Edit ))
 
(28 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:Tools]]
[[Category:Tools]]
[[Category:Data File Editors]]
[[Category:Data File Editors]]
[[Category:TES5Edit]]


=Description=
== Description ==


[[File:TES5Edit Main View.jpg|thumb|TES5Edit Main View]]
[[File:TES5Edit Main View.jpg|thumb|TES5Edit Main View]]
'''TES5Edit''' is an advanced tool for manipulating Skyrim plugins. It is especially useful for comparing multiple plugins at the same time and resolving differences between them. It includes powerful functions for creating de-isolated plugins using simple drag-and-drop editing. It also supports batch editing of selected records, which is extremely useful if you want to do something like add or remove an inventory item, faction, or AI package on a bunch of NPCs. It also lets you easily compare two or more similar records and drag-and-drop changes among them.
'''TES5Edit''' is an advanced tool for manipulating Skyrim plugins. It is especially useful for comparing multiple plugins at the same time and resolving differences between them. It includes powerful functions for creating de-isolated plugins using simple drag-and-drop editing. It also supports batch editing of selected records, which is extremely useful if you want to do something like add or remove an inventory item, faction, or AI package on a bunch of NPCs. It also lets you easily compare two or more similar records and drag-and-drop changes among them.


'''TES5View''' is an advanced graphical esp viewer and conflict detector.  (Rename TES5Edit to TES5View)  
'''TES5View''' is an advanced graphical esp viewer and conflict detector.  (Rename TES5Edit to TES5View)


'''TES5Trans''' ''Translate Mode Description needs to be updated.''  (Rename TES5Edit to TES5Trans)
'''TES5Trans''' ''Translate Mode Description needs to be updated.''  (Rename TES5Edit to TES5Trans)
Line 19: Line 18:
Both the detail view and the record list use the same color coding to signal the conflict state of individual fields (in the detail view) and the record overall (in the record list).
Both the detail view and the record list use the same color coding to signal the conflict state of individual fields (in the detail view) and the record overall (in the record list).


'''Background color''':
== Background colors==


White - Single Record:
: White - Single Record:
: Green - Multiple but no conflict:
: Yellow - Override without conflict:
: Red - Conflict:
: Fuchsia - Critical Conflict:


Green - Multiple but no conflict:
'''Text color''':
 
: Black - Single Record:
: Purple - Master:
: Gray - Identical to Master:
: Green - Override without conflict:
: Olive - Identical to Master but conflict Winner:
: Orange - Conflict winner:
: Red - Conflict loser:
 
Conflict detection is not simply based on the existence of multiple records for the same FormID in different plugins but instead performs a comparison of the parsed subrecord data.  The record tree view on the left side has a context menu where you can activate filtering. Filtering is
based on the same conflict categorization as the background and text color.  Yes, filtering will take a while. It has to decode and compare the contents of every single record which turns up more then once.


Yellow - Override without conflict:
Be warned, this program uses a lot of memory. Performance on a system with less then 2GB of RAM will most likely be sub-optimal. Activating the filtering uses even more memory.


Red - Conflict:
== Downloading, Installation, and Language Settings ==


'''Text color''':
=== Installation ===


Black - Single Record:
You can download the latest version from the skyrim Nexus:
* [http://www.nexusmods.com/skyrim/mods/25859/ TES5Edit by ElminsterEU, updated by Zilav, Hlp, and Sharlikran for Skyrim]


Purple - Master:
# Extract the contents of the archive into a new empty folder.
# You can execute the program from any folder on your local computer.  As I show in the screenshot below, I placed mine in a separate directory, ''any folder'' on your computer will work just as well.


Gray - Identical to Master:
[[Image:TES5Edit Folder.jpg|800px|TES5Edit Install Folder]]


Orange - Identical to Master but conflict Winner:
NOTE: The program will automatically detect the directory where your plugins are located at.


Green - Override without conflict:
You can change the way the program interacts renaming it
# TES5Edit.exe
# TES5View.exe
# TES5Trans.exe


Orange - Conflict winner:
=== Creating A Shortcut  ===


Red - Conflict loser:
It is best to set up a shortcut at an easily accessible location because you will be opening, closing, and re-opening TES5Edit many, many times. Your desktop is the suggested location. 


Conflict detection is not simply based on the existence of multiple records for the same FormID in different
From where you installed right click TES5Edit.exe, then "Send To" and then Desktop.
plugins but instead performs a comparison of the parsed subrecord data.


The record tree view on the left side has a context menu where you can activate filtering. Filtering is
[[Image:TES5EditCreateShortcut.jpg|800px|TES5Edit Create Shortcut]]
based
on the same conflict categorization as the background and text color.


Yes, filtering will take a while. It has to decode and compare the contents of every single record which
'''Example shortcuts'''
turns up more then once.
<Pre>"C:\Program Files\TES5Edit_3_0_22_EXPERIMENTAL\TES5Edit.exe"</pre>
<Pre>"C:\Program Files\TES5Edit_3_0_22_EXPERIMENTAL\TES5Edit.exe" -view</pre>
<Pre>"C:\Program Files\TES5Edit_3_0_22_EXPERIMENTAL\TES5Edit.exe" -translate</pre>


Be warned, this program uses a lot of memory. Performance on a system with less then 2GB of RAM will
=== Setting The Language ===
most likely be sub-optimal. Activating the filtering uses even more memory.


=Installation=
TES5Edit has a Language selection parameter "-l:language" for Skyrim.
#Extract the contents of the archive any where you so desire or into its own personal folder.
#The program will automatically detect the directory where your plugins are located at.


You can change the way the program interacts renaming it
Right click the Shortcut you made on the Desktop and click Properties.
#TES5Edit.exe
In the Box labeled Target add the parameter after the last quotation (") mark. In the screenshot I added "-l:spanish".
#TES5View.exe
#TES5Trans.exe


You can also create shortcuts to use on your desktop that will do the same thing that renaming the files will accomplish.
[[Image:TES5LanguageSetting.jpg|300px|TES5Edit Language Setting]]


I recommend using this option because it makes it easier to update one file then it is to rename it every time.
NOTE:  TES5Edit is in English only.  This command line parameter is only for the Plugin's localization.  If Localization is not available, or not working correctly only English will be shown for that Plugin.


'''Example shortcuts'''
'''Example shortcuts'''
<Pre>"C:\Program Files\TES5Edit_3_0_22_EXPERIMENTAL\TES5Edit.exe"</pre>
<Pre>"C:\Program Files\TES5Edit_3_0_22_EXPERIMENTAL\TES5Edit.exe" -l:spanish</pre>
<Pre>"C:\Program Files\TES5Edit_3_0_22_EXPERIMENTAL\TES5Edit.exe" -view</pre>
 
<Pre>"C:\Program Files\TES5Edit_3_0_22_EXPERIMENTAL\TES5Edit.exe" -translate</pre>
== Documentation ==
 
'''This is a work in progress it is not complete at this time.''' 
 
* [[TES5Edit_Documentation|TES5Edit Documentation]]
 
This is being provided as a base for documentation for all versions.  It is being taken straight from the Fallout documentation written by Miax and other contributors.  If you have previous knowledge of FO3Edit, FNVEdit, and TES4Edit please contribute to this documentation.  There is no way any one person can include everything.  Your contributions will make the documentation as through as possible.
 
'''What will not be included in the Documentation'''
 
# How the Bethesda CK Works
# Specific conflicts that should be ignored
# Technical Plugin Specific Information
# Exactly how to troubleshoot load order issues or prevent a Crash To Desktop or, CTD
# Which plugins should not be cleaned
# Personal Opinion and conjecture even if you can support it in some way[1]
 
Some people new to using FO3/FNV/TES4/TES5Edit are trying to prevent their game from crashing.  However, they normally don't have the technical background to understand the inner workings of the plugins nor would they understand the programming that goes into the tool itself.  Because of this, only general ways to detect a conflict should be presented.  The Author of the mod should be contacted to resolve any issues with the plugin they have provided to the public.  The documentation should only include proper use of the software.  Try to keep it generic so it covers all versions.  When applicable, note any version specific differences.
 
If you do understand programming and would like to know more about the inner workings of TES5Edit feel free to visit our Google Code site. You are more then welcome to read the source code and and search the web for applicable Delphi documentation.
 
[1] If you feel a version of xEdit should not be used for certain operations such as making a Merge Patch for FO3/FNV/TES4/TES5, for Merging Plugins, or whatever that is not up to you.  Users should be aware that the xEdit team does not guide them through plugin editing except in the general sense shown in this documentation or the Training manuals.  If they don't do something correctly they are responsible for finding the solution by asking the Modding Community, consulting other xEdit experts, or consulting this document or the FNVedit Training manual.
 
== Benefits to cleaning Official DLC and other plugins ==
 
It is recommended to keep a backup of the files you are cleaning.  This is done automatically unless you uncheck the option at the bottom of the Save changed files window after closing TES5Edit to save the plugin.  If you have undesired results after cleaning a plugin restore a backup.  Also remember that sometimes ITMs are intentional so you should check an authors Description page or Readme file to see if that is the case.  Attentive authors may have even updated the list of [[Skyrim_Dirty_Plugins_List#Mods_You_Should_NOT_Clean|Mods You Should NOT Clean]].  Deleted NavMeshes and deleted references are normally not intentional and should be resolved.  There are three reasons to use the automatic cleaning.
 
The first reason is because some plugins have entries that are identical to the Official Master files from Bethesda. They are there because an author may have looked at something in the CK and because of that an unneeded entry was saved in the plugin whether or not the item was altered. Wherever that plugin is placed in your load order it overwrites all the plugins loaded before it resetting the settings back to the values contained in the Official Bethesda DLC. It won't cause crashes, it just changes the values of plugins loaded before it. Which can alter mods that you have for Weapon Damage, Armor, Lighting, Food Effects and so on.  TES5Edit can remove these records during cleaning using the "Remove Identical to Master Records" option.
 
The Second reason is that some authors choose to delete things that are in the Official DLC. The best examples are mods that alter Towns, Villages, add Player Homes, and mods that alter the Wilderness. Those mods generally move and delete some things from the world like trees and rocks. The Author adds some trees, Buildings, rocks, fences, decorations, rivers, and alters the landscape. Any mods loaded after a mod with references to deleted records from the Official Bethesda DLC will cause Skyrim to crash.  TES5Edit can restore and properly assign values to these records that will disable them and still allow other mods to access them. This is done using the "Undelete and Disable References" option.
 
The third reason is that TES5Edit will report when a mod has Deleted NavMeshes. Like deleted references any mod that references a deleted NavMesh will cause Skyrim to Crash. Properly optimizing your mods NavMeshes and checking your mod for Deleted Vanilla is important.  Mods altering the same cell and the same NavMeshes when your mod is not optimized will cause Skyrim to Crash.  Poorly optimized NavMeshes with errors reported by the CK will make Skyrim unstable.  Instabilities like fast travelling to a location and Skyrim crashes.
 
Although those are the three benefits of automatic cleaning, manually cleaning your mods is important to remove wild edits. Some mods will have accidental Wild Edits in them caused by the author looking at how Bethesda did something they wish their mod to do as well.  These Wild Edits often prevent Skyrim from doing things like advancing quests, spawning NPCs, assigning dialogue to NPCs, preventing NPCs from patrol areas they are assigned to.  They can also alter Vanilla Lighting and Triggers the author wished to use.  All of these things effect any plugin loaded before a mod with Wild Edits.
 
== Frequently Asked Questions ==
 
This is a work in progress it is not complete at this time.


[http://code.google.com/p/skyrim-plugin-decoding-project/downloads/list Download TES5Edit from our Google Code Site skyrim-plugin-decoding-project]
* [[TES5Edit_Frequently Asked Questions|Frequently Asked Questions]]


[http://forums.bethsoft.com/topic/1415541-wipz-tes5dumpfuture-tes5edit/ Official Elderscrolls TES5Edit forum topic]
= TES5Edit Scripting Functions =


= Related Articles =
* [[TES5Edit_Scripting_Functions|TES5Edit Scripting Functions]]


[http://www.creationkit.com/Skyrim_Dirty_Plugins_List/ Dirty Plugins List]
= Additional TES5Edit Resources =


[http://www.creationkit.com/Skyrim_TES5Edit_Mod_Cleaning_Tutorial TES5Edit Mod Cleaning Tutorial]
* [[TES5Edit_Cleaning_Guide_-_TES5Edit|TES5Edit Cleaning Guide]]
* [[TES5Edit_Mod_Cleaning_Tutorial|TES5Edit Mod Cleaning Tutorial]]
* [[Fixing_Navmesh_Deletion_Tutorial|Fixing Navmesh Deletion Tutorial]]
* [[Skyrim_Dirty_Plugins_List|Skyrim Dirty Plugins List]]
* [[TES5Edit_Scripting_Functions|TES5Edit Scripting Functions]]
* [https://bethesda.net/community/topic/57570/relz-sseedit/ Official Elderscrolls TES5Edit forum topic]


= Closing Remarks & Credits =
= Closing Remarks & Credits =


This has been adapted from the [http://cs.elderscrolls.com/index.php/TES4Edit TES4Edit] article on the Elderscrolls Wiki.
This has been adapted from the [http://cs.uesp.net/wiki/TES4Edit TES4Edit] article on the Elderscrolls Construction-Set Wiki.


Thanks also go to ElminsterEU, Sharlikran, and Zilav for their work in getting TES5Edit released. Special Thanks to Gopher for getting the word out with a short video announcing the public release of TES5Edit and his upcoming tutorials.
Thanks also go to ElminsterEU, Sharlikran, and Zilav for their work in getting TES5Edit released. Special Thanks to Gopher for getting the word out with a short video announcing the public release of TES5Edit and his upcoming tutorials.


Still to do:
= Still to do =
* Make sure TES5Edit still utilizes TES5View and TES5Trans functionality.
* Make sure TES5Edit still utilizes TES5View and TES5Trans functionality.
* Update the Dirty Plugins List
* Update the Dirty Plugins List
* Update the TES5Edit Mod Cleaning Tutorial
* Update the TES5Edit Mod Cleaning Tutorial
* Get the correctness of the guide verified by the TES5Edit team.
* Get the correctness of the guide verified by the TES5Edit team.
= See Also =
*[[:Category:TESVSnip|TESVSnip]]
{{Languages}}
7

edits