Quantcast
Download
(13 Kb)
Download
Updated: 12/21/20 06:11 PM
Pictures
File Info
Compatibility:
Markarth (6.2.5)
Updated:12/21/20 06:11 PM
Created:05/27/20 03:27 PM
Monthly downloads:135
Total downloads:1,556
Favorites:4
MD5:
6.2.5
Auto Ranks
Version: 2.4.8
by: peniku8 [More]
A must have for every trade guild admin:
Auto Ranks does exactly what its name suggests: it adjusts guild member ranks depending on their sales and or donations. Okay, it's semi-auto, you have to trigger it manually (button in the settings or via hotkey). Highly customizable.



Auto Ranks's Features:

Main functions:
- Promote and or demote guild members based on their MM or ATT sales
- Promote and or demote guild members based on their donations (requires Shissu's History Manager)
- Promote new members to the next rank after a set amount of days
- Send automated mails on certain actions
- Process all of your guilds at once with different settings for each
- Preset manager: Create unlimited settings presets (names are compatible with colour codes)
Functions & Features:
Rank allocation:
- Independently customizable time frames for sales and donations
- Automatically excludes ranks and members with administrative guild permissions
- Option to exclude members with a note on their name
- Option to specify a keyword to search for in the note
- Chat notifications for every action (optional)
- New member rank option: don't demote anybody back to the lowest rank in the guild
- Permanent rank: option to not demote anybody FROM the highest non administrative rank in your guild
- Track last donation: calculates a "this week" donation from the last donation in the logs
(- The current week donation will be calculated with the foruma: 7/DaysAgo * donation; Example: 20k donation 14 days ago->current donation=10k)
- Demotion limit: Specify an upper limit for how many ranks you want to demote a member at once

Message settings:
- Two messages can be configured for scenario LowestRank->2ndLowest and AnyRank->2ndLowest
- Include keywords to insert the recipient's actual sales and donation stats into the message
- Note: message text and settings are not part of presets

Addon Behaviour:
- When both MM and ATT are active, MM stats are prefered. When neither is, an error message is shown.
- When a new preset is created, it is automatically loaded as well
- When a preset is loaded, changes will save automatically to the active preset
- When a preset is deleted, the first preset in the list will be loaded
- The addon handles one rank change every two seconds
- The sales and donation stats added to the messages will be in the respective time frames for the rank options

- More info on how to fill in the numbers is given via tooltips
- You need to reload your UI to update the message previews (limitation of libAddonMenu)
- Pictures here show how I have it set up for my guild Pact Veteran Trade as guideline
- I'd advise to reset your addon settings when you 1)Change the order of your guilds or 2)Change the language of your client
Dependencies:
-LibAddonMenu-2.0
-ShissuHistoryScanner (Part of "Shissu Guild Tools")
-Master Merchant (v2 and v3 both work atm) or Arkadius' Trade Tools
2.4.8
-Added the "Demotion Limit" option, which makes it possible to limit the number of demotions a single member can get at once
-Added a refresh routine for presets. Presets need to be re-written when there is a new option added to AutoRanks, which requires reloading the UI once, when a preset is loaded the first time after the AR update was installed
-Regrouped some settings in a new submenu

2.4.7
-Added the function to specify a keyword for the 'Ignore members with a note' option

2.4.6
-Added message previews to the settings menu (you need to reload your UI for those to update)

2.4.5
-Added a safety net to prevent errors when multiple people activate AutoRanks for the same guild at the same time

2.4.4
-Fixed the German translation and improved it a bit

2.4.3
-Added German translation

2.4.2
-Added strings for localization

2.4.1
-Minor bugfixes

2.4.0
-Added a dynamic messaging function
-Added a button to remove presets
-Re-ordered the settings panel a bit

2.3.1
-Optimized the preset manager
-Added chat indications on which preset is currently active

2.3.0
-Added the preset manager, so you can use mutliple addon configurations on the fly

2.2.5
-API bump for Markarth

2.2.4
-Now ignores recruits with a membership time longer than 3 times the 'Rank period' setting, to avoid false promotions when a player joins, who has been in the guild before (SGT needs a few minutes to update the data, so Auto Ranks thinks the new member has been in the guild for a long time already)

2.2.3
-Code optimization

2.2.2
-API bump

2.2
-Added the "[New member] rank period" option
-Changed the way the "New member rank" checkbox is saved. Double check your settings!

2.1.2
-Code optimization

2.1
-Under the hood changes and improvements

2.0
-Public release
Archived Files (16)
File Name
Version
Size
Uploader
Date
2.4.7
12kB
peniku8
12/08/20 05:37 PM
2.4.6
12kB
peniku8
12/06/20 10:12 AM
2.4.5
12kB
peniku8
11/27/20 04:26 PM
2.4.4
12kB
peniku8
11/22/20 05:29 PM
2.4.3
12kB
peniku8
11/20/20 08:22 AM
2.4.1
8kB
peniku8
11/16/20 05:17 PM
2.3.1
7kB
peniku8
11/13/20 01:53 PM
2.3.1
7kB
peniku8
11/11/20 08:54 PM
2.2.5
6kB
peniku8
11/03/20 06:39 AM
2.2.4
6kB
peniku8
09/04/20 04:14 AM
2.2.3
6kB
peniku8
09/01/20 06:06 PM
2.2.2
6kB
peniku8
08/30/20 04:45 PM
2.2
6kB
peniku8
08/09/20 01:34 PM
2.1.2
6kB
peniku8
07/06/20 05:27 AM
2.1
6kB
peniku8
07/02/20 02:16 PM
2.0
6kB
peniku8
05/27/20 03:39 PM


Post A Reply Comment Options
Unread 01/04/21, 03:57 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 28
Uploads: 7
Originally Posted by marneman
Originally Posted by peniku8
Originally Posted by marneman
It would be really awesome to be able to add in some criteria around how "active" a guild member has been. For example: Promote to this rank if they've been a member for at least 30 days, but also have logged in within the past 2 weeks.
I have no intention of adding any features which take 'activity' into account as you describe it.
The addon is made for trade guilds and such a function is hardly useful in that case.
I understand. The challenge here is that a great number of guilds are social only in their focus. So the trading activity really doesn't factor in at all. Social guilds generally don't even have a trader.

I will take a look and see about adding that sort of criteria myself. Are you open to pull requests?
Feel free to write an addon which ranks people based on their activity. AutoRanks however will stay a ranking addon for trade guilds only.
__________________
Guild Master of "Pact Veteran Trade" and "Pact Veteran Trade II" - Author of "Auto Ranks", "Auto Recruit", "Automate" and others
Report comment to moderator  
Reply With Quote
Unread 01/04/21, 08:35 AM  
marneman

Forum posts: 0
File comments: 57
Uploads: 0
Originally Posted by peniku8
Originally Posted by marneman
It would be really awesome to be able to add in some criteria around how "active" a guild member has been. For example: Promote to this rank if they've been a member for at least 30 days, but also have logged in within the past 2 weeks.
I have no intention of adding any features which take 'activity' into account as you describe it.
The addon is made for trade guilds and such a function is hardly useful in that case.
I understand. The challenge here is that a great number of guilds are social only in their focus. So the trading activity really doesn't factor in at all. Social guilds generally don't even have a trader.

I will take a look and see about adding that sort of criteria myself. Are you open to pull requests?
Report comment to moderator  
Reply With Quote
Unread 12/21/20, 06:18 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 28
Uploads: 7
Originally Posted by marneman
It would be really awesome to be able to add in some criteria around how "active" a guild member has been. For example: Promote to this rank if they've been a member for at least 30 days, but also have logged in within the past 2 weeks.
I have no intention of adding any features which take 'activity' into account as you describe it.
The addon is made for trade guilds and such a function is hardly useful in that case.
__________________
Guild Master of "Pact Veteran Trade" and "Pact Veteran Trade II" - Author of "Auto Ranks", "Auto Recruit", "Automate" and others
Report comment to moderator  
Reply With Quote
Unread 12/21/20, 05:26 PM  
marneman

Forum posts: 0
File comments: 57
Uploads: 0
It would be really awesome to be able to add in some criteria around how "active" a guild member has been. For example: Promote to this rank if they've been a member for at least 30 days, but also have logged in within the past 2 weeks.
Report comment to moderator  
Reply With Quote
Unread 12/09/20, 07:46 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 28
Uploads: 7
Originally Posted by Sharlikran
Well that response was actually better than I thought it was going to be. It also helps clarify something that's been confusing me since you started mentioning this and because there are a few other people asking me the same type of question.

The reason you're only getting the time range that you feel is hard-coded is because you're looking through the table created for one of the nine time ranges. You're not looping over 200,000 or 2.6 million records.

I'm changing the SavedVariables files so that they are smaller and take less time loading the memory. I'm not changing the lookup tables that are created after everything is initialized.
So the variable I use to retrieve the data will still be the same after the update since the LUTs will keep their structure and no update from my side will be required?
__________________
Guild Master of "Pact Veteran Trade" and "Pact Veteran Trade II" - Author of "Auto Ranks", "Auto Recruit", "Automate" and others
Report comment to moderator  
Reply With Quote
Unread 12/09/20, 03:00 PM  
Sharlikran
 
Sharlikran's Avatar
AddOn Author - Click to view AddOns

Forum posts: 183
File comments: 944
Uploads: 9
Well that response was actually better than I thought it was going to be. It also helps clarify something that's been confusing me since you started mentioning this and because there are a few other people asking me the same type of question.

The reason you're only getting the time range that you feel is hard-coded is because you're looking through the table created for one of the nine time ranges. You're not looping over 200,000 or 2.6 million records.

I'm changing the SavedVariables files so that they are smaller and take less time loading the memory. I'm not changing the lookup tables that are created after everything is initialized.
__________________
Admin for TES5Edit, occasional LOOT masterlist contributor, and Wrye Bash contributor. I also maintain special Fallout 3 and Fallout NV versions of Wrye Flash.
Last edited by Sharlikran : 12/09/20 at 03:02 PM.
Report comment to moderator  
Reply With Quote
Unread 12/09/20, 08:41 AM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 28
Uploads: 7
Originally Posted by Sharlikran
Once this is done there will be no way to specify time frames for MM and obtain any data. You will simply need to create your own time. Meaning you get the current time from the ESO API and then subtract what you want. For example, if you want 7 days of data then you need GetTimeStamp() and then do the math in seconds for whatever 7 days is. If you want 7 days from the kiosk flip then you need to use GetGuildKioskCycleTimes() which returns the "upcoming" or next flip. It is best to subtract 7 days in seconds form that and then determine what you want form there.
Yea that's how ATT does it, this is easier for me to work with, since I can specify exactly what I want to retrieve.
Please keep me updated when this new release will drop and how I can retrieve sales then, so I know what to replace
Code:
MMsales = MasterMerchant.guildSales[GuildName].sellers[userId].sales[MMtimeframe]
with.
After the update, would I be requesting sales from MM still or can I do that in LibGuildHistory directly? I've spoken to sirinsidator and he said that he'd be releasing an update with similar functions, but I'd prefer to work with cached values, as iterating over all sales data every time would be too resource intensive I guess.
__________________
Guild Master of "Pact Veteran Trade" and "Pact Veteran Trade II" - Author of "Auto Ranks", "Auto Recruit", "Automate" and others
Report comment to moderator  
Reply With Quote
Unread 12/08/20, 09:45 PM  
Sharlikran
 
Sharlikran's Avatar
AddOn Author - Click to view AddOns

Forum posts: 183
File comments: 944
Uploads: 9
Originally Posted by peniku8
whether I could request custom sales time frames from MM which are not specified in MM itself.
No this is not a feature because the time is meant to be chosen by the dropdown. When that happens the information is iterated over to display the proper amount. Since MM is not a library there are no external features to request data.

All data will be moved to LibGuildStore when completed. The library is MM specific and not intended to be used as a way to collect data for other sources. The format will change and it will no longer contain the names of the guilds, the buyer, the seller, or the itemLink in the sale. These common strings will be in other tables.

You will still be able to iterate over the data from each saved vars file and I will be providing a way to use the index to get the string for the buyer, seller, guild name, and the itemLink. The data can still be obtained. As I mentioned the format would change eventually and this will reduce the file size dramatically.

Once this is done there will be no way to specify time frames for MM and obtain any data. You will simply need to create your own time. Meaning you get the current time from the ESO API and then subtract what you want. For example, if you want 7 days of data then you need GetTimeStamp() and then do the math in seconds for whatever 7 days is. If you want 7 days from the kiosk flip then you need to use GetGuildKioskCycleTimes() which returns the "upcoming" or next flip. It is best to subtract 7 days in seconds form that and then determine what you want form there.

The reason you feel normal time or a custom time is not possible is because you are relying on MM to provide the time frame. It has always been possible for you to specify any time you choose. You simply need to create the epoch time like the game does because that's how it stores all time for everything.
__________________
Admin for TES5Edit, occasional LOOT masterlist contributor, and Wrye Bash contributor. I also maintain special Fallout 3 and Fallout NV versions of Wrye Flash.
Last edited by Sharlikran : 12/08/20 at 09:47 PM.
Report comment to moderator  
Reply With Quote
Unread 12/08/20, 05:38 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 28
Uploads: 7
Originally Posted by wolfstar
I'm really liking this addon, but I had a request. I see you have rank change immunity for people that have a member note. Can this be adjusted to look for a keyword in the member note? I have that turned off right now because about half of my guild has notes and I don't want them skipped, but there are inevitably some members of that population that don't need to be promoted yet and I have to go back and revert the change. I'm glad the changes get printed to chat to make that easier, but I don't want to go through it every time I do promotions.
Done. Update your addon
__________________
Guild Master of "Pact Veteran Trade" and "Pact Veteran Trade II" - Author of "Auto Ranks", "Auto Recruit", "Automate" and others
Report comment to moderator  
Reply With Quote
Unread 12/08/20, 03:59 PM  
wolfstar

Forum posts: 0
File comments: 196
Uploads: 0
I'm really liking this addon, but I had a request. I see you have rank change immunity for people that have a member note. Can this be adjusted to look for a keyword in the member note? I have that turned off right now because about half of my guild has notes and I don't want them skipped, but there are inevitably some members of that population that don't need to be promoted yet and I have to go back and revert the change. I'm glad the changes get printed to chat to make that easier, but I don't want to go through it every time I do promotions.
Report comment to moderator  
Reply With Quote
Unread 11/26/20, 06:10 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 28
Uploads: 7
Originally Posted by Sharlikran
Just a note, MM already exports sales, taxes, and guild rank to a table. If all you need from MM is the sales totals and ranks then parse the table saved in the saved vars file. A GM would have to do a few steps but it would be simple and easy to export without trying to read MM saved vars. The format is in my documentation.

You don't specify the time as an argument, you select that on the guild roster page, and choose the time frame from the drop down menu prior to exporting the sales. The GM could export whatever they needed that way.
I am aware of the export function in MM, but it's not useful for AutoRanks.
My addon iterates over guild members, whether they can be promoted or not. It's a one button process, once it's set up and it will check every member's sales, possibly with varying time frames for each guild, and promote the member to a respective rank, if he meets the requirements. It automates guild management for GMs and officers. My question was about the time frame itself, whether I could request custom sales time frames from MM which are not specified in MM itself.
Report comment to moderator  
Reply With Quote
Unread 11/24/20, 08:06 PM  
Sharlikran
 
Sharlikran's Avatar
AddOn Author - Click to view AddOns

Forum posts: 183
File comments: 944
Uploads: 9
Just a note, MM already exports sales, taxes, and guild rank to a table. If all you need from MM is the sales totals and ranks then parse the table saved in the saved vars file. A GM would have to do a few steps but it would be simple and easy to export without trying to read MM saved vars. The format is in my documentation.

You don't specify the time as an argument, you select that on the guild roster page, and choose the time frame from the drop down menu prior to exporting the sales. The GM could export whatever they needed that way.
__________________
Admin for TES5Edit, occasional LOOT masterlist contributor, and Wrye Bash contributor. I also maintain special Fallout 3 and Fallout NV versions of Wrye Flash.
Last edited by Sharlikran : 11/25/20 at 07:24 AM.
Report comment to moderator  
Reply With Quote
Unread 11/04/20, 05:30 PM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 28
Uploads: 7
Originally Posted by Verbalinkontinenz
Originally Posted by peniku8
Originally Posted by Verbalinkontinenz
Did u see the ITT Donation Bot on esoui yet? Might be the next thing helping get rid of sgt dependency... If u wanna check. Especially since ur only donation tracker yet is sgt.
I request donation amounts and a player's join date from SGT. Does the ITTDB include join dates or membership times?
You will have to need to talk this out with them, i have not that much of insight (from what i know it will be included in next update, i asked them to add join date). The main problem why i need to emphasize this is also, that the libguildroster which will be more frequently used by different addons as mm and att will lead into sgt to be pushed out, people have to deactivate sgt in guild roster more likely if they want to make use of libguildroster. doesnt mean, it wont be used anymore, as att at least works fine without libguildroster too, but might be a thing to be aware of, as it might cause dependency and interaction problems if someone wants to go on using ur addon but uses itt donation addon and libguildroster and so on. it would end in people beeing forced to use more addons, than they want and need to. i guess....
Well I'm not sure if I fully understand the issue you're trying to explain, but I agree that installing all 20 SGT sub-addons if you only need one is a bit cumbersome. Still, you could install SGT and then delete all SGT addons except SGT framework and SGT history scanner if it annoys you.
If the ITT tracker includes the join date I will eventually include it as alternative to SGT in my addons, if I get the time to do so.
Report comment to moderator  
Reply With Quote
Unread 11/03/20, 01:12 PM  
Verbalinkontinenz
 
Verbalinkontinenz's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 244
Uploads: 2
Originally Posted by peniku8
Originally Posted by Verbalinkontinenz
Did u see the ITT Donation Bot on esoui yet? Might be the next thing helping get rid of sgt dependency... If u wanna check. Especially since ur only donation tracker yet is sgt.
I request donation amounts and a player's join date from SGT. Does the ITTDB include join dates or membership times?
You will have to need to talk this out with them, i have not that much of insight (from what i know it will be included in next update, i asked them to add join date). The main problem why i need to emphasize this is also, that the libguildroster which will be more frequently used by different addons as mm and att will lead into sgt to be pushed out, people have to deactivate sgt in guild roster more likely if they want to make use of libguildroster. doesnt mean, it wont be used anymore, as att at least works fine without libguildroster too, but might be a thing to be aware of, as it might cause dependency and interaction problems if someone wants to go on using ur addon but uses itt donation addon and libguildroster and so on. it would end in people beeing forced to use more addons, than they want and need to. i guess....
__________________
resigned GM
Just Traders (EU Belkarth)
Tamriel Stock Exchange (EU Rawl'Kha)
Bait Trading House (EU Wayrest)
Last edited by Verbalinkontinenz : 11/03/20 at 01:13 PM.
Report comment to moderator  
Reply With Quote
Unread 11/03/20, 10:05 AM  
peniku8
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 28
Uploads: 7
Originally Posted by irs73
Is there possible to have sales minimun or fee on same rank?
Yes, it is. You can, for example, promote all players to rank "Member" if they either sell for more than 100k or donate more than 10k, if you enter 100k/10k for that rank.
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: