Description

Last updated at 20:49, 29 Nov 2016Uploaded at 7:24, 14 Jan 2014

For beta scripts and updates between official releases, please see the GitHub repository.

12,983 lines of code as of 07/18/2014

What is Automation Tools?Automation Tools is a package of scripts for use with TES5Edit. These scripts allow you to perform batch modifications, generate records, or create useful reports. Automation Tools is a must have for modders old and new, as the scripts included can save truly massive amounts of time. With Automation Tools, edits that would once take hundreds of hours can be completed in mere minutes.

Allows for batch modification of records via eight useful functions, multiple of which can be set up per script execution.

ElementAssign: Adds an element to a list of elements.

Add: Creates a non-existing element.

Remove: Deletes an existing element.

Replace: Replaces an element value with a new element value.

Formula: Applies a formula to an integer valued element to generate a new value.

Restore: Restores values on a specified element to those found on a lower override or base record.

TemplateRestore: Restores values on a specified element to values from a template record on weapons and armors.

Copy: Copies the element/elements from a specified path on a specified record to selected records.

Import: Imports values from a csv file to the selected records.

ArrayImport: Imports values from an array text document exported with QuickDisplay onto the selected records at the selected path. This allows you to set multiple values stored at a single path simultaneously. E.g. Keywords, Factions, Head Parts, Conditions, etc.

Installation0. Install the latest version of TES5Edit (3.0.31) if you haven't already. It should be installed in your Skyrim directory, else certain scripts (namely the Armor Mod Builder) may not function correctly.1. Download the AutomationTools.zip file from Nexus mods.2. Extract the contents.3. Place the included Edit Scripts folder in the folder with TES5Edit.exe, merging it with the existing Edit Scripts folder.4. You're done! You can now use the scripts in TES5Edit as you please.

Further DocumentationFor further documentation and assistance please refer to the included AutomationTools.chm file. This is a help file that has topics covering everything from installation to the details of each script's application and usage. This includes basic knowledge regarding elements, paths, and element lists which is requisite for the correct usage of several of the scripts included in this package. It's easy to read and use, and I worked very hard on it (almost as hard as I worked on the scripts!). So please: READ IT!

Frequently Asked QuestionsQ: Why did you make these scripts?A: To help the Skyrim modding community. It also helps that I'm pursuing a career in Software Development, so this is a nice notch in a my belt.

Q: <InsertScriptHere> isn't working!A: It's more likely that you're doing something wrong than that the script is actually dysfunctional, so make sure you read the documentation. If you've read the documentation and still think something is wrong check the comments section, and make sure you have the most up-to-date version of the package (You can search the thread on the forums if you don't feel like browsing through multiple pages). If there's no mention of the issue in the comments, post it. Also note: I prefer comments on Nexus Mods over YouTube video comments.

Q: What are paths?A: Read the documentation.

Q: I ran mteFunctions.pas and it didn't do anything, what gives?A: It's not supposed to do anything, it's a library of functions that are used by other scripts. Don't run it.

Q: I ran the armor mod builder and no records were created, why?A: The armor mod builder will build records for armor pieces based on the nif file names available in the specified directory. Make sure you have TES5Edit installed in your Skyrim directory, entered a valid directory for the nif files associated with the Armor mod you want to build, and named your nif files correctly according to a format supported by the script (see the documentation).

Q: I'm trying to use the Replace FormID/Armor Mod Builder/QuickChange script but the FormID list isn't loading, why?A: You have to select something in the appropriate drop down menu for the lists to load. Even if the FormID you're looking for is in the file that the menu starts on by default, or if the function you want to use is the one that the menu starts on by default, you need to re-select it in order to load the FormID list.

Q: When I tried to open the help manual (AutomationTools.chm) I got the error "Navigation to the webpage was cancelled." How do I fix this?A: See the Stack Overflow resolution. Also see the post by keithinhanoi. You can also try unblocking it from the right click -> properties menu or at the bottom of theright click menu.

Q: Why aren't there more questions and answers here?A: Because the package was just released! This section will grow as more questions are asked.

ThanksThis package of scripts was made possible thanks to the following people:

Zilav - The TES5Edit scripting guru, my teacher.FiftyTifty - TES5Edit scripter, tester, and contributed names for the NPC generator. Helped come up with several script ideas as well.turulo - TES5Edit scripter, and source of several ideas for the package, including the functions library.Treplos, DanielUA, and everyone else who posted in the suggestions thread. Thanks for your ideas and support.