12 366
edições
Alterações
→Game Time Notes: update link
{{Trail}}
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 '''[http://www.esoui.com/downloads/info1257-uespLog.html ESOUI]''' and '''[http://www.nexusmods.com/elderscrollsonline/mods/67/? Nexus Mods]'''.
== Installation ==
:* Download '''[[File:Eso-Addon-uespLog.zip| Eso-Addon-uespLog.zip (4 kb)]]''' or from '''[http://www.esoui.com/downloads/info1257-uespLog.html ESOUI]''' and '''[http://www.nexusmods.com/elderscrollsonline/mods/67/? 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 [[Online:UespLog_AddOn#uespLogMonitor|uespLogMonitor]] (Windows program) to automatically monitor and upload logged data or [http://esolog.uesp.net/submit.php 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 ==
:* '''/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
== Usage Tips ==
:* 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-ons 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 [http://wiki.esoui.com/API 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 ==
There are two ways to submit data logged from the addon to the UESP:
:# Use the included uespLogMonitor Windows application to automatically upload data.
:# Upload data using the '''[http://esolog.uesp.net/submit.php manual submission form]'''.
== Viewing Log Data ==
All the collected data can be viewed in our online '''[http://esolog.uesp.net/viewlog.php 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 ==
:* 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 ==
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 [[#Data_Logged|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?'''
::* We are currently working on a [http://content3.uesp.net/esolog/viewlog.php simple web interface] to all the logged data.
:'''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 ==
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 [http://esoclock.uesp.net 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 ==
:* '''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 [[User:Daveh/ESO_Notes#Item_Link_Format|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:
:::::# Reset all champion points.
:::::# Reset all skills.
:::::# Purchase the base rank of all passives.
:::::# Remove all skills from both ability bars.
:::::# Equip/unequip items to change stats.
:::::# Wait at least 5 seconds after changing equipment to let the game correctly update the skill values.
:::::# Run "/usc save".
:::::# Repeat steps 5-7 for 10 or more different stat combinations (magicka, stamina, spell/weapon damage).
:::::# Run "/usc calc".
:::::# Run "/reloadui" or logout to update the saved variables.
:::::# 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:
:::::# On Windows use the included uespLogMonitor program to automatically upload data.
:::::# Use the http://esolog.uesp.net/submit.php form to manually upload all log, build, and character data.
:::::# 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.
== Skill Coefficients ==
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:
:# Reset all champion points.
:# Reset all skills.
:# Purchase the base rank of all passives (if you don't purchase any ranks you will only get data for rank 1 passives).
:# Remove all skills from both ability bars.
:# Equip/unequip items to change stats.
:# 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).
:# Run "/usc save".
:# Repeat steps 5-7 for 10 or more different stat combinations (magicka, stamina, spell/weapon damage).
:# Run "/usc calc".
:# Run "/reloadui" or logout to update the saved variables.
:# 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
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 ==
:* 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 [https://bitbucket.org/uesp/esoapps/src/75f4418b158816d4f30bd1ef52179899b14bdebb/uespLog/?at=default Bitbucket uesp.esoapps repository].
== Bugs ==
:* '''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.
:* '''Missing Files MSVCP140.dll, mfc140.dll and VCRUNTIME140.dll''' -- You can get this message when running uespLogMonitor v0.50 and later. These are Windows library files that are included in the [https://www.microsoft.com/en-ca/download/details.aspx?id=48145 MSVC 2015 Redistributable (32 bit vc_redist.x86.exe)].
:* '''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:
:::# Edit your ''Documents\Elder Scrolls Online\Live\UserSettings.txt'' file and change the line ''LuaMemoryLimitMB "64"'', changing the 64 to 128 or larger.
:::# Turn data logging off if you are not uploading data to the UESP via ''/uesplog off''.
:::# Automatically clear data by running uespLogMonitor on Windows.
:::# Check uespLog data size by ''/uespcount''.
:::# Clear all logged data manually with ''/uespreset all''.
== ViewLog ==
The parsed data obtained from the uespLog addon can be found at a few places:
:* '''[http://esoitem.uesp.net/viewlog.php esoitem.uesp.net/viewlog.php]''' -- Most of the parsed data can be found here.
:* '''[http://esoitem.uesp.net/viewMinedItems.php esoitem.uesp.net/viewMinedItems.php]''' -- Specifically view all the mined item data according to item type.
:* '''[http://esoitem.uesp.net/dumpMinedItems.php?itemid=70 esoitem.uesp.net/dumpMinedItems.php?itemid=70]''' -- Download the CSV data for a specific item id.
:* '''[http://esoitem.uesp.net/itemLink.php?itemid=70 esoitem.uesp.net/itemLink.php?itemid=70]''' -- Shows the complete item data including an in-game formatted link box.
=== Version History ===
* '''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.
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 '''[http://www.esoui.com/downloads/info1257-uespLog.html ESOUI]''' and '''[http://www.nexusmods.com/elderscrollsonline/mods/67/? Nexus Mods]'''.
== Installation ==
:* Download '''[[File:Eso-Addon-uespLog.zip| Eso-Addon-uespLog.zip (4 kb)]]''' or from '''[http://www.esoui.com/downloads/info1257-uespLog.html ESOUI]''' and '''[http://www.nexusmods.com/elderscrollsonline/mods/67/? 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 [[Online:UespLog_AddOn#uespLogMonitor|uespLogMonitor]] (Windows program) to automatically monitor and upload logged data or [http://esolog.uesp.net/submit.php 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 ==
:* '''/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
== Usage Tips ==
:* 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-ons 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 [http://wiki.esoui.com/API 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 ==
There are two ways to submit data logged from the addon to the UESP:
:# Use the included uespLogMonitor Windows application to automatically upload data.
:# Upload data using the '''[http://esolog.uesp.net/submit.php manual submission form]'''.
== Viewing Log Data ==
All the collected data can be viewed in our online '''[http://esolog.uesp.net/viewlog.php 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 ==
:* 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 ==
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 [[#Data_Logged|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?'''
::* We are currently working on a [http://content3.uesp.net/esolog/viewlog.php simple web interface] to all the logged data.
:'''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 ==
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 [http://esoclock.uesp.net 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 ==
:* '''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 [[User:Daveh/ESO_Notes#Item_Link_Format|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:
:::::# Reset all champion points.
:::::# Reset all skills.
:::::# Purchase the base rank of all passives.
:::::# Remove all skills from both ability bars.
:::::# Equip/unequip items to change stats.
:::::# Wait at least 5 seconds after changing equipment to let the game correctly update the skill values.
:::::# Run "/usc save".
:::::# Repeat steps 5-7 for 10 or more different stat combinations (magicka, stamina, spell/weapon damage).
:::::# Run "/usc calc".
:::::# Run "/reloadui" or logout to update the saved variables.
:::::# 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:
:::::# On Windows use the included uespLogMonitor program to automatically upload data.
:::::# Use the http://esolog.uesp.net/submit.php form to manually upload all log, build, and character data.
:::::# 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.
== Skill Coefficients ==
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:
:# Reset all champion points.
:# Reset all skills.
:# Purchase the base rank of all passives (if you don't purchase any ranks you will only get data for rank 1 passives).
:# Remove all skills from both ability bars.
:# Equip/unequip items to change stats.
:# 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).
:# Run "/usc save".
:# Repeat steps 5-7 for 10 or more different stat combinations (magicka, stamina, spell/weapon damage).
:# Run "/usc calc".
:# Run "/reloadui" or logout to update the saved variables.
:# 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
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 ==
:* 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 [https://bitbucket.org/uesp/esoapps/src/75f4418b158816d4f30bd1ef52179899b14bdebb/uespLog/?at=default Bitbucket uesp.esoapps repository].
== Bugs ==
:* '''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.
:* '''Missing Files MSVCP140.dll, mfc140.dll and VCRUNTIME140.dll''' -- You can get this message when running uespLogMonitor v0.50 and later. These are Windows library files that are included in the [https://www.microsoft.com/en-ca/download/details.aspx?id=48145 MSVC 2015 Redistributable (32 bit vc_redist.x86.exe)].
:* '''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:
:::# Edit your ''Documents\Elder Scrolls Online\Live\UserSettings.txt'' file and change the line ''LuaMemoryLimitMB "64"'', changing the 64 to 128 or larger.
:::# Turn data logging off if you are not uploading data to the UESP via ''/uesplog off''.
:::# Automatically clear data by running uespLogMonitor on Windows.
:::# Check uespLog data size by ''/uespcount''.
:::# Clear all logged data manually with ''/uespreset all''.
== ViewLog ==
The parsed data obtained from the uespLog addon can be found at a few places:
:* '''[http://esoitem.uesp.net/viewlog.php esoitem.uesp.net/viewlog.php]''' -- Most of the parsed data can be found here.
:* '''[http://esoitem.uesp.net/viewMinedItems.php esoitem.uesp.net/viewMinedItems.php]''' -- Specifically view all the mined item data according to item type.
:* '''[http://esoitem.uesp.net/dumpMinedItems.php?itemid=70 esoitem.uesp.net/dumpMinedItems.php?itemid=70]''' -- Download the CSV data for a specific item id.
:* '''[http://esoitem.uesp.net/itemLink.php?itemid=70 esoitem.uesp.net/itemLink.php?itemid=70]''' -- Shows the complete item data including an in-game formatted link box.
=== Version History ===
* '''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.