---------------------------------------------- README for Furarchy Modular Proxy v.1.31.4 http://www.heroinpuppy.com/page?furnarchy ---------------------------------------------- USE AT YOUR OWN RISK. There's no reason why I shouldn't put a trojan in this. Chances are, you weren't forced into using this software, so don't blame me for your problems. That's what your parents are for. By running this software, you accept full responsibility for any negative repercussions that may come directly, or indirectly, as a result of running, installing, looking at, or even thinking about this program. This software is free, and you may distribute it at will. All I ask is that credit is given where credit is due. [TALK TO JAG. IT MAKES YOU POPULAR.] [TALK TO JAG. IT MAKES YOU POPULAR.] [TALK TO JAG. IT MAKES YOU POPULAR.] There used to be a list of people to thank here, but it was recently brought to my attention that they were all dead--with the exception of Rewsky, who, to this day, is still trying to get into Christina Ricci's jammie pants. Irreverently yours, Cluracan (OH YEAH, TRUCE ISN'T DEAD ANYMORE.) ======================================================================== FREQUENTLY ASKED QUESTIONS ======================================================================== Q: "Yeah, I have a question. What the hell is Furnarchy?" A: I'm glad you asked. Furnarchy is a modular proxy for Furcadia, and as far as I know, the first of its kind to be such. What do I mean by modular? Well, the proxy itself does practically nothing. Absolute Diddly-squat. It just draws and plays host to modules. The modules are the functionality. Generally, each one performs a focused task, e.g., extending the chat capabilities of Furcadia, hosting a buddy list, displaying free portraits, handling anti-idle. By dividing functionality among various modules, the end user benefits in a couple ways. First, you no longer need to download insanely large proxies complicated with excessive features. You can just pick what features you want your proxy to have. Effectively a custom-tailored proxy. Also, unless in special circumstances, an update in one module of the proxy doesn't require an update in the rest, reducing download size and headache. Installation and uninstallation of these said modules are also a delightful breeze (See Installing and Removing Modules). For further customization, Furnarchy is also somewhat skinnable. The GUI bitmaps are all available for tampering in the /gui folder of the Furnarchy directory. A brief (no, really) overview of skinning can be found at http://www.heroinpuppy.com/page?furnarchy_skins . Links to third-party skins can be found there, too. If you'd like to be featured on that page, just email me, post on the forums, or whatever! Q: "Where can I get it?" A: Currently, the link: http://www.heroinpuppy.com/page?furnarchy is always updated to have the most recent version of the proxy, as well as some first-party modules. Links to third-party modules should be buried somewhere in there, too. Q: "Okay. How do I install and remove modules manually?" A: First, find a module. Depending on the programmer, you may have to extract it from a zip, exe, or rar. Whatever. But you should end up with a .DLL file with the same name of the module, a thumbnail.bmp file, and any other, miscellaneous files arbitrary to that module. All you have to do, unless otherwise stated by the programmer, place all these files in a folder named the same as the module in the \modules folder of the Furnarchy directory. For example, a module named IEatFeet would be installed like so: | | | | | | IEatFeet.dll thumbnail.bmp miscellaneous.1 . . . Okay, that was obviously an excuse to make a pretty, ascii graph, but you get the idea, I hope. To delete a module, simply delete the folder it's in under /modules. (The IEatFeet Directory in the example). Q: "I ran the program. Now I have a stupid Icon on the top right of my Furcadia window." A: Good, then it's working. If you click on that icon, it will expand to reveal a list of all installed modules. If you click the icon again, it will minimize this menu. Q: "So now what?" Assuming you have the modules menu expanded, you should see a series of images and gray boxes to the right of them. Each pair represents a single module. As a rule of thumb, clicking on a module's image will bring up a settings/further info window. And clicking on the gray box next to it, making a check appear, will "activate," or turn on the module's functions. This way, you don't have to uninstall a module if you don't want to use its functions at that particular time. You can just turn it off, and back on later. Q: I installed the program and I don't get a stupid little icon in the top-right corner of my Furc window!! What the hell's up? A: Make sure that your furcadia executable is named "furcadia.exe" Q: "I added/deleted a module and it's not showing up in the modules menu!" A: Restart Furcadia! Q: "How do I get ignores to work with Furnarchy?" A: Furnarchy uses whatever ignore patterns it finds in the furn_ignores.txt file. To add more ignores from within the game, use the command "@ignore [pattern]". To remove an ignore from the list, use the command "@ignore [pattern]" again. To list what patterns you're currently ignoring, type "@list ignores". To disable ignores entirely, type "@ignore" by itself. To re-enable ignores, type "@ignore" by itself, again. Q: "Will you release the source code for Furnarchy?" A: Only if I love you dearly. Q: "Since it's modular, do you want other people to code modules for Furnarchy?" A: Brilliant observation. While Furnarchy itself is closed-source, the API by which modules interface with Furnarchy is not. You can find documentation (however incomplete) on the module API at http://www.heroinpuppy.com/page?furnarchy_moduleAPI Sometimes I'm too lazy to upload sample modules to the website, so you can view the latest ones here: http://www.heroinpuppy.com/software/furnarchy/files/ Q: "What if I find a bug?" A: Write your congressman. Then post it on the Furnarchy forums at http://www.heroinpuppy.com/forums/YaBB.cgi Guest posting is enabled. ======================================================================== REVISION HISTORY ======================================================================== 07-10-03 | July 10 2003 NEWS: - Everyone hates my clouds. NEW FEATURES: - iono BUG FIXES: - The length parameter of FH_HOOKEDRECV works now. KNOWN ISSUES: - ????//// ************************************************************************ I forgot to put in the date. :'( NEWS: - Jag reinstalled Giants. NEW FEATURES: - More attitude. BUG FIXES: - Dream names in the dream messages now properly null-terminated. KNOWN ISSUES: - Does anyone know if modules still come up dead when you turn on Furcadia on occasion? ************************************************************************ 04-02-03 | March 04 2003 NEWS: - Sarah is pregnant. We're organizing a lynch mob. NEW FEATURES: - If you play AC, give me everything you own, and everything you don't. BUG FIXES: - Ignores now case-insensitive. KNOWN ISSUES: - Does anyone know if modules still come up dead when you turn on Furcadia on occasion? ************************************************************************ 04-02-03 | March 04 2003 NEWS: - I'm every woman, it's all in me. NEW FEATURES: - Gray contact lenses. BUG FIXES: - Beekin badges cut off the last character in descs. KNOWN ISSUES: - Affordable healthcare coverage. ************************************************************************ 03-12-03 | March 12 2003 NEWS: - My phoneline: BNFFFPPFPSZZHZZHHFFFFFFZZ! NEW FEATURES: - Furnarchy now handles ignores for its modules by parsing the settings.ini file and implementing the new commands "@ignore [pattern]" "@ignore" and "@list ignores". Any ignored text will still be parsed and sent to the modules, but the *pbTakeRet will be set to true. Watch out for that! BUG FIXES: - ;) KNOWN ISSUES: - Classic Oedipal Complex. ************************************************************************ 03-04-03 | March 04 2003 NEWS: - Still want Nexus cash. NEW FEATURES: - ... BUG FIXES: - Whoops, you couldn't lie down in the last version. KNOWN ISSUES: - ... ************************************************************************ 03-04-03 | March 04 2003 NEWS: - Playing Nexus again. If anyone has $$ there, hand it over. NEW FEATURES: - Numpad works as it should. - New, sleeker API. BUG FIXES: - None found. KNOWN ISSUES: - My VCR keeps eating my tapes. ************************************************************************ 11-26-02 | November 26 2002 NEWS: - STILL JENNY FROM THE BLOCK. - Server is effing up! NEW FEATURES: - New, integrated nothing! BUG FIXES: - Not really a bug fix, but a tweak to cope with the effing up server. KNOWN ISSUES: - Stephanie's dendrophilia. ************************************************************************ 11-21-02 | November 21 2002 NEWS: - ELTON JOHN IS UNDER-APPRECIATED. NEW FEATURES: - ffos. BUG FIXES: - Killed some memory leaks in the update-scanner. Fixed the bug that hid the update notes. KNOWN ISSUES: - Stephanie's plushophilia. ************************************************************************ 11-20-02 | November 20 2002 NEWS: - I AM UNDER-APPRECIATED. NEW FEATURES: - The update-scanner doesn't crash now! BUG FIXES: - Fixed the update-scanner. KNOWN ISSUES: - Stephanie's Dissociative Identity Disorder. ************************************************************************ 11-14-02 | November 02 2002 NEWS: - wot u NEW FEATURES: - Furnarchy parses SUMMONREQUESTIN and JOINREQUESTIN messages now! BUG FIXES: - wot bugs KNOWN ISSUES: - Update checker crashes sometimes. :)))))))))) This bug's just for you, Burma!!!! <3<3 ************************************************************************ 11-02-02 | November 02 2002 NEWS: - Jason Mraz is hip. NEW FEATURES: - None. BUG FIXES: - Fixed some recursion bugs that seemed to cause spontaneous crashes. KNOWN ISSUES: - Update checker crashes when you're downloading updates and close it. ************************************************************************ 11-02-02 | November 02 2002 NEWS: - Cut the readme down! NEW FEATURES: - None. BUG FIXES: - Fixed a bug that was crashing the update checker. KNOWN ISSUES: - Update checker crashes when you're downloading updates and close it. ************************************************************************ 11-02-02 | November 02 2002 NEWS: - Getting even longer. NEW FEATURES: - Sped the messaging system up some. BUG FIXES: - No bugs last time! KNOWN ISSUES: - Looks good. ************************************************************************ 11-01-02 | November 01 2002 NEWS: - This file is getting long. NEW FEATURES: - parses ACTIONIN and ACTIONOUT now. - Update checker can download and install updates now. BUG FIXES: - No bugs last time! KNOWN ISSUES: - Looks good.