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:24
Total downloads:2,857
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 08/15/18, 08:10 AM  
Rhynchelma
Premium Member
Premium Member

Forum posts: 43
File comments: 93
Uploads: 0
Quick and dirty fix, NO IDEA if this breaks anything,

change Core.lue line 194

Core.lus is in the addon's Component subdirectory.

to

visible = function() return true end,
Report comment to moderator  
Reply With Quote
Unread 08/14/18, 08:10 PM  
BigM
 
BigM's Avatar

Forum posts: 16
File comments: 371
Uploads: 0
Sad that a couple of bad apples had to attack Werewolf Finds Dragon because they wanted to seem like they were important. So unless the original author comes back we lost a very great and needed addon.

Not going to name the **** but thanks for nothing. Maybe you can pick this up and fix it.

Also, he wasn't treated badly by ZoS but posters on this site.
Last edited by BigM : 08/14/18 at 08:12 PM.
Report comment to moderator  
Reply With Quote
Unread 08/07/18, 09:15 PM  
RavenMind
 
RavenMind's Avatar

Forum posts: 6
File comments: 391
Uploads: 0
Originally Posted by Marazota
ah i see, pages like this with empty downloads is against esoui rules, it can contain malicious codes and such, i will request admins to delete this page
I think that would be a shame. If the author decides to come back & take it up again, only to find the page has been deleted, that may be enough to make them give it up entirely. I don't see why you'd be worried about malicious code. The only malicious code that would be downloaded would have been uploaded by the author. Or perhaps someone who hacked his account. Hopefully ESOUI scans uploaded addons. Either way, if someone's not scanning incoming downloads they're an idiot. I really don't see malicious code as being an issue.

Originally Posted by vecny.samotar
the problem is forbidden by the author and is before issuing an addon Librarian Book Manager which is the forerunner of the addon Pocket Apocrypha so one time posted updates in comments where he put the download link. in Librarian Book Manager's comments, he explained everything and why not forbid him but had to work on the addon Pocket Apocrypha which he completed and in the effort to continue to prese at nexusmods.com where the addon has been posted and the essay wrote comment and updates, but apparently daco became they also blocked it at nexusmods.com
Sorry, I'm barely following you. I did read the comments at Librarian, and nothing there lead me to believe calia or the other auth(s) had a problem with him modifying the addon. Nexus Mods didn't take down the addon. It was hidden by the author. There's a difference. If Nexus had taken it down because they decided it was against their TOS, then that page wouldn't have come up at all, or it would have said it was removed by Nexus.
Report comment to moderator  
Reply With Quote
Unread 08/07/18, 08:45 AM  
vecny.samotar
 
vecny.samotar's Avatar

Forum posts: 23
File comments: 552
Uploads: 0
the problem is forbidden by the author and is before issuing an addon Librarian Book Manager which is the forerunner of the addon Pocket Apocrypha so one time posted updates in comments where he put the download link. in Librarian Book Manager's comments, he explained everything and why not forbid him but had to work on the addon Pocket Apocrypha which he completed and in the effort to continue to prese at nexusmods.com where the addon has been posted and the essay wrote comment and updates, but apparently daco became they also blocked it at nexusmods.com
Report comment to moderator  
Reply With Quote
Unread 08/07/18, 07:07 AM  
Kyoma
AddOn Author - Click to view AddOns

Forum posts: 125
File comments: 328
Uploads: 10
Oops, nevermind.
Last edited by Kyoma : 08/07/18 at 07:08 AM.
Report comment to moderator  
Reply With Quote
Unread 08/07/18, 03:32 AM  
Marazota
AddOn Author - Click to view AddOns

Forum posts: 257
File comments: 1517
Uploads: 2
ah i see, pages like this with empty downloads is against esoui rules, it can contain malicious codes and such, i will request admins to delete this page
Report comment to moderator  
Reply With Quote
Unread 08/07/18, 02:50 AM  
RavenMind
 
RavenMind's Avatar

Forum posts: 6
File comments: 391
Uploads: 0
Originally Posted by Marazota
so, ZOS banned author or smthing?
Not to my knowledge. That statement on Nexus didn't give me any reason to infer that he'd been banned.

All he did was prevent people from downloading the addon by "hiding" it. According to the comment, he feels he was treated poorly by ZOS and doesn't want to contribute work he feels benefits them.

Presumably he tried to do the same thing here, since the file download is just an empty .zip file. Perhaps ESOUI doesn't have a way to keep an addon page up while preventing download like Nexus does.
Last edited by RavenMind : 08/07/18 at 02:57 AM.
Report comment to moderator  
Reply With Quote
Unread 08/07/18, 12:06 AM  
Marazota
AddOn Author - Click to view AddOns

Forum posts: 257
File comments: 1517
Uploads: 2
so, ZOS banned author or smthing?
Report comment to moderator  
Reply With Quote
Unread 08/06/18, 09:05 PM  
RavenMind
 
RavenMind's Avatar

Forum posts: 6
File comments: 391
Uploads: 0
Yeah, that was in the first paragraph of my post below.
Report comment to moderator  
Reply With Quote
Unread 08/06/18, 06:11 AM  
Marazota
AddOn Author - Click to view AddOns

Forum posts: 257
File comments: 1517
Uploads: 2
Originally Posted by BigM
Downloaded from https://www.nexusmods.com/elderscrollsonline/mods/97 and it is working great. Thank you for keeping this addon working.
cant find that file

The reason given by the author is: I no longer wish to contribute work to Zenimax Online Studios' benefit considering how badly I feel I've been treated by them.
Report comment to moderator  
Reply With Quote
Unread 08/06/18, 04:48 AM  
RavenMind
 
RavenMind's Avatar

Forum posts: 6
File comments: 391
Uploads: 0
Well this addon looks great! It looks like exactly what I've been wanting for a long time now. I'm very sorry to see the author has decided to take a break. Though it looks like it may be more extended than posted in the addon description. Sadly, I tried to pick this up from Nexus, but it looks like it's been set to hidden with a comment from the author, "I no longer wish to contribute work to Zenimax Online Studios' benefit considering how badly I feel I've been treated by them."
It's especially sad considering his/her work is a contribution not to ZOS, but to all of us who play ESO. Sure ZOS benefits by having happier users who are more inclined to play the game because of wonderful addons like this, but ultimately we all are the beneficiaries of their time and effort.

Werewolf Finds Dragon, if you read this, I want you to know that people really do appreciate your work & your effort. I've been on Nexus for years, and what I've come to realize is that most of the people who comment on a mod are the ones complaining about this-or-that and want a quick/easy fix. I get the "entitlement" attitude, and it's so much more prevalent on the net. Another thing I've realized over the years is that these people are really a minority. The vast majority of people who have downloaded & use a mod never bother to comment or thank the author for their time and effort. It's sad, because as mod authors we love to hear when people are happy with our work, but happy user's lack of response makes us feel as though we're getting nothing but criticism. Often by people who obviously don't understand what we've done and why. I think this is why so many mod auths get burnout over a while, and wind up abandoning their mods, or the whole community/game. I've seen this happen a lot.
Well, just know that the number of people who think your work is great is probably vastly greater than the ones who are critical of it. Even though I just stumbled upon it & haven't had a chance to try it yet, I can tell you've put a lot of love into it and I really appreciate it. Hopefully you will come back to it, and the community who (albeit mostly silently) love the work you have done.
I wish you all the best!
Last edited by RavenMind : 08/06/18 at 04:49 AM.
Report comment to moderator  
Reply With Quote
Unread 05/27/18, 04:16 PM  
vecny.samotar
 
vecny.samotar's Avatar

Forum posts: 23
File comments: 552
Uploads: 0
when you have switched to other websites, would not you be alerted in update comments?
Report comment to moderator  
Reply With Quote
Unread 05/27/18, 03:45 PM  
BigM
 
BigM's Avatar

Forum posts: 16
File comments: 371
Uploads: 0
Downloaded from https://www.nexusmods.com/elderscrollsonline/mods/97 and it is working great. Thank you for keeping this addon working.
Report comment to moderator  
Reply With Quote
Unread 05/22/18, 11:50 AM  
BigM
 
BigM's Avatar

Forum posts: 16
File comments: 371
Uploads: 0
Sorry for the stupid trolls.

Just wanted to thank you for trying to deal with certain people on here. You did great on the addon and am sorry to see it left unattended, but I fully understand not wanting to deal with a few creeps.
Report comment to moderator  
Reply With Quote
Unread 05/06/18, 12:15 PM  
Asorcis

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

Werewolf Finds Dragon, your mods are great. People appreciate your effort. Maybe people are bad at saying it. You are 100% not obligated to do any of this, and you're obviously free to stop. I think it's great that you're acknowledging you need a break and allowing yourself to take it.

Originally Posted by LadyHyde
"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."
With that said, I agree completely with this comment and the quotes of yours that it contains. I'll tell you what I truly see in these comments: Mod users who aren't couching their comments in overly friendly language and are instead being direct about the problems they're seeing, and then I see you lashing out at them for it in an asymmetrical way. Not everyone here is out to get you. Sometimes people are just bad communicators.

This just doesn't need to be this dramatic for you if you don't want it to be. You have total control over how you react to things, and that's the only thing within your control. Good for you for taking one step toward that understanding. I hope you take several more steps in that direction, for your sake.
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: