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 01/28/19, 06:02 AM  
RavenMind
 
RavenMind's Avatar

Forum posts: 6
File comments: 391
Uploads: 0
Originally Posted by SlippyCheeze
Honestly, it isn't very hard at all to collect the data into an addon. I do 80 percent of it in my "Read It Once" addon, as part of validating my assumptions about how (un)changing book content is. You can certainly read that, and use it, as you please -- MIT licensed, so the code is free for your use as you wish, under fairly liberal terms. (Though, uh, please do respect the terms of the license.)
I'd just like to thank you for making your code available to us. Although I don't have the knowledge/skill required to put it to use, I'm sure that there are others who do. Making that available to use and learn from really helps us as a community. Cheers!
Report comment to moderator  
Reply With Quote
Unread 08/24/18, 03:29 PM  
SlippyCheeze
AddOn Author - Click to view AddOns

Forum posts: 53
File comments: 272
Uploads: 1
Yeah; if y'all do hit Librarian again, you might consider updating it to use the unique book ID (integer, as far as I can tell) rather than title for indexing. That'd require updating the saved vars, and either losing old content, or cross-referencing it, but it'd work...
Report comment to moderator  
Reply With Quote
Unread 08/24/18, 02:14 PM  
hawkeye1889

Forum posts: 22
File comments: 59
Uploads: 0
Originally Posted by vecny.samotar
Originally Posted by SlippyCheeze
Originally Posted by hawkeye1889
Originally Posted by vecny.samotar
i have a version of APIVersion: 100023 which I downloaded from nexusmods.com while it is downloaded from this site and it still works, I could somewhere clamped and in the comments of data download link but i do not know i would not disrupt the
i found a debug version in the comments but not an actual working version of the addon itself if someone could upload a version of this addon it would be great
The author of the addon made a deliberate decision to withdraw the addon from the world. Ignoring their wishes and republishing it would be ... well, the very best case is simply extremely rude, the worst case is breaking the law, and all.

Honestly, it isn't very hard at all to collect the data into an addon. I do 80 percent of it in my "Read It Once" addon, as part of validating my assumptions about how (un)changing book content is. You can certainly read that, and use it, as you please -- MIT licensed, so the code is free for your use as you wish, under fairly liberal terms. (Though, uh, please do respect the terms of the license.)


Building the UI isn't all that difficult either. I'd encourage you, instead, to focus on building a tool to replace this, rather than trying desperately to ignore the authors wishes.
Originally Posted by ovinnik
Originally Posted by hawkeye1889
Is it still possible to download this? the zip file is empty
Even if you receive a copy via PM (hosting this anywhere would indeed be all kinds of problematic), what's the point? It's rather obvious that this addon won't be maintained any further. Looks like you'd be better off switching back to Librarian. There are updates for it in its comment section.
I'm aware of ignoring the addon's wishes about the end of publishing an addon and so I did not use it and I did not give a link to the comments just to write an offer to provide an addon. what the author's wish to download is an addon according to comments I citalate both here and especially in the add-ons librarian book manager which was the forerunner of the Pocket Apocrypha addon I understand the decision of the author about the end was influenced by the deceiving of the people, more precisely after the case was disgusted by the right people it

what about returning to the Librarian Book Manager addon that was abandoned because of the fact that it had bugs and therefore was released an addon Pocket Apocrypha which was completely refurbished
I'll take another look at librarian it may not be ideal but its better than nothing
Report comment to moderator  
Reply With Quote
Unread 08/24/18, 12:51 PM  
vecny.samotar
 
vecny.samotar's Avatar

Forum posts: 23
File comments: 552
Uploads: 0
Originally Posted by SlippyCheeze
Originally Posted by hawkeye1889
Originally Posted by vecny.samotar
i have a version of APIVersion: 100023 which I downloaded from nexusmods.com while it is downloaded from this site and it still works, I could somewhere clamped and in the comments of data download link but i do not know i would not disrupt the
i found a debug version in the comments but not an actual working version of the addon itself if someone could upload a version of this addon it would be great
The author of the addon made a deliberate decision to withdraw the addon from the world. Ignoring their wishes and republishing it would be ... well, the very best case is simply extremely rude, the worst case is breaking the law, and all.

Honestly, it isn't very hard at all to collect the data into an addon. I do 80 percent of it in my "Read It Once" addon, as part of validating my assumptions about how (un)changing book content is. You can certainly read that, and use it, as you please -- MIT licensed, so the code is free for your use as you wish, under fairly liberal terms. (Though, uh, please do respect the terms of the license.)


Building the UI isn't all that difficult either. I'd encourage you, instead, to focus on building a tool to replace this, rather than trying desperately to ignore the authors wishes.
Originally Posted by ovinnik
Originally Posted by hawkeye1889
Is it still possible to download this? the zip file is empty
Even if you receive a copy via PM (hosting this anywhere would indeed be all kinds of problematic), what's the point? It's rather obvious that this addon won't be maintained any further. Looks like you'd be better off switching back to Librarian. There are updates for it in its comment section.
I'm aware of ignoring the addon's wishes about the end of publishing an addon and so I did not use it and I did not give a link to the comments just to write an offer to provide an addon. what the author's wish to download is an addon according to comments I citalate both here and especially in the add-ons librarian book manager which was the forerunner of the Pocket Apocrypha addon I understand the decision of the author about the end was influenced by the deceiving of the people, more precisely after the case was disgusted by the right people it

what about returning to the Librarian Book Manager addon that was abandoned because of the fact that it had bugs and therefore was released an addon Pocket Apocrypha which was completely refurbished
Report comment to moderator  
Reply With Quote
Unread 08/24/18, 12:31 AM  
ovinnik

Forum posts: 21
File comments: 80
Uploads: 0
Re: any way to get a working version of this?

Originally Posted by hawkeye1889
Is it still possible to download this? the zip file is empty
Even if you receive a copy via PM (hosting this anywhere would indeed be all kinds of problematic), what's the point? It's rather obvious that this addon won't be maintained any further. Looks like you'd be better off switching back to Librarian. There are updates for it in its comment section.
Report comment to moderator  
Reply With Quote
Unread 08/23/18, 08:41 PM  
SlippyCheeze
AddOn Author - Click to view AddOns

Forum posts: 53
File comments: 272
Uploads: 1
Originally Posted by hawkeye1889
Originally Posted by vecny.samotar
i have a version of APIVersion: 100023 which I downloaded from nexusmods.com while it is downloaded from this site and it still works, I could somewhere clamped and in the comments of data download link but i do not know i would not disrupt the
i found a debug version in the comments but not an actual working version of the addon itself if someone could upload a version of this addon it would be great
The author of the addon made a deliberate decision to withdraw the addon from the world. Ignoring their wishes and republishing it would be ... well, the very best case is simply extremely rude, the worst case is breaking the law, and all.

Honestly, it isn't very hard at all to collect the data into an addon. I do 80 percent of it in my "Read It Once" addon, as part of validating my assumptions about how (un)changing book content is. You can certainly read that, and use it, as you please -- MIT licensed, so the code is free for your use as you wish, under fairly liberal terms. (Though, uh, please do respect the terms of the license.)


Building the UI isn't all that difficult either. I'd encourage you, instead, to focus on building a tool to replace this, rather than trying desperately to ignore the authors wishes.
Report comment to moderator  
Reply With Quote
Unread 08/23/18, 06:31 PM  
hawkeye1889

Forum posts: 22
File comments: 59
Uploads: 0
Originally Posted by vecny.samotar
i have a version of APIVersion: 100023 which I downloaded from nexusmods.com while it is downloaded from this site and it still works, I could somewhere clamped and in the comments of data download link but i do not know i would not disrupt the
i found a debug version in the comments but not an actual working version of the addon itself if someone could upload a version of this addon it would be great
Report comment to moderator  
Reply With Quote
Unread 08/23/18, 10:12 AM  
vecny.samotar
 
vecny.samotar's Avatar

Forum posts: 23
File comments: 552
Uploads: 0
i have a version of APIVersion: 100023 which I downloaded from nexusmods.com while it is downloaded from this site and it still works, I could somewhere clamped and in the comments of data download link but i do not know i would not disrupt the
Report comment to moderator  
Reply With Quote
Unread 08/23/18, 12:01 AM  
hawkeye1889

Forum posts: 22
File comments: 59
Uploads: 0
any way to get a working version of this?

Is it still possible to download this? the zip file is empty
Report comment to moderator  
Reply With Quote
Unread 08/20/18, 10:06 PM  
Demonia

Forum posts: 0
File comments: 2
Uploads: 0
well i just fixed it as all show before, but in game when i open a book, UI freezes and stop working. It happened before i fixed in .lua file
Report comment to moderator  
Reply With Quote
Unread 08/18/18, 12:49 PM  
BigM
 
BigM's Avatar

Forum posts: 16
File comments: 371
Uploads: 0
Thank You, yep was my mistake.
Report comment to moderator  
Reply With Quote
Unread 08/18/18, 12:34 PM  
profcinders

Forum posts: 2
File comments: 2
Uploads: 0
Originally Posted by BigM
Get this error after applying fix.

user:/AddOns/PocketApocrypha/Components/Core.lua:194: } expected (to close { at line 188) near '='
You might have accidentally deleted the following line maybe? The whole code block around it (lines 187 to 210) should look like this:

Code:
LORE_READER.PCKeybindStripDescriptor = {
    {
        alignment                    = KEYBIND_STRIP_ALIGN_CENTER,
        name                         = GetString(SI_LORE_READER_TURN_PAGES),
        keybind                      = "CUSTOM_LORE_READER",
        callback                     = function() end,
        customKeybindControl         = LORE_READER.control:GetNamedChild("KeyStripMouseButtons"),
        visible                      = function() return LORE_READER.maxPageGroupings > 1 end,
    },

    {
        alignment                    = KEYBIND_STRIP_ALIGN_LEFT,
        name                         = self.SetUnreadName,
        keybind                      = "UI_SHORTCUT_SECONDARY",
        callback                     = self.UnreadCallback
    },

    {
        name                         = GetString(SI_EXIT_BUTTON),
        keybind                      = "UI_SHORTCUT_EXIT",
        order                        = -10000,
        callback                     = self.ExitCallback
    }
}
Last edited by profcinders : 08/19/18 at 02:39 AM.
Report comment to moderator  
Reply With Quote
Unread 08/18/18, 12:18 PM  
BigM
 
BigM's Avatar

Forum posts: 16
File comments: 371
Uploads: 0
Get this error after applying fix.

user:/AddOns/PocketApocrypha/Components/Core.lua:194: } expected (to close { at line 188) near '='
Report comment to moderator  
Reply With Quote
Unread 08/18/18, 08:01 AM  
profcinders

Forum posts: 2
File comments: 2
Uploads: 0
This fixed it for me:

Change line 194 of Components/Core.lua from:
visible = function() return LORE_READER.maxPages > 1 end,

To:
visible = function() return LORE_READER.maxPageGroupings > 1 end,

Looks like they changed a variable name in the last ESO update.

If you're seeing any other errors, post it here and I'm sure someone can look into it, if not me.
Last edited by profcinders : 08/18/18 at 08:04 AM.
Report comment to moderator  
Reply With Quote
Unread 08/18/18, 04:26 AM  
BigM
 
BigM's Avatar

Forum posts: 16
File comments: 371
Uploads: 0
For me, that fix didn't help.

I hope someone takes this add-on up like the author that fixed No Thank You add-on.

Yet, am just happy SlippyCheeze fixed Thank You so I can run through not having every book open for me.

Yet, it was nice at times to stop and read some of the books saved in Pocket Apocrypha, or the original Librarian.
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: