Due to real life commitments, I am no longer able to support this addon.
If this addon is considered out of date please open ExcessiveWithdrawals.txt, from the ExcessiveWithdrawals install folder, in your text editor and update line 4's APIVersion number to the current number. (Please visit
http://wiki.esoui.com to obtain the "Current API Version".)
As long as there are no changes to the API functions used for this addon, this method should work for some time to come.
------------------------------------------------------------------------------
Excessive Withdrawals is a must-have for any guild with their bank open to guild members; it monitors deposits and withdrawals and will notify you if someone is abusing their guild bank privileges.
When you use
Excessive Withdrawals for the first time, after configuring the guild settings, there will be a momentary pause in the game while it builds the initial database. The database will retain a log of all deposits and withdrawals, from 10 days prior to the initial scan, that consists of the number of items deposited/withdrawn, value of these items and gold deposited/withdrawn. This way members in good standing will not get flagged needlessly, as the addon will "know" their deposit/withdrawal history.
Excessive Withdrawals utilizes the data gathered from
Master Merchant and/or
Tamriel Trade Centre to price the items deposited and withdrawn from the guild bank. If there is no price from either of these two addons, it will use the system price for those items. The addon will keep a grand total of deposits and a grand total of withdrawals, compare the two and will only notify you when the withdrawals exceeds the deposits.
When
Excessive Withdrawals has detected that a guild members has exceeded the number of withdrawals compared to deposits, a warning will appear in the chat window. It will continue checking all guild bank transactions while you are gaming and will notify you of any additional excessive withdrawals, as well as any previous notifications, in case you were busy at a previous time.
Once you have acted upon the warning, you can type a command that tells
Excessive Withdrawals to no longer notify you about these transactions until new withdrawals occur.
You can access
Excessive Withdrawals by going to Settings -> Addon Settings -> Excessive Withdrawals
or type in your chat window: /exwithdraw
------------------------------------------------------------------------------
How to manually install addons:
- Locate the "Elder Scrolls Online" folder in your Documents
For Windows: C:\Users\<username>\Documents\Elder Scrolls Online\<version>\
For Mac: ~/Documents/Elder Scrolls Online/<version>/
(replace <version> with the client you're using - "live" or "liveeu")
- You should find an AddOns folder, if you don't, create one.
- Extract the addon from the downloaded zip file into the AddOns folder.
- Log into the game, and on the character creation/selection screen you'll find the Addons menu. Enable your addons from there.
------------------------------------------------------------------------------
Guild Information- Guild: The guild that has the guild bank you'll be monitoring
- Exclude Guild Rank(s) #: The guild rank(s) to exclude, in the order they appear in the guild pane, and above, for any guild bank transaction warnings. 1 = Guild Master
For example: selecting #3 will exclude that rank as well as #1 and #2
- Ignore up to $: This is the amount of tolerance that you and/or your guild allows for the grand total of all transactions, deposits minus withdrawals, to reach before you receive a warning.
For example: setting 500 allows a value up to 500 gold to be withdrawn before you are notified. Anything greater than 500, 501 for instance, will trigger a warning.
- Monitor Guild: This will trigger the addon to build the initial database, after you have configured the guild above. You can use this at anytime to see any notifications that the addon has active, that you haven't disabled.
- List Disabled: This will list all usernames and guild bank total value, for gold/items deposited and withdrawn, that have their notifications disabled.
Automated Demotions (optional)- Ignore up to $: Once the amount withdrawn exceeds this amount the user will automatically be demoted, excludes the guild rank(s) specified above.
- New Guild Rank #: The guild rank that you would like to demote players to that exceed the above amount. This should be a rank that does not have guild bank withdrawal permissions.
Setting a rank of "10" will automatically default to your guild's lowest rank.
Member Management- Username, including @: This is the guild member's username that you would like to manage.
- Disable: This will disable all notifications for this user, until guild bank withdrawals are detected.
- History: View the guild member's guild bank history.
- Remove: This will remove the above username from the database for Excessive Withdrawals, until they make new guild bank transactions.
- Enable: This will enable all chat window notifications for this user.
Addon Settings- Scan Every ... minute(s): This allows you to change the duration of time between each scan and notification(s). Default is once every 10 minutes.
- Disable Warnings:This will disable the warning and/or error messages when pricing addons, Master Merchant and Tamriel Trade Centre, are not found and/or enabled.
- Reset All: This will reset and clear any and/or all guild data currently stored in " .. self.displayName .. ".*
- Reset Guild: This will clear all data for the currently selected guild.*
------------------------------------------------------------------------------
Slash Commands
To open the addon menu, type: /exwithdraw
/excessive history @USERNAME - View any user's guild bank history
/excessive ignore @USERNAME - Disable notifications for a user, automatically enabled when a withdrawal is detected
/excessive enable @USERNAME - Enable notifications for a user
/excessive remove @USERNAME - Remove, or reset, this user's guild bank history
/excessive history all - List users with disabled notifications, configured guild members only
/excessive reset GUILD_NUMBER - Reset a specific guild's history*, based on which guild number it is
/excessive reset history - Reset any and/or all store guild bank history*
* The guild bank's history is limited to 10 days, including today, and is only able to obtain information 9 days into the past. You will need to allow this addon to load and populate regularly within that timeframe in order to keep the information up-to-date.
------------------------------------------------------------------------------
How does Excessive Withdrawals work?
It scans your guild bank history while compiling the username, item, quantity and type of transaction (deposit or withdrawal). This information is then parsed into a user's record ("credit history" of sorts) and relies on
Master Merchant and/or
Tamriel Trade Centre data to get the average price for any items in the history. Once all of this information is gathered, it will check the withdrawals and compare that information to the deposits, while taking in to account the guild's allowance, and notify you via chat pane of any guild members that have excessive withdrawals.
What if I offer raffles that allow them to deposit the money into the guild bank?
Based on my experience, the whole purpose of the guild bank, raffles, auctions and things of that nature are to help the guild as a whole. This addon will not take in to account anything outside of basic guild bank transactions, whether they're items or gold being deposited and/or withdrawn.
Why did you create Excessive Withdrawals?
I am currently the guild master of a guild where we have a very lenient policy and allow quite a few of our members to have open access to the guild bank. On occasion we have had instances, where it has appeared that someone has been withdrawing a little bit too much, but they really weren't, and other times that players were seriously abusing the system without being noticed quickly. This addon will remove the guess work from both and will allow my officers and myself to enjoy the game without spending too much time policing things.