Download
(22 b)
Download
Updated: 04/18/18 06:05 PM
Pictures
File Info
Compatibility:
Dragon Bones (3.3)
Updated:04/18/18 06:05 PM
Created:04/05/18 03:59 AM
Monthly downloads:41
Total downloads:2,893
Favorites:14
MD5:
Pocket Apocrypha
Version: 015-100022
by: Werewolf Finds Dragon, joshmiller83

Please read this.

I'm taking another break for a while. My anxiety isn't holding up well and I need to take some time for myself to recover. Frankly, modding can be a thankless job and some of the people one is forced to interact with can be... deeply unpleasant at best, to put it in the kindest way I can and not as I truly want to. For now, I feel like my mods don't need any further work done to them. They're fine as they are. See you later, folks.

I'll be back! I'm not gone for good, I just need to set this aside for now. That's all.

One thing I will say as a final note is that it'd be nice if one could turn off the comments system and only have a bug tracker in the vein of Nexus Mods. That'd be handy for people like myself who do deal with anxiety. And I deal with a lot of anxiety.

See you around, folks. My thanks to those who were kind.


Notice: Please download the addon from this location for now, and report back in the comments if you crash while trying to import from the lore library, thank you.

Click here to check out my other addons.

The Now Actually Working edition! Sorry about that.
Description
Wouldn't it be nice if you had a Lore Library, but for every book you encountered across your travels? Recorded, readable at any point, with a way to keep track of which books you have/haven't read, sortable by various factors (such as alphabetical, the time you found the book, et ceteara), and searchable for when you're seeking out that specific bit of lore? Welcome to Pocket Apocrypha, your own little slice of Hermorah's own realm right in your proverbial pocket!

Now you don't have to stop to read every single book along the way, you can rest easy and trust that they're all being stored in your own little pocket realm to be retrieved later.

This is a port of Librarian. For more information, see the FAQ below.
Features
In the hallowed words of our dear Commandant Lassard, Pocket Apocrypha can do many, many fine things for you.
  • Captures a book (in its entirety for you to read later, accessible from a user-friendly interface;
  • When you do come back to your book, it'll look exactly as it did in the world as the addon uses the same UI for displaying books that the game itself does;
  • Whenever you collect a book the time of collection is recorded, you can then sort books to be displayed by their collection date so you can see what's new and what's old;
  • With a keypress or the push of a button (either clicking the binding or right-clicking the item in the list) you can easily mark books read or unread, to know which titles you've absorbed into your concept organ;
  • A marker in Pocket Apocrypha's interface and in the very book itself which shows you whether a book is read or unread;
  • Books can be easily imported from your Lore Library collection at the push of a button;
  • You can toggle between whether you want to show all of the books you've seen or just the books you've seen on your current character with the push of a button;
  • You can search the titles and/or the contents of books for when you have a need to find a certain old book or do a little scholarly lore research;
  • The interface can be opened via a key bind or a slash command (/apocrypha);
  • Books in Pocket Apocrypha can be sorted by a variety of factors -- title, time found, book size (word count), and unread/read;
  • Alert options for when you find a new book (center screen message, chat message, or none);
  • A reminder can be set (or not, whichever you desire) to reload your UI after a configurable amount of discovered books (so, for example, it'll remind you after 5 books found);
  • The ability to mark all of your books read/unread at the press of a button;
  • You can view the options by clicking the gear in the addon's interface, by going into the usual addons menu, or via a slash command (/apocryphaoptions);
  • It's fully localisable in every respect (only English thus far, but other languages might arrive later);
  • An incredibly safe database system which properly tracks books (including those with the same titles) via their IDs.
That is a lot of things, isn't it? Well, it's all very friendly and easy to understand, as you can see from the screenshot.

It also has a collection of utilities!
  • Backup -- Make instantiated backups of your database;
  • Restore -- Restore your latest database backup;
  • Merge -- Merge two databases together;
  • Export -- Dump a list of names of books you've read to a text file;
  • Update -- For when the database needs to be updated (I'll let you know).
There's an instructions file in the Utils folder to get you started in understanding what each utility does, along with detailed steps for their use.

If you have any further ideas, let me know in the comments.
FAQ
Q: Why port? What's wrong with Librarian?

A: That's tricky to answer. I could point at how a change in the handling of
book meidums has rendered Librarian broken, anyway, and databases ruined; I could point at how it has a number of existing bugs which I wanted to fix; I could also point at the new functionality and improved features of Pocket Apocrypha; I could... but none of those are the reason you should switch.

The main reason is that Librarian was storing books by their titles, rather than the internal book IDs supplied by Zenimax Online Studios. Here are the problems that can occur with that:
  • If two books have the same title, the new book you've encountered won't be stored even if the contents are completely different;
  • If ZOS changes the title of a book for any reason, it means you'll now have a false copy of that book under a different title which erroneously bloats your collection;
  • If ZOS changes the contents of a book (typos, corrections, changes to the book medium, et cetera), those changes will never be incorporated back into Librarian.
This is all fixed in Pocket Apocrypha. Every book you find will be stored by its unique book ID, so you won't encounter any of the above problems. Furthermore, thanks to using IDs, Pocket Apocrypha will update your books as you find them in the world again to match any changes ZOS might've made.

The release of Pocket Apocrypha was necessary. Not desirable, perhaps, but absolutely necessary.

Q: I'm a user of the original Librarian addon. Can I use my old database with Pocket Apocrypha?

A: No. I'm sorry. Due to the books being stored by title, there's absolutely no means to salvage that database. It's ruined. The sooner you start over, the better. I'm sorry to have to say it, but Librarian's database is simply that broken, you're better off going at it with a fresh start, knowing each book is stored by its ID and thus is future-proofed against any cataclysmic changes (like the ones that befell Librarian).

Q: I used the builds of Librarian you released under the comments section, can I use that database?

A: Yes. It will need to be converted but that database is 100 per cent compatible due to its use of book IDs. Use the database update utility to convert your old Librarian database over Pocket Apocrypha standards.

Q: Will you setup a system where people can share their books so that we can all have a complete database?

A: No. It'd be far too easy to inject nonsense into it as I have no means of verifying what is or is not a real book. So someone could include a book about penises, and if it were written well enough we'd be none the wiser that it wasn't in the game itself.

This would lead to people talking about ESO having books about penises. That'd be bad for everyone involved. So, sadly, this can't happen.
Credits
My ever patient beau who manages to sometimes raise my courage to the point where I can post things online.
::Version 014-100022

Fix: Book mediums being updated from CWC standard weren't properly storing their medium.

::Version 013-100022

Improvement: Changing character names in books that store character names would result in Pocket Apocrypha reporting an updated book whenever you found that on a different character. This is hardly ideal. Instead, PA now strips out the name when storing a new book and replaces it with a placeholder. When viewing the book, the placeholder is replaced with the name of the character viewing the book. I felt this was the most apt way to deal with this, and solves the problem. From now on, you should only see those books being updated once more (to get the name replaced with the placeholder), then you won't see that again.

::Version 012-100022

I noticed that the Clockwork City pro-grammatically changes the medium of its books, this is a problem since any books you already have will be updated to CWC standard when you view them there. I've included an option (which defaults to off) which doesn't update the medium for CWC books, it's off by default and it should stay that way unless a medium-related database corruption event has occurred.

I moved the main files out of the root, leaving only the initialization txt there. This is just for cleanliness's sake.

::Version 011-100022

* Updated: Changed names of dropdowns to be more descriptive.
Fix: Forgot to update locale files.

::Version 010-100022

* Update: PA now notifies you if ZOS has updated a book in any way, and there are now new options to handle how this notification occurs. If this isn't your first time using the addon, check those out and be sure to set them.
* Fix: PA used to use the character time stamp for books even if the 'Show All Books' option was enabled, this has been fixed so that now the Universal time stamp is properly used.
* Fix: PA would sometimes notify you of a new book if it was new for your character even when the 'Show All Books' option was toggled on, whereas with that option on it now only notifies you when you find a new book Universally regardless of character.


:: 006-100022

o Added a version to the txt launcher.
o ???

:: 005-100022

o Fixed issue where the keybind to open Librarian wouldn't work (SCENE_MANAGER typo).
o Fixed issue where import would cause the import function to crash (RefreshData being called with every AddBook, it isn't doing that any more).
o Fixed issue which would occur on trying to add a book (????) (not sure why this was happening but it appears to be fixed, too).
o AAAAAAAAAAAAAAAAAA

:: 004-100022

o You can now right-click on a book in the list to mark it as read/unread.

:: 003-100022

o Oops, forgot to remove an old Librarian test backup. Nothing sensitive in there other than character names; If you saw that... feel free to yell at me in-game, if you like!

:: 002-100022

o Removed a couple of localisation lines I don't need any more.

:: 001-100022

o First release. And it's size is the number of the beast. That's amazing.
Optional Files (0)


Post A Reply Comment Options
Unread 04/25/18, 05:48 PM  
LadyHyde
 
LadyHyde's Avatar

Forum posts: 0
File comments: 8
Uploads: 0
The only one being abusive here is you.

"If you run into an asshole in the morning, you ran into an asshole.
If you run into assholes all day, you're the asshole."

Originally Posted by Werewolf Finds Dragon
some of the people one is forced to interact with can be... deeply unpleasant at best, to put it in the kindest way I can and not as I truly want to.
Q: Why use this instead of the Librarian mod?
A: Ever since its original developer (Flamage) abandoned it it's been a buggy mess thanks to lazy, poorly handled maintenance.
There are a few nice people around here. They're great, I'd do anything I could to help them. The rest, though? Well... they're rude and not always that smart.
What our resident genius is failing to understand though
Of course, if you knew anything about basic human decency, let alone manners, I would've taken your suggestion to heart.
The fact is? ESOUI's community is filled with sociopathic, entitled, spoiled brats who think that the world is theirs to shape and command.
And for the record, the issues were in pChat. A mod user who actually knows how to be friendly helped me track that down. The crashing issues were caused by another mod. Not that any of the God's gift coders bothered to try running PA on its own to find out if it really was causing issues, nor did they even bother to find out if they were running the latest code. Nope, just assume the worst and get angry when that doesn't work out.
I'm not fond of this bizarre, vile unspoken sacrament that mod users seem to believe they have with all mod authors.
In the coding biz, this is known as 'feature creep.' It's never considered to be a good thing. This is why project scope is so necessary. Sadly, most amateur coders fail at this aspect of project handling and will readily bolt the most unnecessary, pointless additions onto their work just to be lavished with praise.
Often amateur modders will leap on outdated mods seeing an opportunity. Sometimes this is benign and they just update the mod's UI version, sometimes though they decide to be more ambitious and try to take feature requests. Sadly, they won't know what they're doing with this new project they've just taken on. Their attempts to update the code will leave it riddled with bugs and issues.
Report comment to moderator  
Reply With Quote
Unread 04/24/18, 12:52 AM  
Werewolf Finds Dragon
AddOn Author - Click to view AddOns

Forum posts: 17
File comments: 105
Uploads: 15
You know? There are a few nice people around here. They're great, I'd do anything I could to help them. The rest, though? Well... they're rude and not always that smart. I've moved on over to Nexus Mods. I can't stick it here, any more, honestly. I can't.

I mean, look at Gizmoduck, here.

Let's count the issues in just the latest post.

Issue #1:

He's treating me like an indentured servant. Apparently, if a strange on the Internet throws a wobbly, I have to leap to his beck and call, rushing to do what he commands even if their 'suggestion' is actively detrimental. Reality doesn't work that way. Try going to restaurant and demanding they provide you with seating and food for free, see how that works out.

This is a hobby. I don't accept donations, and I won't put up with that kind of treatment.

Issue #2:

He didn't even bother to read the description enough to understand what Pocket Apocrypha does.

I mean, he raises an interesting point about lore books. Should Pocket Apocrypha ignore lore books or just point at them? Perhaps. What our resident genius is failing to understand though is that there are many books in the game which aren't lore books, which aren't stored in the lore library at all. Pocket Apocrypha collects those for display. That's why it stores the book bodies. Derp.

Had he not been so abrasive and bothered to understand what the addon does, suggesting a different focus for lore books specifically might've been a good idea.

Issue #3:

He didn't bother to notice that this is largely a maintenance update from an existing mod, that I'm fixing things up as I go. I'm sorry that reality doesn't immediately conform to your desires, but I'm doing what I can with what time I have. I can't just drop all of my real life responsibilities to rush to do something that isn't actually a job. Which comes back to the indentured servant aspect.

Issue #4:

If demands don't work, perhaps sociopathic attempts at manipulation will? "HEY, THIS OTHER ADDON WORKS AS I WANT!" Well, why don't you spend the time and contribute some code? Like I did with Librarian. If the code is actually good, and not a trainwreck, I'll incorporate it. If it's terrible, I'll work on getting it in there myself, eventually.

Of course, if you knew anything about basic human decency, let alone manners, I would've taken your suggestion to heart.

I could go on... I won't. I think I've made my point.

The fact is? ESOUI's community is filled with sociopathic, entitled, spoiled brats who think that the world is theirs to shape and command. If you're not dealing with users treating you like **** and making ridiculous demands, you're dealing with other coders who think they're God's gift to coding and get combative if refused. I mean, if I was told my Librarian code wasn't wanted, I would've just quietly left. If I felt it was necessary, I would've forked at the very most. I wouldn't have caused a scene with the mod author in the comments.

There are just too many sociopaths. I can't deal with it.

And for the record, the issues were in pChat. A mod user who actually knows how to be friendly helped me track that down. The crashing issues were caused by another mod. Not that any of the God's gift coders bothered to try running PA on its own to find out if it really was causing issues, nor did they even bother to find out if they were running the latest code. Nope, just assume the worst and get angry when that doesn't work out.

I've had it.

I'm done.

I can't deal with this any more.

I do still want to provide people with my mods, though. I didn't know Nexus Mods had an ESO section or I would've moved on over sooner. The thing about Nexus Mods? Not only is the community there not as bad, but I can turn off the comments.

I'm done dealing with people like this.

I'm just done.
Report comment to moderator  
Reply With Quote
Unread 04/17/18, 09:01 AM  
GizmoDuck

Forum posts: 4
File comments: 178
Uploads: 0
Is it possible to NOT include a copy of the books text in the addonsettings lua?
Just drop the whole [ Body ] tag.
Just "point" to the ingame Lore Library, and use the Item ID to mark if read or not.

We can search the Lore Library already, maybe add a "Recently Discovered Books" area. (like Votan's Achievement Overview does)
Last edited by GizmoDuck : 04/17/18 at 09:02 AM.
Report comment to moderator  
Reply With Quote
Unread 04/15/18, 02:55 PM  
Phinix
 
Phinix's Avatar
AddOn Author - Click to view AddOns

Forum posts: 186
File comments: 1781
Uploads: 32
Sorry to hear about your anxiety issues friend. I know several people who struggle with this and I myself am no stranger to the emotional impact of the internet. Something about the anonymity of it leaves one's mind to consider many more possible interpretations of someone's intent than we would think to if we were talking in person.

It is also particularly difficult when we take pride in something we are working on, which is good...

Something that has helped me is to adopt the whole "innocent until proven a**hole" approach to random comments on the internet. I find I am able to weather the impact of anonymous communication much more effectively when I assume the best about people, instead of expecting they must be intending hostility like so many other jerks we encounter in day to day life.

I just literally read every single comment on this addon page, and unless some were deleted I can honestly say I do not see any that were overtly offensive, rude, hurtful, or otherwise intended to cause harm in any way. Perhaps the offending posts were in fact deleted? That is good as well...

Believe me I definitely know how vicious mod users can get. Some act entitled to your work for free as if you owe them (spoiled brat syndrome), some rip you off, and some are downright terrible human beings that make you wonder what sort of miserable life they must lead to have become such a toxic waste of humanity. Thankfully the ESO modding community has mostly been an awesome experience for me over the years.

I think something we just have to get used to as mod authors is that things are not always going to work as we hoped. Things break. Other addons interact and cause weird errors, crashes, unforeseen problems. It is all a learning experience that never ends! The trick is, not to allow simple reporting of problems to be confused as personal attacks.

I know that is easier said than done, but in my opinion it is an essential life skill to be able to identify which interactions are INTENDING harm and which we are simple EXPECTING to intend us harm based on past experience. It's the old not making mountains out of molehills idea. We must consciously CHOOSE not to allow a simple thing, which may be totally innocuous, to remind us of EVERY OTHER THING that is terrible in life, and then in turn EXPECT that it will of course be another of those things.

Sometimes a cigar is just a cigar. Life can definitely make us gun shy but we can't flinch at every shadow. We just have to consciously evaluate "OK, what is the context here, what did they actually say, am I reading too much into this, etc.."

A lot of the time I think people just want to help, and maybe text is just not the most effective way to get the idea across when so much is open to interpretation. It is a skill like any other. You just have to work at it.

I wish you all the best in recovery and life.
Last edited by Phinix : 04/15/18 at 03:33 PM.
Report comment to moderator  
Reply With Quote
Unread 04/07/18, 08:12 AM  
Phinix
 
Phinix's Avatar
AddOn Author - Click to view AddOns

Forum posts: 186
File comments: 1781
Uploads: 32
Originally Posted by LadyHyde
My intent was to provide you feedback with brevity and clarity; if that's not how it felt, if I'm being counted among the poor-mannered folks, I wholeheartedly and unreservedly apologize.
Likewise.
Last edited by Phinix : 04/07/18 at 11:51 AM.
Report comment to moderator  
Reply With Quote
Unread 04/07/18, 02:52 AM  
hagermanj

Forum posts: 2
File comments: 367
Uploads: 0
I forgot to add to my last post: I downloaded v 006 from Minion.
Report comment to moderator  
Reply With Quote
Unread 04/06/18, 08:13 PM  
LadyHyde
 
LadyHyde's Avatar

Forum posts: 0
File comments: 8
Uploads: 0
My intent was to provide you feedback with brevity and clarity; if that's not how it felt, if I'm being counted among the poor-mannered folks, I wholeheartedly and unreservedly apologize.
Report comment to moderator  
Reply With Quote
Unread 04/06/18, 01:27 PM  
Werewolf Finds Dragon
AddOn Author - Click to view AddOns

Forum posts: 17
File comments: 105
Uploads: 15
Edit: I just want to take a moment to thank @joshmiller83 for actually trying the MediaFire version, and being nice in general. As a person with an anxiety condition, this has been hard. (I moved this to the top as I want it to be seen first).

Notice: To those who're misbehaving (which isn't all of you), there's this thing we call good manners. I work on this for free and I'm trying to fix it without adding the danger of a system lockup to the addon (something that old Librarian was capable of if it misstepped). I'm not the kind of person who'd just throw in that kind of thing and forget about it. Any further hostilities WILL result in a post cleanup and reports. There's NO reason for attitudes. I'm doing my best, here.

I have a bad anxiety condition and overloading me isn't going to get anyone anywhere.

Here is an experimental version.

I have a request.

1.) Try the original MediaFire upload, do an import. Do you crash?
2.) Try the experimental MediaFire upload above, do an import. Do you crash?
3.) Try both versions with all other addons disabled, do an import. Do you crash?

The thing is is that my experiments have revealed that the latest version can't crash. I've benchmarked this. I don't know what's going on, and I want to find out. What convinces me more that there's something further untoward happening here...
Originally Posted by joshmiller83
Just downloaded 006? from Mediafire.

Imported over 1000 books within 2 secs without crashing and I have 60+ addons installed.

No idea why others are having issues.
Which is what I figured. I've run tests with data pools of different sizes, multiple times. I haven't seen a single crash.

If I were wrong, then you, I, or my partner would be able to reproduce this with the latest proper version. None of us can.

Edit 2: With ESO having no loop protection, is it so difficult to understand why I don't want huge data handling to happen in an OnUpdate? I've had Librarian lock up my entire system, and other addons. I don't like that. That causes me a great deal of anxiety to deal with, it's worse than the client just crashing. I don't want to inflict that upon others.

---
Last edited by Werewolf Finds Dragon : 04/06/18 at 02:00 PM.
Report comment to moderator  
Reply With Quote
Unread 04/06/18, 10:47 AM  
joshmiller83
AddOn Super User
 
joshmiller83's Avatar
Premium Member

Forum posts: 70
File comments: 243
Uploads: 0
Just downloaded 006? from Mediafire.

Imported over 1000 books within 2 secs without crashing and I have 60+ addons installed.

No idea why others are having issues.
Report comment to moderator  
Reply With Quote
Unread 04/06/18, 08:02 AM  
Phinix
 
Phinix's Avatar
AddOn Author - Click to view AddOns

Forum posts: 186
File comments: 1781
Uploads: 32
Crashes persist...

Must report that the latest 006 version still crashes with other addons loaded, which it will continue to do randomly based on how much addon memory space/script threads are occupied by the user's total addon load.

Basically it is as Votan said. The addon interface was not meant to process so much data in such a short time. Keep in mind this is having to make calls to the saved variables each time a book is added. Also keep in mind this isn't a question of WHAT addons are loaded, but more HOW MANY and how much resources they consume.

The fix is as Votan suggested, and how other addons like Srendarr have solved the problem in the past, to run the function in iterative batches to break up/distribute the load on the interface.

Check your PM's when you have a moment.
Last edited by Phinix : 04/06/18 at 08:18 AM.
Report comment to moderator  
Reply With Quote
Unread 04/06/18, 06:32 AM  
hagermanj

Forum posts: 2
File comments: 367
Uploads: 0
Just downloaded V 006. Just did import of Lore Library on 2 characters. It worked with no problems .
Thanks for the quick response to problem and fixing it.
Report comment to moderator  
Reply With Quote
Unread 04/06/18, 03:23 AM  
LadyHyde
 
LadyHyde's Avatar

Forum posts: 0
File comments: 8
Uploads: 0
Exclamation Still still crashing

Originally Posted by Werewolf Finds Dragon
If you're using Minion, could you try doing a manual update?
  • Moved Pocket Apocrypha addon folder out of AddOns tree
  • Downloaded file PocketApocrypha-005-100022.zip via ESOUI download link
  • Extracted zip file into AddOns
  • Booted game
  • Attempted import of lore library
  • Crash to desktop

Originally Posted by Werewolf Finds Dragon
Let's do this the way I did prior.

Does anyone have any issues with the above version of the mod? Specifically that one. Does that still crash people?
Yes:
  • Moved (new) Pocket Apocrypha addon folder out of AddOns tree (again)
  • Downloaded http://www.mediafire.com/file/cb7jnlzi531ym0e/PocketApocrypha.7z
  • Extracted 7z file into AddOns
  • Booted game
  • Attempted import of lore library
  • Crash to desktop

Originally Posted by Werewolf Finds Dragon
Logically, there cannot be a crash issue in 005. If you insist there is, after a manual update, I'll absolutely look into it but I'd be genuinely baffled.
*shrug* It's still crashing. I've not done the full disable-all-other-addons thing, but I did try in both standard and gamepad modes (the latter of which I play in) with no change.
Report comment to moderator  
Reply With Quote
Unread 04/06/18, 02:53 AM  
Werewolf Finds Dragon
AddOn Author - Click to view AddOns

Forum posts: 17
File comments: 105
Uploads: 15
Let's do this the way I did prior.

Does anyone have any issues with the above version of the mod? Specifically that one. Does that still crash people?
Report comment to moderator  
Reply With Quote
Unread 04/06/18, 02:43 AM  
Werewolf Finds Dragon
AddOn Author - Click to view AddOns

Forum posts: 17
File comments: 105
Uploads: 15
That's absolutely bizarre. I tried it with fake data over thousands of books and I couldn't get it to crash, so I'm not sure what's going on, there. Are you sure it's the latest 005 release, did the zip say 005? If it did, I'll continue working on it.

Edit: I think for some reason people are getting stuck with the 004 release. The correct one should say 005. If you're using Minion, could you try doing a manual update? I'll see what I can do about this in future releases. I'm fairly sure though that this is the cause.

Logically, there cannot be a crash issue in 005. If you insist there is, after a manual update, I'll absolutely look into it but I'd be genuinely baffled.
Last edited by Werewolf Finds Dragon : 04/06/18 at 02:45 AM.
Report comment to moderator  
Reply With Quote
Unread 04/06/18, 02:22 AM  
LadyHyde
 
LadyHyde's Avatar

Forum posts: 0
File comments: 8
Uploads: 0
Exclamation Still crashing for me

So, running v005-100022 I'm still getting a CTD (crash-to-desktop) when I attempt to import my main's huge lore library:


Main/crafter, with Eidetic Memory: 2038/3653 books
  • Crashes to desktop

Relatively new character: 160/297
  • No issues observed.

Thought you should know.
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: