Online:UespLog AddOn

The UESPWiki – Your source for The Elder Scrolls since 1995
Online(Redirected from User:Daveh/uespLog Addon)
Jump to: navigation, search

The uespLog add-on for ESO adds basic data logging to the game. Note that this addon is currently in development. If it crashes or displays error messages simply disable it. The add-on is also available at ESOUI and Nexus Mods.

Installation[edit]

  • Download File:Eso-Addon-uespLog.zip or from ESOUI and Nexus Mods.
  • Unzip and copy into your Documents\Elder Scrolls Online\live\Addons\uespLog\ folder, or Documents\Elder Scrolls Online\liveeu\Addons\uespLog\ if you play on the European megaserver
  • Start ESO and enable uespLog from the add-on menu
  • For more accurate looting data you should turn "Consolidate Area Loot" off in game settings
  • Note on Data Collection: Data collected by uespLog is *not* automatically uploaded to the UESP! You must use the uespLogMonitor (Windows program) to automatically monitor and upload logged data or manually upload logs. If you do not wish to collect data you can turn the data logging feature off via /uesplog off and still use the remaining features of the add-on.

Usage[edit]

  • /loc gives you the current world location (or /loc name to log the location with a given name).
  • /uesphelp Displays basic help for the add-on.
  • /uespset Opens the add-on settings menu.
  • /uesplog on|off turns the logging on and off.
  • /uespdebug on|off|extra turns on various debugging information to the chat window.
  • /uespdump inventory outputs all items in your inventory, and bank (not the guild bank) to the log.
  • /uespdump achievements outputs *all* achievements to the log.
  • /uespdump recipes outputs all known recipes to the log.
  • /uespdump globals outputs the Lua global object table to the log.
  • /uespdump globals [maxlevel] -- Normal method to dump the globals all at once to the specified tree depth.
  • /uespdump globals start [maxlevel] -- Start iterative global dumping to the given tree depth.
  • /uespdump globals stop -- Stop iterative dumping.
  • /uespdump globals status -- Current status of iterative dump.
  • /uespdump skills or /uespdump skills basic -- Dumps basic skill information to the console.
  • /uespdump skills [all|learned|progression|types] [note] -- Dumps more skill information to the log.
  • /uespcount displays the number of various logged elements and their estimated size.
  • /uespcount recipes displays basic recipe counts for your character
  • /uespcount achievements displays basic achievement counts for your character
  • /uespcount traits displays all known traits for your character
  • /uespreset all|globals|achievements|log deletes all or specific portions of the current logged data.
  • /uesptime displays the various game times (see note below on the estimated in-game time).
  • /uespresearch or /uri displays information on your current research timers.
  • /uespcolor on|off turns color messages from the add-on on or off (default is on).
  • Data is saved automatically to the Documents\Elder Scrolls Online\live\SavedVariables\uespLog.lua file.
  • /uespcraft on|off turns the craft/item display in lists and tooltips on and off.
  • /uespcraft style on|off turns the item style display on/off.
  • /uespcraft trait on|off turns the item trait display on/off.
  • /uespcraft ingredient on|off turns the provisioning ingredient level display on/off.
  • /uespcraft autoloot on|off turns the addon autoloot function on/off.
  • /uespcraft minprovlevel [level] sets the minimum provisioning level of ingredients to autoloot. Use level 1-6 for normal ingredients, 100 for blue ingredients and 101 for purple ingredients.
  • /uespdump smith outputs all smithable items to the log while at a smithing station.
  • /uespdump smithset outputs all smithable set items to the log while at a set smithing station.
  • /uespmakelink ID LEVEL SUBTYPE or /uml manually creates an item link with the specified data. LEVEL is optional and should be 1-50. SUBTYPE is optional and should be one of the following values:
  • 0-1 = Default (most misc items have 1)
  • 2-6 = Normal to Legendary quality for most dropped equipment from levels 1-50
  • 7 = Superior quality for some dropped equipment levels 1-50?
  • 8 = Epic quality for some dropped equipment levels 1-50?
  • 9 = Fine quality for some dropped equipment levels 1-50?
  • 20-24 = Normal to Legendary quality for all level 6-50 crafted equipment
  • 25-29 = Normal to Legendary quality for all level 4 crafted equipment
  • 30-34 = Normal to Legendary quality for all level 1 crafted equipment
  • 39-49 = VR1-10 fine quest reward?
  • 51-60 = VR1-10 Fine dropped equipment
  • 61-70 = VR1-10 Superior dropped equipment
  • 71-80 = VR1-10 Epic dropped equipment
  • 81-90 = VR1-10 Superior dropped (chest)? equipment
  • 91-100 = VR1-10 Epic dropped (boss mob)? equipment
  • 101-110 = VR1-10 Legendary dropped? equipment
  • 111-120 = VR1-10 Normal dropped/sold equipment
  • 125-134 = VR1-10 Normal crafted equipment
  • 135-144 = VR1-10 Fine crafted equipment
  • 145-154 = VR1-10 Superior crafted equipment
  • 155-164 = VR1-10 Epic crafted equipment
  • 165-174 = VR1-10 Legendary crafted equipment
  • 229-231 = VR11 Fine-Epic dropped? equipment
  • 232-234 = VR11 Superior-Legendary dropped? equipment
  • 235 = VR11 Normal store? equipment
  • 236-240 = VR11 Normal-Legendary crafted equipment
  • 254-258 = VR12 Normal-Legendary crafted equipment
  • 262-276 = VR13 Normal-Legendary equipment
  • 290-294 = VR14 Normal-Legendary equipment
  • 308-312 = VR15 Normal-Legendary equipment
  • /uespcharinfo or /uci displays a bunch of character information and statistics.
  • Most right-click menus have a new Show Item Info option which displays extended information about the item in the chat window.
  • /uespmineitems or /umi can be used to mine item data automatically. Note that this feature is experimental and can crash the ESO client. Use at your own risk!
  • /uespmineitems [itemId] -- Mine items for the given item ID (1-100000).
  • /uespmineitems status -- Show the current status of mining items.
  • /uespmineitems start [startItemId] -- Start automatically mining items at the given item id.
  • /uespmineitems stop -- Stop automatically mining items.
  • /uespmineitems idcheck [note] -- Does a quick check of which items exist.
  • /uespmineitems quickk [on/off] -- Turns quick mining mode on and off. When on mining items will only log the white v16 version of each item.
  • /uesppvp on/off -- Toggles the display of PVP campaign information in the chat window.
  • /uesppvp showfights or /upf -- Shows all fights currently going on in your PVP campaign.
  • /uespenl or /ue -- Displays your current enlightenment experience and bonus.
  • /uespd [cmd] or /ud [cmd] -- A short form for /script d([cmd]).
  • /uespset -- Opens the uespLog settings interface menu.
  • /uesptreasuretimer or /utt -- A simple treasure timer used when looting a chest or heavy sack.
/utt : Shows the current status
/utt [on/off] : Turns the timer on/off (default is off)
/utt [name]  : Shows the timer length for the given container name. Valid names are: Chest, Heavy Sack, Safebox
/utt [name] [duration] : Set the duration in seconds for the given container.
  • /uesplorebook or /ulb enables/disables the "Lorebook found" message received when reading a normal book for the first time.
/ulb Shows the current setting
/ulb [on/off] turns the setting on (default, message shown) or off (no message shown).
  • /uespsavebuild or /usb saved character build data to the log
/usb [Build Name] saves the current character build data with the given name
/usb status shows the current number of saved builds
/usb clear deletes all currently saved builds
/usb forcesave [Build Name] saves a character build ignoring any errors or warnings
  • /uespstyle shows the known style motifs for your character.
/uespstyle [style name] shows which part of the given style motif you know
/uespstyle liststyles lists all the valid style names
  • /uespmsg turns categories of add-on messages on/off.
/uespmsg Shows the current stats
/uespmsg [on|off] Turns all messages on/off
/uespmsg loot [on|off] Turns loot related messages on/off
/uespmsg npc [on|off] Turns NPC related messages on/off
/uespmsg quest [on|off] Turns quest related messages on/off
/uespmsg other [on|off] Turns all other messages on/off
  • /uespcontloot [on|off] enables/disables autolooting items from containers in your inventory.
  • /uespcustomstat [on|off] enables/disables display of custom stats in the character/inventory windows.

Usage Tips[edit]

  • The settings menu can be quickly accessed with the /uespset command.
  • If you don't wish to collect data you can turn it off with the /uesplog off command or in the settings menu with the Log Data option.
  • If any of the style/trait/motif inventory icon display interferes with a similar add-on you can turn them off in the settings menu under Crafting or with the commands:
  • /uespcraft style off
  • /uespcraft trait off
  • /uespcraft recipe off
  • /uespcraft ingredient off
  • A bunch of useful messages can be displayed in the chat window with the /uespdebug on command or set the Logging Output to "on" in the settings menu. This includes data like items looted, telvar stones, alliance points, books/quests/NPCs encountered etc.... For addon programmers the /uespdebug extra may be useful.
  • If the add-on's chat messages are too colorful you can turn it off with the /uespcolor off command.
  • All logged data can be cleared with the /uespreset all command.
  • The /ud command is useful for programmers to debug things in game. For example: /ud GetNumSmithingStyleItems(). All game API functions can be found at ESOUI.com.
  • Some of the more useful commands include:
  • /loc gives you your current position and heading.
  • /uri or /uespresearchinfo shows you which traits you are currently researching.
  • /uespstyle stylename shows you which chapters of the given style you know for crafting.
  • /uespcount recipes shows how many recipes you have learned.
  • /uesptime shows the in-game and world date and time as well as moon phase.
  • /uci or /uespcharinfo lists a variety of character stats.
  • /ue or /uespenl shows your current enlightenment.

Submitting Logs[edit]

There are two ways to submit data logged from the addon to the UESP:

  1. Use the included uespLogMonitor Windows application to automatically upload data.
  2. Upload data using the manual submission form.

Viewing Log Data[edit]

All the collected data can be viewed in our online ESO Log Viewer (WARNING: Under very early development).

If you use the uespLogMonitor application then all local data you log is backed up on your computer in the uespLog_backup.txt file in the same directory as the program and can be viewed in any text editor.

Data Logged[edit]

  • Items looted
  • Crafted items
  • Items sold and bought
  • Skyshard locations
  • Book locations and text (normal and lore)
  • Fishing hole locations
  • Chest locations
  • Various quest data
  • NPC Dialog (most of it anyways)
  • NPC data (location, basic stats, ignores common NPCs like Rats, Rabbits, etc...)
  • Recipes learned
  • Money looted and quest rewards
  • All known recipes (with the /uespdump recipes command)
  • Achievements (all achievements are output with the /uespdump achievement command)
  • Global function table (with the /uespdump globals command)
  • Experience gained

uespLogMonitor[edit]

The addon includes the uespLogMonitor.exe Windows application which, when run, will automatically monitor the data logged by the uespLog addon and submit it to the UESP. After data is submitted it will be periodically deleted to ensure the saved variable file doesn't become too large. All you need to do is start the application at any time to begin the automatic monitoring and submission of data. Basic options are available but all have defaults which should work for most people. All you have to do is to run the program whenever ESO is running.

How often is data checked and sent?
  • The default is every 1 minute but this can be changed. Data is only sent if it has been updated since the last check. Note that the game only saves the logged data at certain times (logging out, some zone changes, and /reloadui).
What data is sent to the UESP?
  • Almost all the data is just the logged game data from uespLog (see here). Your character/account name is sent but this can be changed in the application options. Your IP address is sent in order to prevent service abuse and bans if required but is not made publicly available.
Where is the raw or parsed data available?
Why does my saved variable file keep growing in size?
  • The uespLogMonitor does delete data from the saved variable file after it is sent but due to how the game updates this file these changes will only take place once you log out of the game. The next time you log in your saved variable file should be mostly reset. Note that a saved variable file of several MBs should not noticeably interfere with the performance of the game unless you are running on a low-end system.
Can I keep a copy of the logged data?
  • All logged data is backed up into another file before being deleted from the saved variables file. By default this is the uespLog_backupData.txt file in the same directory as the application but this can be changed in the program's options.
What happens if the game crashes?
  • Unfortunately due to the way ESO saves things all logged data from the current session will be lost if the game crashes. To prevent lost data you can either do a /reloadui occasionally or log out and back in every few hours.
Can I just use the features of uespLog without the data logging?
  • Yes, simply enter /uesplog on|off once in the game to turn off all automatic data logging. All other features of the addon will remain available.

Game Time Notes[edit]

The /uesptime command shows the estimated game time. There is currently no in-game API function that gives you the actual game time so it is estimated from observation. The current estimation may drift slightly over time until it can be corrected. The in-game time along with several real time zones can be seen at esoclock.uesp.net.

The game time calculations use the following constants to compute the time:

  • v0.14
  • Real Time Start = 1396079125 sec
  • Game Time Year Start = 2E 582
  • Real Seconds Per Game Day = 21000 sec
  • Real Time Moon Phase Start = 1395876240 sec
  • Real Seconds Per Moon Phase = 345600 sec (4 days)
  • v0.18
  • Real Time Start = 1396083600 sec
  • Game Time Year Start = 2E 582
  • Real Seconds Per Game Day = 20955 sec
  • Real Time Moon Phase Start = 1395876240 sec
  • Real Seconds Per Moon Phase = 345600 sec (4 days)
  • v0.27
  • Real Time Moon Phase Start = 1395696240 sec (new moon start)
  • Real Seconds Per Moon Phase = 360000 sec (4.17 days)
The prior moon values were estimates and drifted off badly after a time.

The latest values set in v0.27 seem to give the correct time values over several months of real time.

Version History[edit]

  • v0.10 - 30 March 2014
  • First release (earlier versions were for beta)
  • v0.11 - 31 March 2014
  • Added a list of common NPCs to ignore (Rat, Mudcrab, Familiar, etc...)
  • Removed inventory update message
  • Fixed crash when using /uesplog on/off
  • Tweaked some messages
  • Gold looted and gold quest rewards are now logged
  • v0.11a - 31 March 2014
  • Removed money messages used for testing
  • v0.12 - 8 April 2014
  • Added /uesptime command
  • Log change in skill points (for quest rewards)
  • Now logs maximum HP/MG/ST for NPC targets
  • Logs lock quality on chests
  • Coordinates shown in bottom left on map in range (0,0) to (1,1)
  • Added 'recipes' and 'achievements' options to /uespcount
  • Added the 'extra' option to /uespdebug for testing purposes
  • v0.13 - 15 April 2014
  • Shows inspiration for crafting events
  • Shows the link for crafted items
  • Added the /uespresearch command
  • Added some messages in custom colors
  • Added the /uespcolor on|off command
  • uespLogMonitor: Fixed escape issue
  • uespLogMonitor: Fixed issue not sending log entries with "blank" section in saved variable file
  • uespLogMonitor: Log file is appended to and more things output to it
  • uespLogMonitor: Added two file menu commands
  • Fixed logging of target positions
  • v0.14 - 2 May 2014
  • Fixed item link/name display for crafted items
  • Better logging of resource node positions
  • Distinguish between group and self loot event
  • Added estimated game time and moon phase for /uesptime
  • Added /uespcount traits
  • Added XP display and logging
  • Improved display of item links
  • Added MG/HP/ST/UT change display in debug output mode
  • More colors (disable color messages with /uespcolor off)
  • v0.15 - 18 May 2014
  • Added the "/uespdump smith|smithset" commands
  • Dumps all smithable items to log when using an appropriate crafting station
  • Adds a right-click "Link in Chat" menu option to popup item link
  • Adds a right-click "Show Item Info" menu option on inventory lists and item popups
  • Added the "/uespmakelink" (/uml) command
  • Format: /uespmakelink ID LEVEL SUBTYPE
  • ID is required but LEVEL/SUBTYPE are optional
  • For SUBTYPE description see Item Link Format
  • Fixed crash when looting some resources in non-english versions of the game
  • Added the "/uespcharinfo" (/uci) command
  • Added logging of veteran and alliance points
  • Trade skill information display:
  • Use "/uespcraft" to turn various components of the display on/off
  • Shows provisioning level of ingredients in inventory lists and tooltips
  • Color codes blue/purple ingredients
  • Shows whether recipe is known or not in inventory lists (english only at the moment)
  • Shows whether weapon/armor trait is known or not in inventory lists and tooltips
  • Shows the item style in inventory lists and tooltips
  • Provides a similar function as the Show Motifs add-on
  • Compatible and similar function as the SousChef add-on
  • Compatible and similar function as the ResearchAssistant add-on+
  • In Testing: Added autolooting of provisioning ingredients:
  • Only loot ingredients more than a specific level
  • Auto loot all other items and money
  • Turn off the autoloot in the game options to use
  • Use "/uespcraft autoloot on/off" to enable (initially disabled)
  • Use "/uespcraft minprovlevel [level]" to set which level of ingredients to autoloot
  • Normal ingredient level is 1-6, 100 for blue ingredients and 101 for purple
  • Displays a "Skipped..." message for items not looted
  • Skipped provisioning items remain in the container
  • v0.16 - 19 May 2014
  • Fixed display of the "Show Item Info" menu item.
  • Ingredient and style information shown in tooltip from a clicked item link (trait info can't be shown).
  • Tweaked looting messages.
  • Game language added to all log data.
  • Footlockers now close properly when autoloot is on.
  • v0.17 - 24 May 2014
  • Always loot plump worms and crawdads (so flower nodes disappear when looted).
  • Fix crash when autolooting quest items.
  • Fixed display of pepper ingredient.
  • Upgraded to 100004 API version for Craglorn.
  • v0.18 - 2 July 2014
  • Items linked in chat messages are logged.
  • Items looted from mail messages are logged.
  • Added a simple craft inspiration summation meter.
  • Reset via: /uespreset inspiration
  • Check via: /uespcount inspiration
  • Item information shows the weapon and armor types.
  • Added "/uesptime calibrate" to help with time calibration and testing.
  • Improved the game time estimation.
  • Changed API version to 100007.
  • Added check to prevent NIL string outputs to log data.
  • v0.19 - 21 August 2014
  • Changed API version to 100008.
  • Fixed crash when using "/uespdump inventory" due to API change.
  • Fixed "nil string" crash bug due to strings over 1999 bytes being output to the saved variable file. Long strings are split.
  • uespLogMonitor increased to v0.15 to include support for split log strings and default support for the "liveeu" folder.
  • v0.20 - 4 November 2014
  • Fixed updated GetNumLastCraftingResultItemsAndPenalty() function.
  • Updated API to 100010.
  • Fix the CSV export utility.
  • Attempted fix to replace the now remove 'reticleover' target position (uses the player position instead).
  • Show item info fixed (updated new function names).
  • v0.21 - 17 November 2014
  • Fixed "/uespdump achievements" due to removed function.
  • Fixed issue with facial animations.
  • More conversation data is now logged.
  • Added Dwemer style icon.
  • The "Show Item Info" context menu works in more places now.
  • "Show Item Info" displays much more item information.
  • Much more item information is now logged.
  • If you receive a "Low LUA Memory" warning you can try to increase the "LuaMemoryLimitMB" parameter in the UserSettings.txt file.
  • Dumping globals works better. Removed duplicate entries and unecessary objects. Userdata objects now dumped. Duplicate "classes" no longer dumped to save space.
  • Dump globals now outputs the string for SI_* values.
  • Added a method to iteratively dump all the global objects.
/uespdump globals [maxlevel] -- Normal method all at once
/uespdump globals start [maxlevel] -- Start iterative dumping
/uespdump globals stop -- Stop iterative dumping
/uespdump globals status -- Current status of iterative dump
  • Started work on "/uespmineitems" (/umi) for mining item data. Use with caution as it can easily crash your client.
/uespmineitems [itemId]
/uespmineitems status
/uespmineitems start [startItemId]
/uespmineitems stop
ItemIds are just numbers from 1-100000.
  • BUG: Sometimes the saved variable data gets corrupted. This seems to occur during a global dump on rare occasions and is most likely an ESO/LUA engine bug. Use "/uespreset all" to clear the saved variable data back to an empty state which can usually fix this.
  • Added short initialization message on startup.
  • v0.22 -- 11 March 2015
  • Added "/uespmail deletenotify on|off" to turn the mail delete notification prompt on/off.
  • Created item links use the item's name if available and valid.
  • Added the "/uespcomparelink" (/ucl) command for testing item link comparisons.
  • Added more data to the show item info output and item data logs.
  • Warning is shown if any section data exceeds 65000 elements. The game seems to truncate arrays loaded from the saved variables to under ~65540 elements.
  • Added the "/uespmineitem autostart [id]" mode. In this mode the item:*miner will create 50000 log entries before automatically reloading the UI, resetting the logged data and continuing. It will stop when you do "/uespmineitem stop" or the itemId reaches 100000.
  • Changed color of item mining output to be more unique.
  • Added the "/uespmineitem qualitymap".
  • Added the "/uespmineitem subtype [number]" for only mining items of a certain type.
  • Added the "/ut" shortcut for "/uesptime".
  • Added the "/uespmakeenchant" (/ume) command.
  • Fixed showing and logging of item trait abilities (crafted potions).
  • Fixed crash on looting items from Update 6.
  • Fixed crash due to renamed INTERACT_WINDOW object.
  • Changed API version to 100011.
  • Fixed issue with autolooting.
  • v0.23 -- 3 June 2015
  • Fixed bug with Justice System / bounty error (no longer errors out when a guard acosts you).
  • v0.24 - 27 July 2015
  • Fixed item mining due to new item link format (1 more unknown data field).
  • Added a basic settings menu using LibAddonMenu-2.0. Settings can be accessed through the game's Settings--Addon menu or via "/uespset".
  • Bundled uespLogMonitor updated to v0.16 (minor performance based improvements).
  • Added the "/uespreset log" option to reset just the normal logged data section.
  • Fixed display issue when turning crafting display on/off.
  • Removed the autoloot function since ingredients don't have levels after update #6.
  • Provisional ingredients updated from update #6.
  • Item style text/icon only displayed for weapons and armors.
  • Craft/trait/style info is now shown in the guild trader windows.
  • Added the "/uespmineitems idcheck" command. Simply loops through all IDs and checks if it is a valid item or not and outputs a list of valid item ID ranges to the log.
  • Added basic icons for Yokudan and Akaviri styles.
  • Updated the experience messages. Veteran players will no longer receive the double experience debug message.
  • Fixed game crash bug when trying to buy a horse.
  • Fixed a game crash bug when using a quartermaster in Cyrodiil.
  • Gold stolen from safeboxes will now be displayed.
  • Shortened/tweaked the log message displayed in the chat window.
  • Fixed the trait known/unknown display for nirnhoned items.
  • v0.25 - 30 July 3015
  • Added "/uespdump skills".
  • Fix bug with negative xp values sometimes displayed.
  • Added the "/uespenl" command to show the character's enlightenment pool.
  • Added viewing of PVP events toggled by the "/uesppvp on/off" command (default is off). This is currently in testing and may be a bit spammy if you are in an active campaign.
  • "/uesppvp showfights" will show all known fights in the current campaign.
  • Fixed bug that results in a very large saved variable file.
  • Fixed more crash bugs related to the guild store.
  • Tweaked startup message.
  • v0.26 - 31 July 2015
  • Fixed another crash bug when the guild store is first opened.
  • Style of rings and necklaces will no longer be shown.
  • Item tooltips for stacks of items in the guild store include a "price per item" line.
  • v0.30 - 30 Aug 2015 (Imperial City DLC, game update 1.7
  • Tweaked /uesptime output, added day of month and adjusted moon phase calculation.
  • Online game time can be seen at: http://content3.uesp.net/esoclock/esoclock.php
  • Update API version to 1000012.
  • Telvar stones gained/lost will be shown if debug output is on.
  • Added style icons for the new Glass/Xivkyn styles.
  • Added the "/uespd [cmd]" (or "/ud [cmd]") command which is a short form for "/script d([cmd])".
  • "/upf" is now a short form for "/uesppvp showfights".
  • "/ue" is now a short form for "/uespenl".
  • All colored text is closed by a "|r" to make sure it doesn't 'leak',
  • Added known/unknown display to motif tooltips and rows.
  • Tweak position of style/known icons in lists.
  • Changed the skill dump command and output. Now outputs a lot more information to the log. Now has the format:
/uespdump skills
/uespdump skills [basic/progression/learned/types/all] [note]
  • v0.40 - 2 November 2015
  • Ability icons are logged in skill dumps with the new GetAbilityIcon(abilityId) function.
  • Added new item sub-types for V15/V16 equipment for item mining.
  • Added some creatures to ignore from the Imperial City.
  • "/uespdump globals" now works with private functions with numbers in their name.
  • Trait display fixed for Nirnhoned items currently being researched.
  • Tweaked looting messages and included Safeboxes in logged data.
  • Added the /uesptreasuretimer (or /utt) for keeping track of looted containers. Once a container (chest, heavy sack, or safebox) is looted a timer will start and notify you with a chat message in a given amount of time. Current defaults are 2 minutes (120 sec) which works for chests in delves but may be too short for other containers in some zones.
/utt : Shows the current status
/utt [on/off] : Turns the timer on/off (default is off)
/utt [name]  : Shows the timer length for the given container name. Valid names are: Chest, Heavy Sack, Safebox
/utt [name] [duration] : Set the duration in seconds for the given container.
  • Added more options to "/uespdump skills" to make it easier to dump partial skill logs for a certain class/race.
  • The "/umi idcheck" was changed to do an iterative check instead of trying to do it all at once which resulted in a game crash. Now when run it will check 5000 items every 2 secs until finished. It cannot be stopped/interrupted once started.
  • Added the "/umi quick [on/off]" option for mining items. Only mines/logs the normal v16 version of each item.
  • Fixed item links with no name showing (for Orsinium PTS).
  • Added Orsinium mobs to ignore when logging.
  • v0.41 - 2 December 2015
  • Added some more Orsinium mobs to ignore when logging.
  • Fixed logging of hireling mail items (properly logs hireling type).
  • Added new/missing style icons.
  • Removed the "Craft completed..." log message if no inspiration was gained.
  • Tweaked inventory style/trait icon positions.
  • Added the /uesplorebook (/ulb) command. This turns the various "Lorebook Learned" messages seen at the top of the window on/off as follows:
/uesplorebook -- Display status
/uesplorebook help -- Display basic help
/uesplorebook on -- Display all lorebook messages (default)
/uesplorebook off -- Only display Mages Guild related lorebook messages
  • Fixed issue with message if you looted something at the same time as a group member.
  • Zipped install file includes the root folder "uespLog".
  • v0.50 - 17 December 2015
  • REQUIRED UPDATE: uespLogMonitor updated to v0.20 to include the character build data upload and some critical related bug fixes.
  • Fixed known/unknown display of the Mercenary style motifs. While the base game API is still bugged for this style (it always says the style/chapter is unknown), uespLog now manually tracks the mercenary style. To setup simply visit a blacksmith and a woodworking station for the add-on to automatically save your currently known mercenary chapters. This will be saved between sessions and updated automatically when you read a new mercenary chapter. If the status of a mercenary motif is uncertain no text/icon will be displayed.
  • Added the /uespstyle command for displaying which chapters of a particular motif are known or unknown.
/uespstyle [stylename] -- Shows which chapters you currently know or not
/uespstyle list -- Shows all the style names accepted by the command
  • CHARACTER BUILD SAVING (needs testing)
A new feature which permits the saving of character build data (equipment, action bars skills, champion points, buffs, etc...) and the uploading of the build data to the UESP.net website for display (http://www.uesp.net/wiki/Special:EsoBuildData).
For more detailed instructions see: UESPWiki:EsoCharData
To Save Characters:
  • Use the /uespsavebuild (or /usb) command in the game:
  • /usb [buildname] -- Saves the character data
  • /usb forcesave [buildname] -- Saves data and ignores any errors
  • /usb status -- Shows how many saved builds are in the log
  • /usb clear -- Deletes all builds currently in the log
To Upload Characters:
  • On PC/Windows you can use the included uespLogMonitor program to automatically upload the saved build data when the uespLog saved variable file is updated.
  • http://esolog.uesp.net/submit.php -- Uploads all logged and character data from a saved variable file.
  • http://esobuilds.uesp.net/submit.php -- Uploads just the build data from a saved variable file.
Submit bugs and feature requests to @Reorx in game or at UESPWiki_talk:EsoCharData.
  • v0.60 - 7 March 2016
  • REQUIRED UPDATE: uespLogMonitor updated to v0.30 to include the character data upload.
  • Added the "/uespsavebuild screenshot" (or "/usb ss") command to take a nicely framed screenshot of your character.
  • The set count of equipped items is now saved with the "/uespsavebuild" command.
  • Added the "/uespmineitems count" parameter.
  • Added missing item level/subtype combinations for item mining.
  • Fixed minor bug with "/uespreset all" and build data.
  • Added the "/uespmineitems level" parameter.
  • Added new Thieves Guild mobs to ignore list and removed "Mudcrab".
  • Add support for logging "Thieves Trove" along with treasure timer.
  • The new item tags are logged and shown in item info.
  • Fixed bug in manual tracking of Ancient Orc and Mercenary styles (although they should now be tracked correctly in-game after the Thieves Guilds update).
  • Werewolf character state is properly saved when saving a build.
  • Action bars are saved between sessions so you should no longer have to swap weapon bars each time you login to save a character build. Also fixed a bug which incorrectly considered action bar data to be not saved even though it was.
  • The last food/drink consumed will be properly tracked for build/character data. Potions and other items consumed will be ignored.
  • Added chat message when you take gold from mail attachments.
  • Added the "/uesptrait" command to show known trait information:
/uesptrait Shows all traits for all crafting skills
/uesptrait blacksmith Shows known traits for blacksmithing
/uesptrait clothier Shows known traits for clothier
/uesptrait woodworking Shows known traits for woodworking
Note that traits shown as "[trait name]" in this command are being researched and are not considered as being "known". Reworked the "/uespcount traits" command to just show the known trait counts.
  • Added the "/uespskillpoints" or "/usp" that shows the total number of skill points used and acquired on the character.
  • Quest item links are now logged (this is currently the only way to get information about quest items).
  • Removed the "Quest conversation updated", "Quest Advanced" and "Updated conversation" log messages from normal output.
  • Changed default of data logging (/uesplog on/off) to false to prevent collection of data and increasing the sized of the saved variable file for people not interested in collecting data. This only affects new installations. Use "/uesplog on" to ensure data collection is enabled.
  • Fixed bug where menu settings were not being displayed the first time you open the add-on's settings menu.
  • Handle eating food/drink from the quickslot bar.
  • Beta: Show log message when creating a glass motif chapter.
  • Resulting glyph levels will be shown in Enchanting Potency Runestone tooltips.
  • BETA: Skill Coefficients
Added basic skill coefficient mining with "/uespskillcoef" or "/usc". The equation for the base skill tooltip is
                BaseTooltip = A * Stat + B * Power + C
where "Stat" is Magicka/Stamina and Power is Spell/Weapon Damage. The A/B/C parameters are not exposed in the game's API so must be calculated indirectly. The usual way to calculate these parameters is to record several different Tooltip/Stat/Power value combinations and do a "best fit" calculation. The "/uespskillcoef" command encapsulates all the math so all you have to do is provide several different Stat/Power combinations and "/uespskillcoef" will return the A/B/C parameters along with an "R" parameter (R-squared) indicating how accurate the fit is. An R value of "1" indicates a perfect fit with lower values indicates a worse fit.
The /uespsavecoef (or /usc) command has the following parameters:
               /usc save               Save current skill data for the character. Note that only purchased skills
                                       will be saved. All 3 versions of each skill will be saved (original and two morphs).
                                       Note that logging out or "/reloadui" will clear the saved skill data.
               /usc calc               Calculate coefficients using previously saved skill data and store
                                       coefficient data in the log. The "tempData" section of the saved
                                       variables will also contain a CSV version of the coefficient data.
               /usc coef [name]        Shows the calculated coefficients for the given skill name.
               /usc coef [id]          Shows the calculated coefficients for the given skill ID.
               /usc status             Current status of saved skill data.
               /usc clear              Resets the saved skill data. Note that logging out or "/reloadui" will
                                       also clear the saved skill data.
               /usc savewyk [prefix] [start] [end]  
                                       Saves skill data using Wykkyd's Outfitter add-on. 
                                               ex: /usc savewyk Test 1 9
                                       would try to load the sets 'Test1'...'Test9' and save the skill data
                                       for each of them.
               /usc stop               Stops a Wykkyd item set save in progress.
The quality of the skill coefficients depend on the number and variety of stat/power combinations saved with "/usc save". A minimum of 3 saved sets are needed but in general you want many more. Ideally you want to vary all stats (Stamina, Magicka, Spell Damage, Weapon Damage) as much as possible to get more accurate results. To capture more data also vary things like armor types and weapon types as much as possible.
The general procedure to accurately record/calculate skill coefficients is:
  1. Reset all champion points.
  2. Reset all skills.
  3. Purchase the base rank of all passives.
  4. Remove all skills from both ability bars.
  5. Equip/unequip items to change stats.
  6. Wait at least 5 seconds after changing equipment to let the game correctly update the skill values.
  7. Run "/usc save".
  8. Repeat steps 5-7 for 10 or more different stat combinations (magicka, stamina, spell/weapon damage).
  9. Run "/usc calc".
  10. Run "/reloadui" or logout to update the saved variables.
  11. Upload the saved variable file or copy/paste the coefficient data from the "tempData" section.
Uploaded and parsed skill coefficient data can be found at http://esolog.uesp.net/viewSkillCoef.php or in the mined skills database at http://esoitem.uesp.net/viewlog.php?record=minedSkills
  • BETA: Offline Character Data
Expanding on the recent "Build Data" uespLog now has the option to automatically record more character data in order to view it offline. By default this feature is disabled. It can be enabled by the command:
                         /uespchardata on (or ucd on)
When enabled character data will be saved whenever logging out, quitting or UI reloads.
Character data uploading can be done the same way as build data:
  1. On Windows use the included uespLogMonitor program to automatically upload data.
  2. Use the http://esolog.uesp.net/submit.php form to manually upload all log, build, and character data.
  3. Use the http://esochars.uesp.net/submit.php form to manually upload build and character data.
Once uploaded the characters can be viewed at: http://esochars.uesp.net
                         /ucd                              Short command name
                         /uespchardata [on/off]            Turn automatic saving on/off (default off)
                         /uespchardata save                Manually save the character data
                         /uespchardata password [text]     Change the character data password
                         /uespchardata password clear      Set no password
PASSWORDS: You can and should set a character data password with the command:
/uespchardata password [text]
By default there is no password which means anyone can potentially upload and overwrite your character data. If a password is set then only uploads with that password will be permitted. You can clear a set password with "/uespchardata password clear".
Data saved by the offline character data system includes:
  • All skills/abilities/champion points and character stats
  • All characters on account (you must login with each character to save it)
  • Equipped items
  • Character and bank inventory
  • View combined account wide inventory of all characters + bank
  • Crafting motifs learned
  • Crafting traits researched
  • Current status of crafting research (automatically updates research finish date/time)
  • v0.61 -- 10 March 2016
  • Adjusted log message when selling multiples of something.
  • Char/build data tracks the 6 new styles.
  • Added the "/uesptreasuretimer list" command to show timer durations as well as timers currently in progress. Timers shown in this list will persist through logins and /reloadui but the timer log notice will not.
  • Fixed "/uesptreasuretimer thieves trove [duration]" to work.
  • Updated some item style labels with new values.
  • Fixed bug that prevented book data from being logged.
  • CRITICAL: Fixed bug that was causing extreme lag when killing things with a Destruction Staff (and Two-Handed/Bow to a lesser extent). Root cause was due to the EVENT_ACTION_SLOT_UPDATED event being called 40-50 times at once when you kill a mob with a Destruction Staff equipped. The event was triggering the saving of action bar data which caused the lag when done +40 times in the same frame. Action bar saving is now only done at most once every 5 seconds.
  • v0.62 -- 12 March 2016
  • Slash commands that don't start with "/uesp..." are checked to see if they exist before they are set. This prevents them from interfering with any other add-on that might happen to use them.
  • Added the "/rl" chat command as a short form for "/reloadui".
  • Added the "/afk", "/away" and "/back" chat commands for setting the player status (seen in guild).
           /afk                                                    Toggles AFK state on/off (away/online)
           /afx [on/off]                                        Turns AFK state on and off (away/online)
           /afx [away|online|dnd|offline]       Sets player status to a specific state
           /afx status                                          Shows the current player status
           /away                                                        Turns state to "Away"
           /back                                                        Turns state to "Online"
  • Fixed logging of Thieves Troves.
  • Added "/uespmineitems reloaddelay [seconds]" command for adjusting the minimum reload delay when auto mining items.
  • Shortened the output from "/uespstyle". Added the "/uespstyle long [style]" command to format output in the long format.
  • Another fix to try and eliminate the little bit of lag that some people experience when killing mobs with a Destruction Staff equipped.
  • v0.70 -- 31 May 2016
  • REQUIRED UPDATE: uespLogMonitor updated to v0.40 with updates to the character data upload.
  • Fixed "Show Item Info" menu item when smithing an item.
  • Updated clock/moon phases to be more accurate and match the lore date given by other addons.
  • Improved skill data logging.
  • Tweaked skill message when finding a Skyshard.
  • Many changes to skill coefficients. The saved stat data is now saved account wide when logging out so you can save between multiple characters. Calculated coefficients are not saved.
  • Fixed crash on OSx clients when catching a Wet Gunny Sack.
  • Output in "/uespdebug extra" mode displayed in a different color (light gray).
  • Added the "/uespdump skills missing [note]" command for dumping skills that are missing from the current PTS character templates.
  • Added the "/uespshowcoor [on|off]" command to turn the map coordinate display on/off. Thanks to Ptits de Barbe for submitting this patch.
  • Added the "/uespminecollect [note]" command for logging collectible data.
  • Updated achievement data logging.
  • Fixes for PTS update 10:
  • Updated API to version 100015.
  • Removed use of deleted API function GetStatSoftCap().
  • Changed VR related items to CP.
  • Fixed some minor looting display issues.
  • Styles updated.
  • Fix crash when mining items with subtype of 0 and some other values.
  • Character data saves the craft bag inventory.
  • Added several commands to /uespskillcoef (/usc):
              /usc showdata [name/id]     Shows raw data for the particular skill
              /usc showbadfit [R2]        Shows all coefficients with an R2 value less than the given value.
                                          A default value of 0.99 is used if omitted.
              /usc addskill [id]          Adds a specific skill to track when saving statistic data in future
                                          calls to "/usc save". The character does not have to be able to 
                                          learn or know the skill.
              /usc addcharskills          Adds all skills available to the current character to be tracked
                                          in future calls to "/usc save".
              /usc addmissing             Adds all currently defined missing skills from PTS to be tracked in 
                                          future calls to "/usc save".
              /usc resetsaved             Clears all saved data points from "/usc save".
              /uespreset skillcoef        Same as /usc reset.
              /uespcount                  Shows the space taken by skill coefficients.
As a result of these changes the method to compute skill coefficients on PTS has changed somewhat:
1. Reset all champion points and attributes
2. Run: /usc addmissing
3. Run: /usc addcharskills
4. Purchase one rank of all passives and repeat step 3 up to (MaxRank-1) of all passives
4a. If dumping skills run "/uespdump skills passive" in the previous step as well
5. Repeat steps 3-4 for all character classes
6. Add any missing skills (Emperor, etc...) using: /usc add [id]
7. On any v16 character run multiple "/usc save" as usual
8. Calc and save coefficients using: /usc calc
9. To reset saved parameters but keep the list of tracked skills use "/usc resetsaved"
This should give you skill coefficients for all skills in one calculation.
  • v0.80 -- 1 August 2016
  • /uespstyle now works with the 3 new styles added in DB.
  • /usc addcharskills now also adds CP passive abilities to coefficient tracking.
  • Improving items will show the correct improved item link in the chat window now.
  • Poison data is now collected when mining potion item data.
  • Fixed saving of werewolf stat in character/build data.
  • Added the "/uespcontloot [on|off]" command to autoloot items from containers in your inventory.
  • Spell and Physical Penetration stats are added to the character and inventory window. Use "/uespcustomstat on" and reload the UI to take effect. The current list of custom stats are:
              Spell and Physical Penetration
              Spell and Weapon Critical Damage 
                   These values are calculated from scratch as the game gives no way to get their values.
              Effective Spell and Weapon Power
                   These are custom stats meant to gauge your overall damage potential in terms of
                   Magicka/Stamina, Spell/Weapon Damage, Critical/Critical Damage, and Penetration.
                   It currently uses a target resistance of 18.2k with no critical resistance.
  • Improved the display of the startup message.
  • Changed how some of the more useful chat messages are output and added the "/uespmsg" command to control their display.
              /uespmsg                   Shows the current stats
              /uespmsg [on|off]          Turns all messages on/off
              /uespmsg loot [on|off]     Turns loot related messages on/off
              /uespmsg npc [on|off]      Turns NPC related messages on/off
              /uespmsg quest [on|off]    Turns quest related messages on/off
              /uespmsg other [on|off]    Turns all other messages on/off
  • Now "/uespdebug" only controls the display of less useful debug related messages. Initially all new messages are off unless you have "/uespdebug on" set in which case they are initially turned on.
  • A little better support for other languages. If you are using a non-English version and are having problems or wish to help test things let me know.
  • Shadows of the Hist related Updates:
  • API updated to 100016.
  • Added the 5 new styles (Dark Brotherhood, Akatosh, Dro-m'Artha, Minotaur, Grim Arlequin, Hollowjack).
  • v0.90 - 5 October 2016
  • Hireling logged data now includes the crafting and hireling passive levels.
  • Added the "/uespmsg inspiration [on|off]" command.
  • Crafting writ footlockers now log the character's crafting level.
  • Fixed logged dye data from achievements not matching the achievement. Also all data within an achievement line is now logged.
  • Dye stamp data for item links is now logged.
  • Fixed the Grim Harlequin style ID.
  • Increased API to 100017.
  • Increased item mining max ID to 130000.
  • Fixed a bug related to the new stat comparison feature on the inventory menu. If you still run into issues you can disable custom stats with the "/uespcustomstats off" command.
  • Shortened the labels for custom stats to make room for the stat comparison feature. Note that comparison of custom stats is not yet available.
  • Added the "/uespcustomstats custom" option. This displays the change in stat value for the new statistic comparison feature in the inventory stats window.
  • Added the 3 new styles (Celestial, Yokudan, Draugr).
  • v1.00 -- 6 February 2017
  • Mined item data for recipes now includes the information needed to duplicate the in-game tool-tip displayed for recipes.
  • Fixed the stacking of Major Force in the Critical Damage stat display.
  • Fixed the display of a known recipes that shows as unknown in your inventory (Ghastly Eye-Bowl Recipe).
  • Fixed the custom Effective Weapon/Spell Power stats for characters not at max level.
  • Fixed item style display toggle.
  • Fix effective spell/weapon power calculation.
  • A warning is displayed in the chat window if you use an unknown slash command.
  • Added some missing/extra style names for the "/uespstyle" command.
  • Added 12 missing styles to the saved character data.
  • Fixed bug where uespLog thought you ate/drank something you actually didn't.
  • Fixed the item link tooltip "Show Item Info" to work with other addons that modify the same context menu (like MasterMerchant).
  • Added the "/uespstyle summary" and "/uespstyle all" commands to show a summary of all styles known.
  • Added the 2 new styles from the New Life Festival (Skinchanger and Stalhrim Frostcaster).
  • Added the 3 crown store merchants to the NPC ignore list.
  • Added the "Copy Item Link" context menu to item tooltips. This popups up a simple dialog that lets you press CTRL+C to quickly copy the item link. Press ESC or click anywhere to close the dialog.
  • Added the /uespkilldata command to tracking basic kill statistics of NPCs (number and total health). Data is tracked per character and is saved between sessions.
                   /uespkilldata on/off            Turns the feature on and off (default is off).
                   /uespkilldata reset             Clears the current data.
                   /uespkilldata show              Lists all the current kill data.
                   /ukd                            Short command 
  • Added the /uesptrackloot command to track loot received. Data is tracked per character and is saved between sessions. Gold, experience, Tel Var, and Alliance Points are also tracked. The item value shown is the MasterMerchant average value if that add-on is installed and has data for that item. Otherwise the item's gold value is used.
                   /uesptrackloot on/off              Turns loot tracking on/off.
                   /uesptrackloot show                Displays all items looted.
                   /uesptrackloot show [name]         Show all looted items matching the given name.
                   /uesptrackloot sources             Show all sources of loot.
                   /uesptrackloot sources [name]      Show all sources of loot matching the given name.
                   /uesptrackloot reset               Clear all loot tracking data.
                   /utl                               Short command
  • Removed old code for manually monitoring the Mercenary and Ancient Orc styles.
  • Added logging when pickpocketing for the NPC thieving class and other data.
  • Update 13 Changes:
  • API updated to 100018.
  • Added the new special item type to logged item data.
  • Added ingredient quantities to logged recipe data.
  • Added furniture category data to logged item data.
  • Updated item logging with change to multiple tradeskill requirements.
  • Fixed UI error with autolooting containers enabled. Note a small change in the behaviour of autolooting containers when your inventory is full. It will autoloot as many items as your inventory can hold but will no longer display the open container showing remaining items.
  • Fixed known/unknown display of recipes.
  • Added the 4 new styles: Silken Ring, Mazzatun, Ra Gada, and Ebony
  • BETA: Guild Sales Data Tracking Price Display -- A new feature in testing since v1.00 which logs guild sales data from several sources including:
  • Logs sales from your guild history
  • Logs items you list
  • Logs item searches from all guild traders
  • Manually scan of listings in the current guild store with "/uespsales scan"
  • All uploaded sales data can be viewed at http://esosales.uesp.net/ . Average price data is computed using both the listed items and sold items for potentially greater accuracy in the price calculation.
  • Note that the addon includes prices for the PC::*NA server at the time of the add::*ons release. For updated prices and other servers you can download an updated price file (uespSalesPrices.lua) at:http://esosales.uesp.net/salesPrices.shtml
  • Sales data logging and price display can be controlled with the "/uespsales" command:
      /uespsales [on|off]            Turn logging of sales data on/off.
      /uespsales prices [on|off]     Enables/disables all UESP price diplays.
      /uespsales tooltip [on|off]    Turns price item tooltip display on/off.
      /uespsales saletype both       Uses both listed and sold data when displaying prices.
      /uespsales saletype list       Uses only listed data when displaying prices.
      /uespsales saletype sold       Uses only sold data when displaying prices.
      /uespsales scan                Scans all guild store listings.
      /uespsales scan [page]         Scans the current guild store listing at the given page.
      /uespsales stop                Stops the current listing scan.
      /uespsales resetall            Reset the sales and listing scan timestamps.
      /uespsales resetsold           Reset the sales history scan timestamps for  all your guilds.
      /uespsales resetlist all       Reset the listing timestamps for all guilds.
      /uespsales resetlist current   Reset the listing timestamps for the current guild trader.
      /uespsales resetlist [name]    Reset the listing timestamps for that guild.
  • When doing a manual scan of guild listings you need to be at a guild trader kiosk or bank screen. When at a guild store bank it will scan all guilds you are currently in. A full scan can take up to 10 minutes depending on how many items are in the guild store. You have to remain on the trader during this time and you cannot perform any searches yourself as this will interfere with automatic scan. You can stop a listing scan with "/uespsales stop" or by exiting the guild trader interface at anytime.
  • Once a guild scan has been completed then subsequent scans will only need to scan any new items listed since the last scan. This applies to both guild listings and guild sale histories. You can reset these with the "/uespsales resetlist" and "/uespsales resetsold" commands but the next scans will then require a longer complete scan. Daily updated versions of this file can be downloaded from http://esosales.uesp.net/ . If you don't use the UESP price data at all you can delete everything in this file with any text editor to save a little bit of memory.
  • Collected price data is included in the "uespSalesPrices.lua" file. Average price data can be viewed in item tooltips if you turn them on with "/uespsales prices on" and "/uespsales tooltip on", much in the same manner as with the MasterMerchant add-on.
  • You can control which type of sales data is used for the average price with the commands:
      /uespsales saletype both       Uses both listed and sold price data.
      /uespsales saletype list       Uses only listed price data.
      /uespsales saletype sold       Uses only sold price data.
  • Using only sold data would be the same as how the MasterMerchant add::*on works. Using only the listed data would be the same as how the TamrielTraderCentre add::*on works. Using both gets you the best of both worlds.

Skill Coefficients[edit]

Added in v0.60 is the ability to compute skill coefficients using the /uespskillcoef or /usc chat command. The equation for the base skill tooltip is

             BaseTooltip = A * Stat + B * Power + C

where Stat is Magicka/Stamina and Power is Spell/Weapon Damage. The A/B/C parameters are not exposed by the game's API so must be calculated indirectly. The usual way to calculate these parameters is to record several different Tooltip/Stat/Power value combinations and do a "best fit" calculation. The /uespskillcoef command encapsulates all the math so all you have to do is provide several different Stat/Power combinations and the command will compute the A/B/C parameters along with an "R" parameter (R-squared) indicating how accurate the fit is. An R value of "1" indicates a perfect fit with lower values indicates a worse fit.

Calculated skill coefficients will be automatically stored in the add-on's saved variable file. Coefficient data will be saved in the normal log data section which will be parsed if/when uploaded to the UESP. Data will also be saved to the "tempData" section in a CSV format for copy-pasting to a text or spreadsheet document.

The /uespsavecoef (or /usc) command has the following format:

              /usc save               Save current skill data for the character. All 3 versions of each skill will 
                                      be saved (the original and two morphs) regardless of what rank it is and whether
                                      it is purchased or not. Note that logging out or "/reloadui" will clear the saved 
                                      skill data.
              /usc calc               Calculate coefficients using previously saved skill data and store
                                      coefficient data in the log. The "tempData" section of the saved
                                      variables will also contain a CSV version of the coefficient data.
              /usc coef [name]        Shows the calculated coefficients for the given skill name.
              /usc coef [id]          Shows the calculated coefficients for the given skill ID.
              /usc status             Current status of saved skill data.
              /usc clear              Resets the saved skill data. Note that logging out or "/reloadui" will
                                      also clear the saved skill data.
              /usc savewyk [prefix] [start] [end]  
                                      Saves skill data using Wykkyd's Outfitter add-on. 
                                              ex: /usc savewyk Test 1 9
                                      would try to load the sets 'Test1'...'Test9' and save the skill data
                                      for each of them.
              /usc stop               Stops a Wykkyd item set save in progress.

The quality of the skill coefficients depend on the number and variety of stat/power combinations saved with "/usc save". A minimum of 3 saved sets are needed but in general you want many more. Ideally you want to vary all stats (Stamina, Magicka, Spell Damage, Weapon Damage, etc...) as much as possible to get more accurate results. To capture more data also vary things like armor types and weapon types as well.

The general procedure to accurately record/calculate skill coefficients is:

  1. Reset all champion points.
  2. Reset all skills.
  3. Purchase the base rank of all passives (if you don't purchase any ranks you will only get data for rank 1 passives).
  4. Remove all skills from both ability bars.
  5. Equip/unequip items to change stats.
  6. Wait at least 5 seconds after changing equipment to let the game correctly update the skill values (you'll receive an error message if you save when the skill data is not yet ready).
  7. Run "/usc save".
  8. Repeat steps 5-7 for 10 or more different stat combinations (magicka, stamina, spell/weapon damage).
  9. Run "/usc calc".
  10. Run "/reloadui" or logout to update the saved variables.
  11. Upload the saved variable file or copy/paste the coefficient data from the "tempData" section.
  12. Uploaded and parsed skill coefficient data can be found at http://esolog.uesp.net/viewSkillCoef.php or in the mined skills database at http://esoitem.uesp.net/viewlog.php?record=minedSkills

Some more notes on collecting and computing skill coefficients:

  • The saved skill data is reset when you logout or /reloadui.
  • You must run the "/usc calc" command to compute coefficients after saving skill data several times. It doesn't happen automatically.
  • The data copied to "tempData" in the saved variable file is overwritten each time "/usc calc" is run.
  • Some skills (like Reverse Slash) seem to take several seconds to change after equipping items. You'll receive an error message if you try and save skill data before the skills have stopped changing.
  • The rank 1 passives of Heavy Armor Juggernaut and Rapid Mending have an issue with the displayed precision which results in a slightly inaccurate fit. The passives use a 0.5%/Heavy Armor equipped but the displayed value has the decimal points truncated (0.5 is display as 0, 1.5 is displayed as 1, etc...).
  • Skill coefficients are obtained for all active skills your character has access to whether purchased or not. Locked skills are not calculated (maybe, need confirmation).
  • Skill coefficients for passives are obtained for the current rank and rank+1. Thus, if you have no passive ranks purchased you will only obtain data for rank 1 of the passive.

Notes[edit]

  • To save space in the log the following /uespdump commands clear the relevant logs in the saved variable output when run:
  • Globals
  • Achievements
  • All other logs are appended to and never deleted unless done so manually using the /uespreset command.
  • Source code is available from the Bitbucket uesp.esoapps repository.

Bugs[edit]

  • Too Much Data Collected -- At the moment the add-on is a bit dumb and just collects as much data as possible. Eventually this will cause the saved variable file to become too big. You can reset the saved variable file by copying it to a safe place and then deleting it from the game folder after you have logged out of the game. Versions of the addon v0.22 and later now warn you if the saved variable file becomes too large.
  • Load Error in Game or uespLogMonitor -- Using v0.17 or earlier of the addon with the game version 1.2.3(?) or later sometimes results in a "nil" string being output to the saved variables file. Upgrading to v0.19 or later of the addon will prevent this from reoccurring. You can manually fix any corrupted saved variable file by opening it in a text editor and manually changing any lines with the content nil -- invalid string, to simply "nil", (including double quotes).
The cause of the this bug is a change in the API which prevents strings 2000 bytes and longer from being saved. v0.19 fixes this by splitting long strings, such as complete book texts, into multiple log lines.
  • Saved Variable Corruption -- Sometimes the saved variable data gets corrupted. This seems to occur during a global dump on rare occasions and is most likely an ESO/LUA engine bug. Use "/uespreset all" to clear the saved variable data back to an empty state which can usually fix this. If that doesn't work exit the game and manually edit the SavedVariables\uespLog.lua file and remove the invalid entries.
  • Lua Memory Limit -- If you receive an error message warning of Lua reaching its memory limit it just means that all your add-ons, including uespLog, are using more memory than the game permits. There are a few ways to prevent this from occurring:
  1. Edit your Documents\Elder Scrolls Online\Live\UserSettings.txt file and change the line LuaMemoryLimitMB "64", changing the 64 to 128 or larger.
  2. Turn data logging off if you are not uploading data to the UESP via /uesplog off.
  3. Automatically clear data by running uespLogMonitor on Windows.
  4. Check uespLog data size by /uespcount.
  5. Clear all logged data manually with /uespreset all.

ViewLog[edit]

The parsed data obtained from the uespLog addon can be found at a few places:

Version History[edit]

  • 2 June 2015
  • Fixed crash/performance issue with large table sizes.
  • Mined item summary data will now be updated automatically once per day.
  • The QuestOffered log data is now parsed. It will be stored as a quest stage if a quest is accepted shortly after the offer. It can be identified by an orderIndex and type value of -123.
  • Item link images are now cached properly and include the enchantId and summary. All previously cached images have been deleted.
  • Added a View Summary Data to the item link page.
  • 3 June 2015
  • The mined item display includes links on the item's name and itemLink to the full item link page.
  • Mined item summary data is available from the view log display.
  • Search now includes the mined item summary data.
  • Added the set summary creation and viewing. Set summaries are included in search results.