Junkyard Dog (tm) BETA NOTES (08 Apr 2003) CHANGE NOTICE 0.8.0.0 - Now JYD reads from the login packet to see if you are using Stretch UI or not. If you decide to switch Stretch UI on or off in the middle of playing without relogging... Relog! - Added two new settings: Timing Factor and Pyreal Limit, and implemented both (see below for details) - The Timing Factor is basically how long JYD will wait for certain packets before deciding that the function has failed. It is recommended that you leave it alone unless you are having problems. If you are on a laggy connection and get lots of fail messages, then increasing this value may help you. Or, if you think that JYD waits too long for packets to come back, and should declare them as failed sooner, feel free to lower the value. (10000 is default, time is in milliseconds) - Pyreal Limit is a way to filter JYD from salvaging items equal to or above a certain value in pyreals. Example: you pickup items from time to time worth 45,000 or more, and you don't want them salvaged. So you set Pyreal Limit to 45000 (no commas please!) and these items will no longer be salvaged. Leave at zero to leave this filtering function off. (0 is default) - I *think* I added support for 1280*960 resolution. The reason I say I think is because I don't have that resolution so I had to calculate values for 1280*960, but I have no way of knowing if they are correct. If you are running 1280*960 (not windowed mode though) and you have problems that you do not have at other resolutions, please email me (firilisun_son@pacbell.net) yeah, my email address changed... evil pacbell YOU MUST USE THE SETTINGS BUTTON TO CREATE A PROFILE FOR EACH CHARACTER OR JYD WILL DO NO SALVAGING AT ALL. DESCRIPTION Junkyard Dog (JYD) is a one-button, auto-salvaging plug-in for Asheron's Call (AC) via Decal. Each AC character can have individual settings to control which materials are salvaged and how the quality levels are grouped ("bins" or "quality pools"). Only items that are in the main pack/worn/wielded and are NOT inscribed and are NOT tinkered and are of material types of your choosing will be salvaged. These limitations are in-place to minimize the chances that desirable items will not be accidentally salvaged. Partial bags must be located in the main pack prior to the start of salvaging. Salvaging occurs basically one item at-a-time to maximize the amount returned from the salvaging process. Junkyard Dog requires control of the mouse and keyboard at different points in the salvaging process, so please do NOT use either item until the salvaging process is complete (we are pretty sure one consequence of moving the mouse during salvaging is the possible destruction of uber items - no this is not a joke - we are VERY serious about this one point). -I M P O R T A N T - I M P O R T A N T- INSCRIBE ALL ITEMS YOU WISH TO PROTECT FROM SALVAGING AS SOON AS THEY ARE IN YOUR INVENTORY. REMEMBER TO INSCRIBE EVERYTHING YOU ARE WEARING AND WIELDING. When you have done this on everything you wish to keep safe, go back and CHECK your inscriptions to make sure they are actually inscribed. Any inscription will do. Once Junkyard Dog starts running, there is no reliable way to prevent it from salvaging that uber item if it is one of the material types enabled in settings.xml, if it is in the main pack/worn/wielded, if it is not tinkered, and if it is not inscribed (all conditions must be TRUE for an item to be salvaged). If this is your first time using JYD, and you are inscribing precious items for the first time, I recommend that you log in and out after inscribing them to ensure the server updated has their inscribed status (once you know the server has changed their status you don't need to worry about that item ever again). This will prevent extremely rare cases of JYD eating inscribed items. Just letting you know. DO NOT MOVE THE MOUSE WHILE JYD IS SALVAGING. 3 tinkered/inscribed items have been lost due to suspected mouse movement (thousands of other items have been salvaged with no mistakes when the user did not move the mouse). SO DON'T MOVE IT!! BETA INSTALLATION INSTRUCTIONS (1) Run "Junkyard Dog.exe". (2) Use the browse feature in the installer to place Junkyard Dog into a folder other than the MS default for everything in the universe. (3) Start the Decal Agent. (4) Check the box beside Junkyard Dog to enable the plugin. (5) You must be running IMPfilter 2.8.0.8 (or later), MSXML4 (or later), and Decal 2.5.1 (or later). Update these if needed. (6) Close the Decal Agent and start-up AC normally. (7) Select Junkyard Dog on the Decal bar, then push the [Settings] button to create a setup for that character. Each character requires their own setup. The JYD UI should be self-evident. CURRENT STATUS (08 Apr 2003) (1) This is -expected- behavior (any deviation is a -bug-): ITEMS will be salvaged from the main pack only. BAGS will be salvaged from the main pack/worn/wielded only. INSCRIBED ITEMS, either items or bags, will not be salvaged regardless of location. ITEMS equal to or greater than Pyreal Limit will not be salvaged, UNLESS Pyreal Limit is 0 (meaning it's off). TINKERED ITEMS should be INSCRIBED to be protected (they should be safe, but in beta, safe is better than sorry). Items are salvaged one-at-a-time for maximum yield. (2) "settings.xml" controls the salvaging process (in the JYD directory). Users customize their own settings.xml though the JYD UI. You may wish to look at settings.xml to examine the example setup for Firilisun. Firilisun salvages all material types. Some materials are set up for graded quality pools (i.e. steel, iron, etc.): workmanship 1-4 inclusive is pooled into one "bin", Workmanship 5 and higher is binned individually (i.e. 5, 6, 7... all have separate "bins"). Some materials use one global quality pool (i.e. 1-10 are all lumped together). Note that multi-workmanship quality pools (bins) must be contiguous (i.e. 1/2/3/4 in a single bin is OK, 1/2/4 is NOT). Ill-formed pools or poorly edited settings.xml files will cause crashes. (3) Each character must have its own configuration in "settings.xml". The JYD UI will automatically create a JYD profile in settings.xml. Or you may use any XML editor or notepad to accomplish this (no, do not ask the creators of Junkyard Dog how to do this - we won't help your computer illiterate lameness out one little bit - if you don't know how to edit XML files you have no business editing this file). If you manually edit "settings.xml", the character's name must appear -exactly- as it is in-game. Names that include unusual alpha-numerics or punctuation -may- not be usable due to XML limitations. (4) The "STOP" button is able to stop JYD at two places. First after sorting and second between salvaging any two items. It CANNOT STOP salvaging once an item is in the ust (but this is so fast, you can't react in-time anyway). You know salvaging is stopped if you see a message in the chat window showing at least one dimension of the 3D window. It doesn't hurt to hit the STOP button multiple times. (5) Bowls, ewers, and other uninscribable items will not be salvaged at present. We intend to change this behavior. (6) If you intend to salvage items made of reedshark hide, there *must* be two entries under your character. One must be "Reedshark Hide" and the other "Reed Shark Hide". The same is true for "Smoky Quartz" and "Smokey Quartz". This is a Turbine inconsistency, which could be automatically addressed by JYD, but doing so slows JYD down rather noticeably. We removed the code which automatically addressed this and are instead requiring two entries for each of these materials. BUGS / QUESTIONS / COMMENTS / SUGGESTIONS email to - firilisun_son@pacbell.net Please include the log file for that day if you are reporting a bug. If you don't include the log file, the bug will probably not be fixed. And don't email us if your item got eaten and it wasn't inscribed, tinkered, or you even looked at your mouse (if it's your fault, we don't want to hear about it). Son_of_firilisun doesn't play the game and cannot/will not reimburse you for mistakes. Firilisun does, but he is heartless, cruel, and unsympathetic - so forget about reimbursement from him (and did we mention he hates archers? He does. Make sure your bow is NOT in your main pack! muahahaha!). Only email us if you think it was a bug (if it's our fault, we want to fix the bug, so email us). DISCLAIMER: Use Junkyard Dog at your own risk. The creators do slip-shod work and make no warranty of any kind with regard to any functionality or result. We especially don't like sucky archers (is there any other kind?), so if it eats your AR 166% bow, please contact us so that we may laugh cruelly at your loss. LEGAL STUFF: Junkyard Dog is a trademark (tm) of Carrell R. Killebrew, Jr.. The Junkyard Dog software is (c) 2003 by Carrell D. Killebrew, who also owns and retains all property rights. Asheron's Call and Decal are the trademarks and properties of other legal entities and the owners of Junkyard Dog assert no claim of any rights whatsoever with respect to those properties. Revision History: 0.7.2.0 - The basic JYD User Interface (UI) should now be completely functional. There is no longer any need to manually edit "settings.xml" for any reason. Please email firilisun_son@pacbell.net if the UI does not behave as you expected or with suggestions to improving the UI. 0.7.1.0 - ALL resolutions now supported. There are no resolution caps. Resolutions are verified only in full-screen mode. - The JYD window has LARGE TEXT telling you DO NOT MOVE THE MOUSE!!! during salvaging operations. Guess why... - Internal logic has been changed to improve performance, particularly in "busy" locations. Busy is not lag... - A second set of checks has been added for tinkering and inscribing, requiring a second set of packets. This is to reduce the chance that a single bad packet will allow an uber item to be zapped. This DOES slow down some phases of JYD. What the Dev giveth (see the preceding item), the Dev taketh away. 0.7.0.6 - Partial bags must be located in the main pack prior to the start of salvaging. (This, actually, was always the case; I just didn't know this earlier. I may fix this later, we'll see.) 0.7.0.0 - Stretch UI is now supported. Resolutions remain capped at 1280H by 768V and lower. - The STOP button now has some functionality - read item #5 under Current Status.