Minion Beta! - Help us test our new AddOn updater. Get it now!
Download
(17 Kb)
Download
Updated: 07-21-08 12:58 PM
Pictures
File Info
Updated:07-21-08 12:58 PM
Created:unknown
Downloads:8,434
Favorites:36
MD5:
Guild Inventory  Popular! (More than 5000 hits)
Version: 3.0.0
by: Wintry [More]
Guild Inventory is the solution to a guild banker's problems. It scans your guild bank character's bank (of which you may have multiple), and allows others in your guild to see its contents.

V3 - Now facilitates actual guild banks!

IMPORTANT: If nothing else, read the Initial Setup (either mass distribution or in-game) section, as it is crucial to the mod's operation!

Note: this also works for communities formed over several guilds. The difference is that bank data is "advertised" over raid, rather than guild messaging.


Data Transfer
Guild Inventory works by transferring data through (hidden) whispers, so it cannot be intercepted by unintended players. Every few seconds, Guild Inventory broadcasts the list of banks it has data for in the guild and raid (using the addon messages, so nobody will see anything even if they don't have the mod), and how recent the data is. Any other player with the addon that needs said bank data will ask for it, and if the password is correct, will receive it. No data is transmitted without being set up to be - e.g. your main character's inventory will never be sent unless you specifically set up the mod to do so.


Initial Setup - Mass Distribution
For the preferred distribution method, this mod requires an initial setup via modification of the GuildBanks.lua file with a standard text editor (although probably not Notepad, use Wordpad instead). The idea is that the guild or community leader will set the addon up with all the relevant bank details, and then upload it on to their website (or otherwise give it to all guild members).

In this file, you will find the following LUA function (approximately):
Code:
function GuildInventory_ResetCustom()
    GuildInventory_Banks = {};
    
    GuildInventory_Banks["Example1"] = {
            ["name"] = "Guild Bank: Example 1",
            ["content"] = {},
            ["password"] = "password",
            ["updated"] = 0;
        };
    GuildInventory_Banks["Example2"] = {
            ["name"] = "Guild Bank: Example 2",
            ["content"] = {},
            ["password"] = "password",
            ["updated"] = 0;
        };
    GuildInventory_Banks["Example3"] = {
            ["name"] = "Guild Bank: Example 3",
            ["content"] = {},
            ["password"] = "password",
            ["updated"] = 0;
        };
end
You can remove and add to these as you see fit, just don't change the "content" or "updated" fields. An example from my own guild would be:
Code:
    GuildInventory_Banks["Wizar"] = {
            ["name"] = "Guild: Books & Plans",
            ["content"] = {},
            ["password"] = "****",
            ["updated"] = 0;
        };
Where you see "Example1", that is the bank character's name. ["name"] refers to the name that appears on the list.

Initial Setup - In-game Method
If modification of the LUA file does not appeal to you, then you can use in-game commands to create, edit and remove banks from Guild Inventory. Note that for mass distribution throughout a guild, this method is a little more tedious, as everyone else has to do the same too. The main commands for this are:

/gi create bank <Bank Character>
/gi delete bank <Bank Character>
/gi password <Bank Character> <New Password>
/gi clear bank <Bank Character>

Each is self-explanatory. When a bank is created, it's password is defaulted to the character name of the bank character, but it is recommended you change it. From default settings, Guild Inventory has 3 example banks, which should be deleted first. These banks just serve as a convenience for the mass-distribution method, and are included for that reason. Keeping them in the system won't cause any harm, but they will still appear in the list, hence it is better to delete them.


Distribution
Re-package the files and upload them to your guild website or equivalent, and ask everyone in the guild to download it. Note that anyone that downloads that particular distribution of the mod will be able to read your guild bank's content if they are in a raid group with another in your guild, so restrict access to the download, or send it via other means. For version 1.5.0 and onwards, you should be able to just update from this site.

If everyone is willing to do the in-game setup, then you can just direct them to this site, but you'd have to tell them which banks to create and the passwords set for them. For small distributions, this may be more appropriate.


In-Game Operation
Once the intial setup is complete, in-game operation is straight-forward. All commands can be viewed with the '/gi help' command. For normal operation, log in to one of your guild bank characters. Open up the bank, and then type '/gi scan'. It will then perform a scan of all items in your inventory and bank, and load them in to memory. If another guild member is online (with the mod set up in the same way), then the guild bank's content will be automatically transferred to them. Repeat this process for any other banks.

You can type '/gi' or '/gi show' to view Guild Inventory, and all banks that were scanned, or content that was transmitted to you. Bank content data cascades through online players. Anyone with more up-to-date data will send it to those with out-dated data, so you end up with everyone having the latest guild bank information. Guild bank information is saved between sessions, and is not character-specific.

If you want to send a request for an item to the relevant bank, open up a mailbox, type '/gi' to show the Guild Inventory window, select the required bank, and double-click the item of desire.

Now there's a minimap icon! Currently, it's only functionality is left-click to open up Guild Inventory, but more features coming soon.


Sending Bank Details to Others - New Feature!
In version 1.2.0, you can send bank authentication details to other players, if they're using that version of the addon. You will only be able to send details to others in your guild or raid. To do so, type '/gi broadcast'. The rest is self-explanatory.


Upgrading
It is recommended that when you update the addon afer a major update, you perform a reset of all the data. Note that this will clear all banks, and restore the "factory" default settings. Type '/gi resetall' to do this. If you have custom settings in the GuildBanks.lua file, then it will load these instead.


Exporting
You can, as of 2.1.0, now export data from Guild Inventory. There are 3 supported formats; plain text, item tags, and url tags (linking to thottbot) for phpBB. To do so, type:
/gi export Mybank url
/gi export Mybank item
/gi export Mybank text

You can then copy the data using Ctrl-C, and paste it in to the browser window. Use '/gi export' (without parameters) to see the latest list of exportable formats.


Comments
Any comments would be greatly appreciated, especially if they further development. If needed, you can contact me (Wintry) in whispers or mail on Argent Dawn (EU). Don't forget to vote if you like it!


Version History
3.0.0
- Now supports actual guild banks. Commands such as '/gi create guildbank <Name of Guild>' allow you to do this. Please see '/gi help' for more commands. To scan a guild bank, open the guild bank, cycle through all tabs (this loads the data from the server), and then just type '/gi scan' as normal.
- Items now show their locations on hover-over, such as guild bank tabs.
- Due to these changes, 3.0.0 is incompatible with previous versions.

2.2.0
- Now compatible with WoW 2.1.
- Switched from whisper communication to "addon whisper" communication. This has the added benefit of not producing errors when your character is drunk, for starters.
- Due to this change, version 2.2.0 will not interface with Guild Inventory 2.1.0 or lower.
- Bank data will be automatically cleared on first addon load upon upgrading.

2.1.0
- Now has the capability to export data, using the /gi export command. See the section "Exporting" for more information.

2.0.0
- Major update - No longer compatible with pre-2.0.0 versions. Older versions won't fail to run, but they will not communicate with a 2.0+ version.
- Banks automatically cleared on first-load due to storage changes.
- No actual links are transmitted any more, so disconnects should not occur.
- Now you can Ctrl-Click an item to view it on yourself (if it can be worn).
- Shift-Clicking an item will copy the link in to the chat window.

1.8.3
- You can now close the Guild Inventory window with the escape key.

1.8.2
- Fixed a bug with transfers timing out (timeout wasn't resetting when items were received).

1.8.1
- Fixed a bug (caused by using an old version of ChatThrottleLib), bringing up error messages.

1.8.0 (Beta)
- I've now integrated ChatThrottleLib in to Guild Inventory in order to permanently solve the disconnection problem. However, this has not been fully-tested yet. You may use this version if you like, but I cannot guarantee it will work properly.

1.7.0
- Added two commands to show/hide the minimap icon, '/gi showminimap' and '/gi hideminimap'.
- Tripled the time inbetween data transfer elements. This may or may not fix the disconnect issue, but if it does, it's only a temporary fix.

1.6.1
- Seems I left some debug code in 1.5.1, which is now removed. Sorry about that!

1.6.0
- Added a minimap icon with functionality to open Guild Inventory (thanks Gello!)
- Once opened for the first time since login/reload, Guild Inventory will show a much smaller amount of boxes
- Guild Inventory window is now clipped to the screen. This also allows you to keep the window at a corner of the screen, for example, irrelevant of inventory size.

1.5.1
- Fixed a bug which caused the addon to crash when it encountered certain items.

1.5.0
- Now improved for distribution - default banks are in GuildBanks.lua, to be changed by guild leaders.
- Fixed a bug whereby if you were to transfer data to a person in AFK status, an AFK message would appear for every item transferred. (Should be fixed, but let me know if it isn't)

1.4.2
- Updated to work with WoW 2.0.3.

1.4.1
- Accidentally left debug mode on, fixed now

1.4.0
- Improved sorting order. Now arranges items (but will require a rescan/transfer to take effect) in the following order: Consumables, trade goods, reagents, recipes, miscellaneous, everything else (depending on categories assigned by Blizzard).

1.3.0
- Added a new command, '/gi movable' which toggles the movability of the panel, and removes the blackness.
- Guild bank contents now fits in to a smaller window, varying size by the quantity of stuff inside it.

1.2.0
- Added ability to send bank authentication details to others with the '/gi broadcast' command.

1.1.1
- Bug fix: sometimes when in a raid, broadcasts would not be made. This should be fixed.
- Bug fix: Punctured Voodoo Doll should no longer stack (will require a re-scan).
- The addon will no longer broadcast during combat, this is just to prevent possible lag.

1.1.0
- Improved command-line use, now no longer requires editing of the LUA (although is still recommended).
- When the Guild Inventory window is open, you can no longer control your character with the keyboard.
Post A Reply Comment Options
Unread 06-21-07, 02:47 AM  
tuxcl
A Kobold Labourer

Forum posts: 0
File comments: 1
Uploads: 0
new feature?

Hi,

first of all, thanks for this great addon my life as Banker is easier than before hehehe

I've been using guild inventory for a couple of weeks but now I have a request for a new feature. I don't know if it's possible or not but... is there a way to have or adding a value for all the stuff in the bank? I mean, something like DKP (not a real value in gold).

In my Guild there're a lot of new guildies, and there're many not like a ninja loot (if you know what I mean), but i think that having some kind of value of the things would help to avoid that.. also it can be a good way to give an incentive to donate stuff. so, the more you give the more you can take from the Bank.

what do you think? is it possible?

cheers!


(i hope that my english was not so bad )
tuxcl is offline Report comment to moderator  
Reply With Quote
Unread 06-03-07, 05:45 PM  
Wintry
A Fallenroot Satyr
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 44
Uploads: 6
Re: Having problems

Originally posted by Cre
I am not able to send the info to my guild with the new /gi broadcast. Can you please help?
Thanks
Do they all have the latest version of the addon?
Wintry is offline Report comment to moderator  
Reply With Quote
Unread 06-02-07, 01:30 PM  
Cre
A Kobold Labourer

Forum posts: 0
File comments: 3
Uploads: 0
Having problems

I am not able to send the info to my guild with the new /gi broadcast. Can you please help?
Thanks
Cre is offline Report comment to moderator  
Reply With Quote
Unread 05-29-07, 05:54 AM  
Wintry
A Fallenroot Satyr
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 44
Uploads: 6
Originally posted by kkarmaa
Hey im having problems with this addon. I just installed it into the right folders without the .lua file. I already have a guild bank but i trying to get it so that everyone in the guild can see its inventory. I'm on my guild bank and have the bank open and am typng /gi scan, but it says bnank doesnt exist. Can you pelase help.
What you have to do initially is create the bank for your bank character. This can be done with command '/gi create bank Winterbank', for example. Note that this is case sensitive, so '/gi create bank winterbank' would not work, so make sure it's your exact character name. The '/gi scan' command scans your bank and loads the data in to that character's bank profile, and can only be done after the bank is created.

In order for others in the guild (that have the addon) to see your bank, you must broadcast the details. To do this, type '/gi broadcast', and it will bring up a dialog. Select the bank, and then click the button to broadcast to your guild. The second drop-down list should (after a couple of seconds) show a list of others in your guild / current raid with the addon installed. If you choose to, you can broadcast the details to specific people only using this method.

Assuming all goes well - which it will if everything's set up correctly - other guild members will be able to see the contents of that bank within a minute or two.
Wintry is offline Report comment to moderator  
Reply With Quote
Unread 05-28-07, 01:08 PM  
kkarmaa
A Kobold Labourer

Forum posts: 0
File comments: 1
Uploads: 0
Hey im having problems with this addon. I just installed it into the right folders without the .lua file. I already have a guild bank but i trying to get it so that everyone in the guild can see its inventory. I'm on my guild bank and have the bank open and am typng /gi scan, but it says bnank doesnt exist. Can you pelase help.
kkarmaa is offline Report comment to moderator  
Reply With Quote
Unread 04-20-07, 08:28 PM  
Wintry
A Fallenroot Satyr
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 44
Uploads: 6
Re: Two simple questions

Originally posted by envied
My last final questions..
What is the best way to transfer things into the guild bank?
In the picture to the right it shows lots of spaces for guild items.. how do I create more boxes to hold stuff?
To transfer stuff in to the guild bank, you mail it

Assuming you didn't mean that, and you mean to update the contents of the bank, then just ask the bank character (or yourself, if you happen to own the bank), to open the bank, and type '/gi scan'. This will update the contents in Guild Inventory, and start the broadcasting process with other players.

As for the number of boxes, that was changed quite a few patches ago - the screenshot is actually old. It now resizes dynamically depending on how much stuff is inside the bank.
Wintry is offline Report comment to moderator  
Reply With Quote
Unread 04-20-07, 07:57 AM  
envied
A Kobold Labourer

Forum posts: 0
File comments: 2
Uploads: 0
Two simple questions

My last final questions..
What is the best way to transfer things into the guild bank?
In the picture to the right it shows lots of spaces for guild items.. how do I create more boxes to hold stuff?
envied is offline Report comment to moderator  
Reply With Quote
Unread 04-13-07, 04:04 AM  
Wintry
A Fallenroot Satyr
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 44
Uploads: 6
Re: newb

Originally posted by envied
Okay so I am a total newb when it comes to this addon. I installed it for my guild master, named the banks (they show up), & I have the three characters at the bank in Orgrimmar. The GM was on one of the bank characters and I gave him two plans to test it. He says they show up in the guild bank for him. I try to scan it and it says "Bank doesn't exist for 'character'" Even though I have the same setup as him. I don't know what I have done wrong? Also I don't really understand how to send and receive things from the bank inventory can anyone explain this further to me?
If I'm understanding correctly, this is the problem; a scan retrieves a list of all items in the bank & bags, it does *not* receive a list of items from other players. Assuming you're in the same guild, the list of items should be transferred to you within a few minutes (you'll know when it's happening). If it's not, double-check the bank settings are correct by telling the owner of the bank character to do a '/gi broadcast', and send the bank details to you (the broadcast does not transfer items, only the authentication for transfer, so wait a minute or two afterwards).
Wintry is offline Report comment to moderator  
Reply With Quote
Unread 04-12-07, 12:48 AM  
envied
A Kobold Labourer

Forum posts: 0
File comments: 2
Uploads: 0
newb

Okay so I am a total newb when it comes to this addon. I installed it for my guild master, named the banks (they show up), & I have the three characters at the bank in Orgrimmar. The GM was on one of the bank characters and I gave him two plans to test it. He says they show up in the guild bank for him. I try to scan it and it says "Bank doesn't exist for 'character'" Even though I have the same setup as him. I don't know what I have done wrong? Also I don't really understand how to send and receive things from the bank inventory can anyone explain this further to me?
envied is offline Report comment to moderator  
Reply With Quote
Unread 04-04-07, 11:23 AM  
Wintry
A Fallenroot Satyr
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 44
Uploads: 6
Re: Re: Major update to 2.0.0

Originally posted by chrull
Thanks for a great mod, i'm sure this will help administrating the guild bank alot easier.

Is there anyway to easily export this into text/BBcode or html? Or any plans of adding it?
Wish granted

Export formats currently supported are plain text, phpBB item tags (requires a phpBB addon), and phpBB url tags.
Wintry is offline Report comment to moderator  
Reply With Quote
Unread 03-29-07, 04:04 AM  
Wintry
A Fallenroot Satyr
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 44
Uploads: 6
Re: Unable to see Bank listed in GuildBanks.lua file

Originally posted by Matriarch
I have followed your instructions and edited the GuildBanks.lua file (which extracts to the World of Warcraft directory). I've deleted the example banks in the file, but this makes no changes ingame. All 3 example banks are still there and mine isn't. I'm pasting the content of the .lua cause it's a small file and you can see perhaps what's wrong.

Code:
-- Do not change this constant
GuildInventory_Custom = true;

function GuildInventory_ResetCustom()
	-- Add/remove banks from the list accordingly
	
	
	-- Example bank 1
	GuildInventory_Banks["Titanbank"] = {			-- Character name of the bank
			["name"] = "Titanbank",				-- Name that you'd like to use
			["content"] = {},					-- Do not modify
			["password"] = "thunder",			-- The password you'd like to use
			["updated"] = 0;					-- Do not modify
		};
end
Ensure that the GuildBanks.lua file is in the GuildInventory directory, and then in-game, do a "/gi resetall" command (the custom guild banks will only take effect when you do that, if you've already started the game without preconfiguration). Hope that helps.
Wintry is offline Report comment to moderator  
Reply With Quote
Unread 03-29-07, 01:41 AM  
Matriarch
A Kobold Labourer
 
Matriarch's Avatar

Forum posts: 0
File comments: 1
Uploads: 0
Unable to see Bank listed in GuildBanks.lua file

I have followed your instructions and edited the GuildBanks.lua file (which extracts to the World of Warcraft directory). I've deleted the example banks in the file, but this makes no changes ingame. All 3 example banks are still there and mine isn't. I'm pasting the content of the .lua cause it's a small file and you can see perhaps what's wrong.

Code:
-- Do not change this constant
GuildInventory_Custom = true;

function GuildInventory_ResetCustom()
	-- Add/remove banks from the list accordingly
	
	
	-- Example bank 1
	GuildInventory_Banks["Titanbank"] = {			-- Character name of the bank
			["name"] = "Titanbank",				-- Name that you'd like to use
			["content"] = {},					-- Do not modify
			["password"] = "thunder",			-- The password you'd like to use
			["updated"] = 0;					-- Do not modify
		};
end
__________________
Matriarch - Titan Commander www.titansofpantheon.com
Angeldiva - GM www.avatarsofpantheon.com
Last edited by Matriarch : 03-29-07 at 02:31 PM.
Matriarch is offline Report comment to moderator  
Reply With Quote
Unread 03-25-07, 06:20 PM  
Wintry
A Fallenroot Satyr
AddOn Author - Click to view AddOns

Forum posts: 28
File comments: 44
Uploads: 6
Re: Thanks for v 2.0.0

Originally posted by Lerbic
Thanks a lot for making v2 of this freat mod, the DC problem we had within our guild is now fixed

Thanks again

lerbic
Great! Glad the fix worked at least
Wintry is offline Report comment to moderator  
Reply With Quote
Unread 03-25-07, 01:49 PM  
Lerbic
A Defias Bandit

Forum posts: 3
File comments: 7
Uploads: 0
Thanks for v 2.0.0

Thanks a lot for making v2 of this freat mod, the DC problem we had within our guild is now fixed

Thanks again

lerbic
Lerbic is offline Report comment to moderator  
Reply With Quote
Unread 03-22-07, 10:48 AM  
chrull
A Defias Bandit

Forum posts: 3
File comments: 2
Uploads: 0
Re: Re: Re: Major update to 2.0.0

Originally posted by Wintry
Currently exporting is not a planned development, as Guild Inventory was primarily designed to avoid web-based approaches. However, I may add it in a future release (although there are no guarantees), as a copy-in-game/paste-on-forums feature. On the plus side, I don't think I have any other ideas I'd like to implement in Guild Inventory, so you will probably see a change like this within the next month - I will be on holiday soon though.
Thanks for the fast reply, and adding this would be nice indeed.

I just haven't decided yet wether to give everyone the ability to see what's in the bank or not. I also do most guild administration from work it would be nice to have a easy way of posting it on the forums.
chrull is offline Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: