Download
(30 Kb)
Download
Updated: 10/31/23 10:40 PM
Pictures
File Info
Compatibility:
Endless Archive (9.2.5)
base-game patch (9.1.5)
Necrom (9.0.0)
Updated:10/31/23 10:40 PM
Created:04/10/14 02:17 AM
Monthly downloads:1,253
Total downloads:201,057
Favorites:344
MD5:
Categories:Miscellaneous, Character Advancement, RolePlay, Utility Mods
Librarian Book Manager  Popular! (More than 5000 hits)
Version: 3.11
by: Flamage, Orionik
Librarian records every book your character reads in-game and keeps a list of when it was found and whether you have marked it as read, allowing you to continue questing (and not hold up other players) while being confident you won't forget to read anything later.

Any suggestions, bugs or general discussion about the addon can be posted in the comments tab above, in my author portal (button on the right) or in this forum thread.

Features:
- Ability to mark books as read / unread. Books are marked as unread initially so you can feel free to skip reading while questing and know that your book will be easily found later.
- When reading a book, an is shown for books not marked as read (can be disabled in the settings)
- Displays the books in the default book reader interface.
- Imports books you have already read from the Lore Library / Eidetic Memory.
- Records the time each book was first discovered.
- Optionally view books found on your other characters.
- Sorting by unread / read status, time discovered, book title and word count.
- Full text search of all the books in your collection.
- Displays a count of the total number of books found so far and the number that are unread.
- Key binding to open the Librarian window (and a bonus keybind for /reloadUI).
- Optional reminder to /reloadui (and force a save of Librarian data) when a certain number of new books have been discovered, to help prevent loss of data if the client crashes.
- Add some icons in "Lore Library" to see which books are read and which aren't and add possibility to mark them as read/unread there (can be disabled in the settings)

How to use:
- Bind a key for Librarian in the Controls, Keybinds settings menu, or type /librarian into the chat window to open Librarian.
- Click a book or press the action button ('E' by default) while hovering over a title to read that book.
- Hover over a title and press the secondary action button ('R' by default) to toggle the unread state of the highlighted book. You can also toggle the unread state of a book while reading it.
- Click on the column headers to sort by that field. Click again to sort in descending order.

SavedVariables warning:
Librarian relies on SavedVariables to store information about the books you have found. If this file is lost or corrupted, that information will be lost. Therefore, it is important to backup your saved variables regularly. This is quite simple:
1 - Go to your SavedVariables folder (on windows, this can be found at MyDocuments\Elder Scrolls Online\live\SavedVariables.
2 - Create a folder called Backup.
3 - Select Librarian.lua and right click, select copy.
4 - Open the Backup folder, and paste the file.

With version 3, the save was entirely adapted to fix some issues and allow to reduce its size but it is better to copy it elsewhere before updating the addon in order to easily rollback in case of a problem.

Although, if you encounter an issue and didn't copied your save before the update, you can rollback your save by editing your save file (MyDocuments\Elder Scrolls Online\live\SavedVariables\Librarian.lua) and replacing the sections "characterBooks" and "books" of the "Librarian_SavedVariables" table with the content of "LibrarianDeprecation_SavedVariables_Backup" which is in LibrarianDeprecation.lua (next to Librarian.lua). Then you can, install back the previous version of the addon.

Dependency:
- LibAddonMenu-2.0

Starting from v3.5, Librarian is able to display books added by "The Librarium" add-on. If you want more books and see what the ESO community can produce, you should check it out. Big thanks to Alianym for making this collaboration possible.
3.11 2023-11-01
- Updated API for Secret of the Telvanni (101040)

3.10 2023-08-23
- Updated API for 2023 update of quality of life (101039)

3.9 2023-06-05
- Updated API for Necrom (101038)
- Fix book reader scene is now "loreReaderDefault" instead of "loreReaderInteraction"
- Add back PlaySound when opening the reader (but it seems the bug is coming from eso as there is no sound when opening a book from the lore library since the update)

3.8 2022-11-02
- Updated API for Scribes of Fate (101037)

3.7 2022-11-13
- Add chinese translation, credit goes to KomeSake who posted it in the comment section of Librarian in esoui.com

3.6 2022-11-02
- Updated API for Firesong (101036)

3.5 2022-10-03
- Add API for external addon to be able to register their own books to Librarian

3.4 2022-09-11
- Add keybind in lore reader only when the book is recognized by Librarian (it avoids conflicting with other addon like TheLibrarium)
- Add possibility to delete books which don't have a category

3.3 2022-08-23
- Updated API for Lost Depths (101035)
- Widden "Found" column for 12Hour format

3.2 2022-08-06
- Create separate lib for deprecation in order to make eso create a second file for the save variables.

3.1 2022-08-02
- Improve deprecation
- Prevent from opening a book that the current character doesn't know

3.0 2022-07-25
- Updated API for High Isle (101034)
- Fix issues
- Add icons in lore library
- Add option to mark book as read directly from lore library
- Remove Import from before patch option which was meant for save created back in 2015
- Remove some deprecation code for save before 2015
- Deprecate global saves to use bookId as identifiers instead of the title (several books had the same name) and remove all data that could be retrieved thanks to ESO API now that we have the bookId (title, body, medium, showTitle, wordCount). It lightens the save (~2MB for all the books on one character) and allow the player to switch language (although a few books can't be retrieved with their bookId because they don't have a category/collection so for them all the data are kept). Keep for now the previous save in a separate table in case there is a mistake in order to be able to roll back)
- Deprecate characterBooks save, it now references the bookId instead of the title and fill at the same time the unreadPerCollection list
- Optimize ImportFromLoreLibrary by removing the Refresh every frame (without it, past 1000 books, the game slow down a lot and at 4000 you end up with less than 1fps)
- Activate back auto importation from init now that it is quick enough
- Add full localization and support for french language
- Add a small timer before refreshing the list when doing a research as we could trigger a crash if we were typing a search too fast when we have too many books
- Improve settings (better integration with LibAddonMenu and add a few options)
- Add category column in Librarian UI
- Use smaller font in order to fit all of the text in the UI
- Add button to select if you want to search through the Full-Text or just the Title of the books

2.0 (2/12/18)
- Updated API for Dragon Bones (100022)
- Fixed issue with ZOS function LoreReader, and new issue with ZO_SceneManager. Currently closes back to
UI and not Librarian list, will update that soon.

1.9 (9/10/17)
- Updated API for Horns Of The Reach (100020)
- Updated LAM to 2.0 r24
- Fixed issue with ZOS function LoreReader

1.8 (6/10/17)
- Updated API for Morrowind (100019)

1.7 (2/5/17)
- Updated LAM to 2.0 r23
- Updated to API 18 (Homestead)

1.6.3 2016-09-10
- Import feature working much better thanks some input from Votan (Thank You!)

1.6.2 2016-09-10
- Updated to LibAddonMenu 2.0 r17
- Updated for Shadows of the Hist, API 100016, also confirmed working for 100017
TODO: Looking at building language localizations and some category filters for book types. Also looking at improving the import function.

1.6.1
- Added License for LibAddonMenu

1.6.0
- Updated TOC for Tamriel Unlimited
- Updated LibAddonMenu

1.5.0
- Updated TOC for patch 1.5
- Updated LibAddonMenu 2.0

1.4.0
- Updated TOC for patch 1.4

1.2.6 2014-9-5
- Added an option to disable the character spin when opening the Librarian window.
- Added a shortcut button to the setting window in the top right of Librarian.
- Compatibility fixes for version 1.4 from the PTS.

1.2.5 2014-8-18
- Exiting the book reader interface now returns to Librarian rather than the base scene. Also fixes this behaviour with books opened from the inventory and the lore library.

1.2.4 2014-8-15
- Modified the SavedVariable import process to fix data for all accounts, not just the currently logged-in account.

1.2.3 2014-8-6
- Added missing references to LibAddonMenu.lua files that was causing an error.

1.2.2 2014-8-6
- Fixed a bug where full-text search would show an error if a book was missing its body.

1.2.1 2014-8-5
- Fixed a error caused by a change to the Scene Manager in 1.3
- Added a function to migrate data from the "empty" account that was created by the GetDisplayName() bug in 1.2.3

1.2.0 2014-6-25
- Updated to LibAddonMenu 2.0.
- Added a SavedVariable backup reminder.

1.1.2 2014-6-24
- Fixed a bug with the "Waterlogged Journal" from Craglorn that was caused a user to lose all their data. A more robust fix will be deployed later.

1.1.1 2014-6-14
- Temporarily disabled integration with the LoreLibrary which was causing connection time-outs for some users. This feature will be re-enabled when a fix for it is found.

1.1.0 2014-5-23
- Update API version to 100004. Addon appears to be stable, so I have moved to version 1.1.0.

1.0.18 2014-5-8
- Fixed a bug with upgrading old databases that would result in an error.

1.0.17 2014-5-7
- Fixed a bug in the settings panel when a newer version of LibAddonMenu was loaded.
- Updated the bundled version of LibAddonMenu to 1.0r7

1.0.16 2014-5-5
- Added a new optional reloadui reminder feature. By default, after finding 5 new books the game reminds you in a chat message to reloadui so that you do not lose much progress in the case of a crash.
- Fixed a bug with non-english clients that was preventing keybindings from working.
- Added the current version number to the UI.

1.0.15 2014-4-30
- Fixed an error that occurred when viewing a book that was not already in the collection.

1.0.14 2014-4-30
- Added a new unread indicator to the book reader. The indicator can be disabled in the settings.

1.0.13 2014-4-30
- Added the ability to toggle a book's unread status while reading it.

1.0.12 2014-4-29
- Added full-text search feature.

1.0.11 2014-4-28
- Added the LoreLibrary import feature.
- Fixed a error when changing the time display setting.

1.0.10 2014-4-28
- Fixed an error that was occurring when upgrading users of an older version of Librarian. Sorry I missed that!

1.0.9 2014-4-25
- From user feedback, performance looks to have been fixed! Moving back onto features.
- Added an unread book counter

1.0.8 2014-4-24
- Completely revamped the code to use ZO_SortFilterList as the basis of the Librarian book list. Hopefully performance is significantly improved, both for scrolling, and loading / exiting the game.

1.0.7 2014-4-21
- Added a setting to specify whether or not to display alerts in chat and/or as a banner-type alert.

1.0.6 2014-4-17
- Fixed a bug with the keybinding unread / read display when a book is highlighted.
- Replaced the chat alert when finding a new book with an alert similar to when finding a new lore book.

1.0.5 2014-4-17
- Fixed a bug with toggling the read / unread status of books.

1.0.4 2014-4-17
- Account-wide book access. There is a checkbox available at the bottom of the Librarian interface to toggle the showing of books seen across any of your characters. Initially, you will need to log in each character once to move their data to the account-wide Library.
- Big changes on the data storage side. Actual book data is stored in an account-wide variable, and only the time found is stored per-character.

1.0.3 2014-4-15
- Added a settings screen which can be accessed from the standard settings menu.
- Added a time format setting so the user can choose between 12 and 24 hour time. This setting should default to 12 hour for english and 24 hour for other languages, which is the same logic the game itself uses.
- Fixed the bug where times were always being displayed as "P.M."

1.0.2 2014-4-14
- Added a book count header.
- Fixed a bug with highlighting of sort headers.
- Known issue: book found times are still inconsistent.

1.0.1 2014-4-13
- Added a wordcount field.
Archived Files (51)
File Name
Version
Size
Uploader
Date
3.10
30kB
Orionik
10/10/23 06:08 PM
3.10
31kB
Orionik
08/23/23 07:00 AM
3.9
30kB
Orionik
06/05/23 11:04 PM
3.8
30kB
Orionik
03/13/23 10:17 PM
3.7
30kB
Orionik
11/13/22 12:29 PM
3.6
28kB
Orionik
11/01/22 07:31 PM
3.5
28kB
Orionik
10/10/22 07:40 PM
3.4
24kB
Flamage
09/11/22 05:04 PM
3.3
23kB
Orionik
08/23/22 09:45 PM
3.2
23kB
Orionik
08/06/22 09:56 AM
3.1
22kB
Orionik
08/02/22 11:03 AM
3.0
21kB
Orionik
07/25/22 12:00 PM
2.0
56kB
calia1120
02/13/18 12:56 AM
1.9
55kB
calia1120
09/10/17 08:59 PM
1.8
53kB
calia1120
06/11/17 01:02 AM
1.7.0
53kB
calia1120
02/05/17 03:00 AM
1.6.3
41kB
calia1120
09/10/16 05:51 AM
1.6.2
41kB
calia1120
09/10/16 02:09 AM
1.6.1
38kB
Flamage
03/29/15 03:59 PM
1.6.0
34kB
Flamage
03/22/15 09:38 PM
1.5.0
34kB
Flamage
11/05/14 03:47 PM
1.4.0
34kB
Flamage
09/15/14 08:58 PM
1.2.6
34kB
Flamage
09/04/14 10:57 AM
1.2.5
33kB
Flamage
08/17/14 04:44 PM
1.2.4
33kB
Flamage
08/14/14 04:56 PM
1.2.3
33kB
Flamage
08/05/14 05:52 PM
1.2.2
32kB
Flamage
08/05/14 04:22 PM
1.2.1
32kB
Flamage
08/04/14 05:01 PM
1.2.0
31kB
Flamage
06/26/14 05:22 AM
1.1.3
14kB
Flamage
06/25/14 04:29 AM
1.1.2
14kB
Flamage
06/24/14 04:49 AM
1.1.0
14kB
Flamage
06/13/14 05:32 PM
1.1.0
14kB
Flamage
05/23/14 05:02 AM
1.0.18
14kB
Flamage
05/08/14 01:55 AM
1.0.17
14kB
Flamage
05/06/14 03:20 PM
1.0.16
13kB
Flamage
05/05/14 05:22 AM
1.0.15
12kB
Flamage
04/30/14 02:23 AM
1.0.12
12kB
Flamage
04/29/14 06:05 PM
1.0.14
12kB
Flamage
04/29/14 04:42 PM
1.0.13
12kB
Flamage
04/29/14 03:49 PM
1.0.12
12kB
Flamage
04/28/14 04:01 PM
1.0.10
11kB
Flamage
04/27/14 03:11 PM
1.0.9
11kB
Flamage
04/24/14 04:19 PM
1.0.7
12kB
Flamage
04/20/14 09:54 PM
1.0.6
11kB
Flamage
04/17/14 07:03 AM
1.0.5
12kB
Flamage
04/16/14 10:57 PM
1.0.4
11kB
Flamage
04/16/14 03:10 PM
1.0.3
10kB
Flamage
04/14/14 04:16 PM
1.0.2
5kB
Flamage
04/13/14 04:00 PM
1.0.1
5kB
Flamage
04/12/14 07:48 PM
1.0
4kB
Flamage
04/10/14 02:23 AM


Post A Reply Comment Options
Unread 03/10/18, 06:05 AM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
Update

Got one character in a function name wrong, derp.

God willing I'm actually done with this, perhaps! I cleaned up the UpdateSV function to make it ready to go gold, and only introduced one new bug. Which is now fixed. Soooo... good to go!
Report comment to moderator  
Reply With Quote
Unread 03/09/18, 06:55 PM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
Update

What's new?

Technically, not much. No fixes or anything. I just added in some code to wipe the database for those freshly moving from the main Librarian file. Don't worry, there's a confirmation dialogue. Essentially, I want to make this as 'main file ready' as I can. Hopefully save calia some work.

Anything else?

Yes. Due to the main Librarian addon's database being broken (see my post about book IDs below, just search for 'book IDs' in this page), my build will ask to wipe your database before continuing. You will need to do this. If you've already used one of my builds in the past, you won't need to wipe your database again. You won't be asked to.

This one is pretty much as ready as it's gonna be, I think. I've been testing and testing, haven't found any further issues.
Report comment to moderator  
Reply With Quote
Unread 03/09/18, 07:08 AM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
Update

No, I'm not going to be sarcastic this time. Back to just saying 'Update.' I can only snark so much. :P

And, honestly, considering how thankless this has been? I feel okay with employing a little snark every now and then. Still, I care about the silly botherers using broken stuff, so I'll keep at this.

What's new?
  • Nothing in the main addon, actually! I futzed the order of the character names when editing the merge tool. Whoops. I got them reversed. The merge tool worked, mind you. It was just that the report file got the names backwards. Cosmetic bug.
Anything else?

So... another fix. Have at it. I'm going to keep at this until it's perfect. The hard work is done, after all. The databases are sorted, the code is overhauled, and the major issues are fixed. It's just the little bugs now which will give me OCD if I don't sort them out.

If this is your first time using one of my builds, check down a number of posts. Look for the multi-part one where I talk about book IDs and read that. It's important. You shouldn't update to this from the main Librarian if you haven't. Okay? Good.
Report comment to moderator  
Reply With Quote
Unread 03/08/18, 10:39 PM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
Quick Bugfix

What's new?

I noticed I flubbed the logic of the unread indicator's visibility. Oops. Caught that at the very last moment when doing further testing. That should be it for the bugs, though. Hopefully there are no more.

Anything else?

If this is your first time using one of my Librarian builds, please go down a number of posts until you find my large, multi-part post accompanying an update. It's where I talk about book IDs. It's really necessary to read, so please read it. Thanks.
Report comment to moderator  
Reply With Quote
Unread 03/08/18, 09:39 PM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
Barring any bugs, this will be my last...

Update!
  • Fixed a likely database bug that might've occurred, wouldn't have ruined anything, just would've thrown errors.
  • I've finished overhauling the heck out of Librarian, I've cleaned up the code, cut away a lot of the chaff (OCD optimisation), and fixed a couple more potential issues.
  • Some truly pointless database layers have been cut away, log in to get your DB updated.
  • The new utilities now match the new database structure and no longer require account names in order to work, I can imagine how the old utils requiring account names might've freaked people out. That was a driving force behind sorting out the databases.
Anything else?

Go down a few posts and find the last update that was accompanied by a large multi-part post where I talk about book IDs. Read that. Please. Please do read that before using this.

And as I said above? Barring bugs, I'm actually done with this, now! I just feel so unburdened since this was getting to me via my OCD. It's nice to have it all cleaned up, presentable, and ready. So, 1.0-ish, y'know? That doesn't mean I won't stop working on it entirely, just that I'm not going to do any more heavy work on it beyond bugs.

@calia1120

If you've been waiting for me to stop to diff in the changes? This is that point. This is about as done as I can be with Librarian barring, as I said, any bugs. Things seem okay, though.

Edited for clarity.
Last edited by WfD Temp Account : 03/08/18 at 09:41 PM.
Report comment to moderator  
Reply With Quote
Unread 03/08/18, 10:26 AM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
Update

What's new?
  • Fixed a database error for people starting out new. Oops. Sorry about that.
  • Proceeded to clean up most of the rest of the code, found a few potentially hazardous bugs along the way that were a little eye opening. Fixed things and optimised as I went through it.
  • Fixed the cosmetic issue where the left/right mouse buttons icons would show up in the main Librarian interface.
  • Probably some other stuff, too. I forget.
Anything else?

If you're just starting out with my builds of Librarian, check a few posts down to see my big post about why I'm doing this. It's important. You'll want to read that before using this.
Report comment to moderator  
Reply With Quote
Unread 03/07/18, 10:10 PM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
Re: Suggestion to replace deincrementing medium

Originally Posted by unu-yakaio
A quick fix for those that don't want to wait for an official update or do the conversion for the version by WfD [...]
Except it's not a quick fix, or any kind of fix. It doesn't fix anything. With books still stored by title Librarian is horribly broken. All this is doing is giving people false hope that they can continue with their broken database. It's just wishful thinking that's going to hurt other people.

The reason I've been doing this is because I recognise that this conversion is necessary for the reasons I've outlined below. I have generalised anxiety disorder, I'm incredibly shy, my main account was banned due to mysterious reasons (that I was never told) which leaves me feeling very unsafe, and yet I'm fighting my own anxieties and worries in order to do this for people because I'm a big baby and all I can think about is how sad people will be when the wishful thinking bubble bursts.

It's better that they know sooner rather than later.

The only alternative to the conversion is to accept, with full awareness, that Librarian's database is very broken and will only continue to become more and more broken as time goes on. For the reasons I've explained below.

I'm sorry to reply to this, but this wishful thinking is just going to hurt people. Librarian is broken. That's why the conversion has to happen.

Edited for footnotes:

And in general I'm philosophically opposed to quick fixes and simple tricks as a pragmatist because I know scientifically that they don't exist. It's like dieting fads. There is no simple trick or quick fix. If someone says that something has to be done which requires a little work; And then another person comes along and says "You can avoid this work with this quick fix!"? Which of them would you trust?

It really is just like dieting fads. It's endemic in Western culture, really. Complete nonsense is being marketed and peddled as quick fixes or simple tricks which don't actually work. That this particular quick fix was even highlighted in bold text left me feeling queasy. That's marketing. I wouldn't be telling people that they had to clear their SavedVariables and start over if there really was an alternative. There is no magical quick fix. There never is.

So that just makes my skin crawl. I'm telling people they need to put in the work to convert their databases because they're broken. When something is completely broken there's no quick fix or simple trick. I have to stress that.

It's like when a website suggests that you cure an illness with this quick fix but it's more likely to cause anaphylactic shock.

That's why I got upset. It's misleading. I don't know whether intentionally or meant in earnest, I can't tell, but it absolutely is misleading. That's what quick fixes and simple tricks are meant to do -- mislead people.
Last edited by WfD Temp Account : 03/07/18 at 10:33 PM.
Report comment to moderator  
Reply With Quote
Unread 03/07/18, 10:01 PM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
Small Update

What's new?
  • Forgot to consider certain database states with the cleanup. Pretty minor, would've just thrown errors the first time Librarian was run, but that bothers me. Fixed.
Anything else?

Please read the post directly below. It has a lot of information.
Report comment to moderator  
Reply With Quote
Unread 03/07/18, 09:36 PM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
Update

This is sort of my magnum opus when it comes to updating Librarian. I'm really pleased with myself.

What's new?
  • Cool new sorting stuff. Books that start with The will now be sorted properly. So if a book is named The Quest of the Quest, it'll show up in your Librarian list as Quest of the Quest [The]. This also has some shiny stuff that accounts for things like Book I, Chapter 1, Volume 1, and so on. So if a book is called The Shining Thingies, Part 1, it'll now show up as Shining Thingies [The], Part 1 instead. Sane sorting is good for my OCD.
  • I've written up some instructions for the utilities explaining how they work and such. That can be found in the Utils folder, named Utility Instructions as you might expect!
  • The Merge My Librarian Databases utility now exports a MergeReport file which you can ogle at to see if everything looks okay.
  • I finished properly cleaning up the database. The first time you log in, it'll do the cleanup automatically. The Librarian database is now what it should've been, which avoids so much pointless iteration. Why does this matter? Well, it doesn't, not much. The database looks nicer, now, to read; And it's more efficient because Librarian really was doing lots of pointless iterations that it didn't need to and adding unnecessary overhead. Basically... efficiency OCD. OCD OCD OCD. OCD is fun.
  • Code cleanup. Might do more of this. Might make formatting nicer overall. Don't know. Most people don't care about this. Hm... We'll see.
What do I do?

If you've used one of the Librarian updates I've uploaded in the comments before? Just delete your Librarian folder from your Addons folder and decompress this one there.

If you haven't? You'll need to delete your Librarian SavedVariables (this is in the SavedVariables folder under the live folder, you go there to get to the Addons folder). Why? I'll explain below, but it's really important. The database had to completely change.

After you've deleted your SavedVariables, just drop do what I said in the first paragraph. I will stress that if you've already used one of my Librarian builds in the past, you do not need to delete your SavedVariables again. Okay?

What issues does the main Librarian addon have, why should I use this?

Well, there's two problems. Both are pretty major.

The most important (as I tend to keep mentioning) is that the Librarian database as it stands now is broken and useless. It stores books by title. Why is this an issue? Zenimax likes to change book titles (fixing typos, grammatical errors, et cetera), so you might get two books with the same contents but different titles. ESO also likes to have different books with the same title, so if there are two books with the same title which are different? Too bad, Librarian only stores the one it saw first. It doesn't even matter if you saw these books on different characters, or in different zones. You only get the very first you see with that name.

We fix this by switching the database over to book IDs. Sadly, there's no way to preserve your old database. You can't get book IDs from titles because some books are different while keeping the same title, as I explained above. Essentially, the Librarian database system is very broken, yes, so we do have to switch over. This means you lose your progress, but it's better to start over sooner rather than later. Librarian storing by titles will always be broken, so you'll never have a complete book collection (and you'll experience other bugs as well due to ESO randomly changing titles).

My version stores books by their book IDs and thus is future proofed against being broken in this way. Sorry that this has to happen. This is what inspired me to start working on Librarian in the first place.

The other issue is that Zenimax has changed how mediums are stored. So viewing most books in your Librarian database will just result in an error, now, anyway. There are workarounds, but generally it's going to be ugly. This is just another reason why it's good to start over at this point. And if we're starting over, let's start over saving our books by their book IDs.

Going forward, this is all for the best. It's why I'm doing this. I... just like to help. Apparently that can be bad or confusing, but I try my best. I don't know. Still, if you want a Librarian that works? Here you go.

What's changed overall?

Gods, so many things.
  • Librarian stores books by book IDs instead of titles. Yay! No more brokenness.
  • Librarian can now handle different books with the same title.
  • Due to how ESO likes to change features about books that are already in the world, my version of Librarian rescans books when you see them. So for each book you find, Librarian stores it (by its ID), and then if you see that book again but the title/contents have changed slightly? Librarian will update itself to reflect the changes ESO has made. This updates the title, contents, the paper (medium) style, the word count, and so on.
  • All the key bindings are fixed. You can mark read/unread; The left/right mouse button images show when they're supposed to; Alt now goes back to Librarian if you opened a book from Librarian, et cetera.
  • The center screen notification now works.
Footnotes...

It's not at all my intention to steal Librarian away. I explained that in my comments below. I don't like that, it's unethical. This is why I'm uploading these as comments. It's my hope that calia1120 will adopt my changes into the main Librarian addon. The sooner this happens, the better. The progress reset needs to happen eventually and false hope wouldn't be helpful, that's why I decided to put these changes in a comment rather than a private message. The more people who switch over to this, and the more quickly that happens, the better for everyone.

Like I said, I just want to help. That's my drive.

Edited for formatting.
Last edited by WfD Temp Account : 03/07/18 at 09:39 PM.
Report comment to moderator  
Reply With Quote
Unread 03/07/18, 11:06 AM  
unu-yakaio

Forum posts: 1
File comments: 2
Uploads: 0
Suggestion to replace deincrementing medium

Don't know if it matters anymore with all the updates after this, but my suggestion for a simpler solution building on what WfD Temp Account said regarding book medium:

Store everything as before and don't change the SavedVariables.

When opening the book do something like this in Librarian:ReadBook (pseudo-code, not to be copied verbatim):

Code:
if book.timestamp < timestampWhenMediumChanged then
	medium = medium+1
end

A quick fix for those that don't want to wait for an official update or do the conversion for the version by WfD Temp Account is to replace book.medium with math.max(book.medium, 1) on line 516 in Librarian.lua. It will not show the correct style for everything, but it will at least display.


Originally Posted by WfD Temp Account
i changed the code to de-increment when the book is stored then add the increment when the book is read. then i went into my savedvariables and found the book which was added after the patch that did this and started de-incrementing the counts

this is something players will have to do themselves. that or wipe their savedvariables and start over.
Last edited by unu-yakaio : 03/07/18 at 11:08 AM.
Report comment to moderator  
Reply With Quote
Unread 03/07/18, 01:47 AM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
update

what's new?

- typos happen. i missed a bug when testing the new alert stuff because of how I was testing it.

no big bugs or anything. it was just a cosmetic thing.

read the stuff below about savedvariables and the changes i made to librarian.
Report comment to moderator  
Reply With Quote
Unread 03/06/18, 08:44 PM  
calia1120
 
calia1120's Avatar
AddOn Author - Click to view AddOns

Forum posts: 62
File comments: 232
Uploads: 5
Thank you for this. I've been looking for a way to handle conversion without killing savedvariables, but I've been a bit busy working on a pile of Wykkyd updates/fixes, along with real life stuff.

Originally Posted by WfD Temp Account
Time for another confusing update I guess. Oh boy. Not sure why I do this, but hey... If it helps someone out there, that makes me happy.

Updated Librarian

What'd I fix this time?

- The E keybind for opening a book wasn't working. One instance where I forgot to switch title over to bookId. Nothing cataclysmic, just that that keybind wasn't working (I never use it, so I didn't notice). Now it works.

- I noticed that the on screen alert (not the text chat one) wasn't working. Why? The CENTER_SCREEN_ANNOUNCE system in ESO has changed completely! Wow, it's very different, now. I had to learn how the new thing works in order to fix it, so I did. It's fixed. Yay.

As always, if this is your first time using one of my comments-uploaded Librarian builds? You need to delete your SavedVariables due to switching from titles to book IDs in the database. You can find the reasons why explained below. Suffice it to say, Librarian used to be kind of broken. If this isn't your first time using one of these builds and you did delete your SavedVariables before, you don't need to do it again.

So... You know, you can use this or not. It's your prerogative.

Still not sure why I do this.

The desire to help is masochistic at the best of times.
Report comment to moderator  
Reply With Quote
Unread 03/06/18, 07:52 PM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
Time for another confusing update I guess. Oh boy. Not sure why I do this, but hey... If it helps someone out there, that makes me happy.

Updated Librarian

What'd I fix this time?

- The E keybind for opening a book wasn't working. One instance where I forgot to switch title over to bookId. Nothing cataclysmic, just that that keybind wasn't working (I never use it, so I didn't notice). Now it works.

- I noticed that the on screen alert (not the text chat one) wasn't working. Why? The CENTER_SCREEN_ANNOUNCE system in ESO has changed completely! Wow, it's very different, now. I had to learn how the new thing works in order to fix it, so I did. It's fixed. Yay.

As always, if this is your first time using one of my comments-uploaded Librarian builds? You need to delete your SavedVariables due to switching from titles to book IDs in the database. You can find the reasons why explained below. Suffice it to say, Librarian used to be kind of broken. If this isn't your first time using one of these builds and you did delete your SavedVariables before, you don't need to do it again.

So... You know, you can use this or not. It's your prerogative.

Still not sure why I do this.

The desire to help is masochistic at the best of times.
Report comment to moderator  
Reply With Quote
Unread 03/06/18, 04:24 PM  
WfD Temp Account

Forum posts: 0
File comments: 34
Uploads: 0
Originally Posted by Rattlesnark
Originally Posted by WfD Temp Account
Snip
Would it be legal for you to create your own addon upload entry on ESOUI for this? It would be more practical than posting several consecutive and rather confusing comments, as happening right now.
Okay, I'll bother to use proper grammar for this. Frankly, I'm incredibly depressed every time I stop by ESOUI so it's hard to muster the effort.

I don't know whether you're trying to be helpful or not; I won't cast aspersions. Consider the account name, though, for a moment. My main account was banned without warning, I was locked out of my addons without ever being told why. This was incredibly hurtful since I trusted ESOUI to be better than that. I've never done anything bad by the moderators or this community.

As such, I feel unwelcome here. I don't feel safe to create another proper account and post anything. It'd likely just result in another mystery ban; One once again without warning or provocation. So, no, I can't create a new upload page for my efforts.

Let's say that I did feel comfortable enough to do that? It would still be GROSSLY unethical to do so. That kind of thing matters to me. I'm not the kind of person who runs around and steals mods without even asking the original owner if it's okay to repost them (as has happened to a few of mine). What I would prefer to see is that my efforts save the mod author some work.

I uploaded mostly for their benefit, so that these changes can be diff'd into the trunk addon's code, thus alleviating some of the work and effort they'd have to put in. I really like Librarian, a lot, and I just wanted to help.

That's why I still post here. It's why I leave updates to my own mods in the comments sections, too.

For whatever reason, I feel driven to do good and to try and help people. It isn't always easy when one has a generalised anxiety disorder and autism, sometimes it can feel like a damning, thankless thing and one wonders why the effort was even made. And yet, still, I want to help people. I want to do good. I lack confidence and self-esteem to a great degree, so actually doing some good can be cathartic for me. As such, I know it isn't completely selfless but considering how it can sometimes impact my health? It's more a selfless effort than not.

I just care.

I updated Librarian because I realised that the title-focused database system was unsustainable. I talkeda bout it with my partner and we both agreed that we'd never have a complete and accurate in-game book collection without the change. After that, I decided to upload it because it might be helpful and I felt guilt about having this fix when others didn't.

So I posted it here, in a comment.

Is it confusing? I don't think so. So long as you have basic reading comprehension the comments are perfectly comprehensible and readable. They have clearly laid out instructions and information. I'm really not sure how they could possibly confuse anyone, so that you'd say that has left me scratching my head. If it confuses you? Then just pass it by; Ignore it, it doesn't exist.

I wanted to do these uploads to help people.

Take it; Leave it; Be a punk about it. It's your prerogative, really. As I said, I was offering this mostly to the addon author so that they could make the changes and spare other people from facing the pain of a broken database sooner rather than later. However, in order to bring that sooner forward, I provided it in a comment instead of a PM for those who might want to jump on early rather than facing the issues somewhere down the road.

If any of this is still confusing, I don't know what to even tell you at this point.

Let's try this:

1. My main account was banned without cause or notice, I don't feel safe enough to make a new mod page;
2. It's quite unethical to just steal other people's addons, anyway;
3. Librarian's database system is very broken and needed to be fixed;
4. This meant needing to clear its SavedVariables, but it was necessary;
5. So I made that fix, along with a few others (such as the key bindings fixes);
6. I also made some decently documented utilities to go with it (one of which was to ease the transition from old database to new);
7. I uploaded them to ESOUI as I'd feel guilty not sharing what I have;
8. Perhaps it's an old-school anarchist thing 'From each according to their ability, to each according to their need;'
9. And here we are.
Report comment to moderator  
Reply With Quote
Unread 03/06/18, 06:07 AM  
Rattlesnark

Forum posts: 2
File comments: 13
Uploads: 0
Originally Posted by WfD Temp Account
Snip
Would it be legal for you to create your own addon upload entry on ESOUI for this? It would be more practical than posting several consecutive and rather confusing comments, as happening right now.
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: