Auto Ranks : Group, Guild & Friends : Elder Scrolls Online AddOns

(21 Kb)

Download

Updated: 04/17/24 10:14 AM

Add Favorite

Install Help

Pictures

File Info

Compatibility:	Scions of Ithelia (9.3.0)
Updated:	04/17/24 10:14 AM
Created:	05/27/20 03:27 PM
Monthly downloads:	691
Total downloads:	11,726
Favorites:	9
MD5:

9.3.0

Auto Ranks Updated this week!

Version: 3.4

by: peniku8 [More]

Auto Ranks:

A must have for every trade guild admin:
Auto Ranks does exactly what its name suggests: it automatically allocates guild member ranks depending on the players' sales and/or donations. Okay, it's semi-auto, you have to trigger it manually (button in the settings or via hotkey). Highly customizable.

All functions and code regarding Shissu integration have been removed in version 2.2, including the history scanner itself and the data migration functions.
Important for new users of LibHistoire:
Once you scanned all available history data (by opening all guild history pages) and the bars are all green, run the following command to set join dates of users that have no recorded join date to 'one year ago':

Code:

/ar fixjoindates

My addons ignore players without a valid join date as a safety feature for players that just joined, so this function needs to be run *once* all other data has been imported. This function can also be used to fix the join date for somebody who changed their user ID. Using it won't affect existing records.

Main functions:

- Promote and or demote guild members based on their MM or ATT sales
- Promote and or demote guild members based on their AMT or ITT donations
- Promote new members to the next higher rank after a set amount of days after joining
- 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 color codes)

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
- Restore rank: restore a returning player's rank, if their name is found on Auto Kick's "Remember player rank" list (for lifetime members for example)

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
- Auto Ranks will display a list of players that couldn't be contacted, if sending a mail fails
- Note: message text and settings are not part of presets

Addon Behavior:
- When both MM and ATT are active, the higher value of the two is taken
- Similarly, the highest value between AMT and ITT is chosen for donations
- When a new preset is created, it is automatically loaded as well
- When a preset is loaded, changes to the prior preset will automatically be saved
- 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 calculated from 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 change your ranking structure, the order of your guilds or the language of your client.
- Fully integrated into "Automate"

Dependencies:

-LibAddonMenu-2.0
-Master Merchant or Arkadius' Trade Tools
-Advanced Member Tooltip - LibHistoire or the two following:
-ITTs Donation Bot
-ITTs Roster Bot

Known issues:
-AMT currently does *not* track any donations past 30 days, however this feature will likely be added soon

3.4
-Removed all legacy code for Shissu integration
-Removed all conversion functions to import old Shissu data
-Fixed the custom time frame option when both ATT and MM are in use

3.3.2
-Hopefully fixed some possible errors

3.3.1
-Minor fixes and optimizations

3.3
-Added an option to every rank to choose if only one or both of the requirements need to be fulfilled to be moved to that rank

3.2.1
-Fixed some localization issues (not everything is translated to German yet, localization is a PITA)
-Removed dependencies for SGT and AMT so users can choose which addon they want to use

3.2
-Added slash command "/ar migratedonationssgtitt" to migrate old Shissu donation records to ITT
-Use this function once after updating if you want to transfer your records
-With Shissu's formatting, all donations will be added and set to a date in the past that is either the date of the member's first donation or over a year ago
-Fixed a bug that could result in an error being shown with the "Track Last Donation" function

3.1.2
-Added slash command "/ar fixjoindates" to handle "old player" join dates (sets them to one year ago)
-Use this function once after updating
-Changed existing slash commands to the format "/ar commandname"

3.1.1
-Fixed/implemented the "Track last donation" function for ITT

3.1
-Added ITT donations&roster support
-Added conversion functions to migrate missing join dates from one addon to the other
-Changed sales and donations assessment behavior: when multiple addons are running, AR will now scan all for data and take the highest value found (in case one addon missed some sales or donations)

3.0.1
-Fixed a typo which resulted in AutoRanks to see all join dates as "today"
-Minor code optimizations

3.0
-Integrated "Advanced Member Tooltip - LibHistoire" as join date and donation tracker addon
-Implemented a conversion to migrate Shissu join date data to AMT
-Optimized some code

2.6.7
-Removed history scanner requests as a hotfix to keep using Auto Ranks with the new API
-API bump

2.6.6
-API bump

2.6.5
-API bump

2.6.4
-fixed SHS capitalization issues

2.6.3
-Settings for guilds in which you can't promote members are now hidden
-Minor code optimizations
-Improved ShissuHistoryScanner's refresh

2.6.2
-Updated the AddonVersion metadata, to make sure AutoKick runs on the correct version of SHS

2.6.1
-Updated ShissuHistoryScanner to reset the join date if a guild member leaves or gets kicked
-Updated Auto Ranks to trigger ShissuHistoryScanner for a fresh scan before processing ranks

2.6.0
-Added the "Restore player rank" function, to restore a player's rank who has been kicked with Auto Kick's "remember player rank" feature
-The addition of this new setting requires Auto Ranks to reload your UI, the first time each of your presets is loaded

2.5.9
-Fixed an issue that wouldn't reset the list of players that couldn't be messaged, which could lead to double mentions

2.5.8
-Automatically shows the chat now, when messages are posted

2.5.7
-Fixed an issue that would lead to default rank names to be shown as blank

2.5.6
-Added a check if MM is initialized before attempting to process any rank changes

2.5.5
-API bump

2.5.4
-Changed the 'New member period' logic to ignore this when the next rank is not enabled
-API bump

2.5.3
-API bump

2.5.2
-API bump

2.5.1
-API bump

2.5
-Integrated ShissuHistoryScanner into the addon, which means:
-you can delete all Shissu addons from your addon folder if you like or
-uninstall Shissu Guild Tools from Minion
-you can keep using SGT if you so desire, it shouldn't cause any issues

2.4.14
-Added support for Master Merchant 3.6

2.4.13
-API bump

2.4.12
-Added a summary after sending out mails, which shows players that ignore you or have a full inbox

2.4.11
-Minor tweaks for the new Automate integration

2.4.10
-Added a callback manager event "AutoRanksDone" for smoother integration with other addons

2.4.9
-API bump

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 (55)

File Name	Version	Size	Uploader	Date
Auto Ranks	3.3.2	21kB	peniku8	04/03/24 04:43 PM
Auto Ranks	3.3.1	21kB	peniku8	03/29/24 06:49 PM
Auto Ranks	3.3	21kB	peniku8	03/29/24 05:17 PM
Auto Ranks	3.2.1	21kB	peniku8	03/23/24 07:25 PM
Auto Ranks	3.2	21kB	peniku8	03/21/24 10:29 PM
Auto Ranks	3.1.2	21kB	peniku8	03/21/24 06:36 PM
Auto Ranks	3.1.1	21kB	peniku8	03/20/24 10:10 PM
Auto Ranks	3.1	20kB	peniku8	03/18/24 09:28 PM
Auto Ranks	3.0.1	19kB	peniku8	03/14/24 02:51 PM
Auto Ranks	3.0	19kB	peniku8	03/13/24 04:47 PM
Auto Ranks	2.6.7	19kB	peniku8	03/12/24 09:42 AM
Auto Ranks	2.6.6	19kB	peniku8	10/31/23 04:23 PM
Auto Ranks	2.6.6	19kB	peniku8	10/31/23 01:55 PM
Auto Ranks	2.6.5	19kB	peniku8	06/28/23 04:43 PM
Auto Ranks	2.6.4	19kB	peniku8	05/15/23 04:39 PM
Auto Ranks	2.6.3	22kB	peniku8	05/01/23 05:35 PM
Auto Ranks	2.6.3	22kB	peniku8	05/01/23 05:19 PM
Auto Ranks	2.6.2	23kB	peniku8	04/30/23 09:17 AM
Auto Ranks	2.6.1	23kB	peniku8	04/27/23 09:12 PM
Auto Ranks	2.6.0	23kB	peniku8	04/27/23 05:28 PM
Auto Ranks	2.5.9	22kB	peniku8	04/26/23 05:53 AM
Auto Ranks	2.5.8	22kB	peniku8	04/23/23 10:24 AM
Auto Ranks	2.5.7	22kB	peniku8	04/17/23 05:45 PM
Auto Ranks	2.5.6	22kB	peniku8	04/17/23 07:22 AM
Auto Ranks	2.5.5	22kB	peniku8	04/09/23 08:36 AM
Auto Ranks	2.5.4	22kB	peniku8	04/03/23 06:05 PM
Auto Ranks	2.5.4	22kB	peniku8	11/01/22 03:29 PM
Auto Ranks	2.5.3	22kB	peniku8	09/22/22 03:34 PM
Auto Ranks	2.5.3	22kB	peniku8	06/06/22 05:31 PM
Auto Ranks	2.5.2	22kB	peniku8	03/18/22 03:26 PM
Auto Ranks	2.5.1	22kB	peniku8	11/08/21 08:03 PM
Auto Ranks	2.5	22kB	peniku8	09/19/21 05:44 PM
Auto Ranks	2.4.14	14kB	peniku8	09/14/21 04:17 PM
Auto Ranks	2.4.13	14kB	peniku8	08/30/21 04:53 PM
Auto Ranks	2.4.12	14kB	peniku8	03/23/21 05:40 PM
Auto Ranks	2.4.11	13kB	peniku8	03/14/21 11:32 AM
Auto Ranks	2.4.10	13kB	peniku8	03/09/21 03:25 PM
Auto Ranks	2.4.9	13kB	peniku8	03/08/21 01:44 PM
Auto Ranks	2.4.8	13kB	peniku8	12/21/20 06:11 PM
Auto Ranks	2.4.7	12kB	peniku8	12/08/20 05:37 PM
Auto Ranks	2.4.6	12kB	peniku8	12/06/20 10:12 AM
Auto Ranks	2.4.5	12kB	peniku8	11/27/20 04:26 PM
Auto Ranks	2.4.4	12kB	peniku8	11/22/20 05:29 PM
Auto Ranks	2.4.3	12kB	peniku8	11/20/20 08:22 AM
Auto Ranks	2.4.1	8kB	peniku8	11/16/20 05:17 PM
Auto Ranks	2.3.1	7kB	peniku8	11/13/20 01:53 PM
Auto Ranks	2.3.1	7kB	peniku8	11/11/20 08:54 PM
Auto Ranks	2.2.5	6kB	peniku8	11/03/20 06:39 AM
Auto Ranks	2.2.4	6kB	peniku8	09/04/20 04:14 AM
Auto Ranks	2.2.3	6kB	peniku8	09/01/20 06:06 PM
Auto Ranks	2.2.2	6kB	peniku8	08/30/20 04:45 PM
Auto Ranks	2.2	6kB	peniku8	08/09/20 01:34 PM
Auto Ranks	2.1.2	6kB	peniku8	07/06/20 05:27 AM
Auto Ranks	2.1	6kB	peniku8	07/02/20 02:16 PM
Auto Ranks	2.0	6kB	peniku8	05/27/20 03:39 PM

Comment Options

Page 1 of 5

Last »

06/09/20, 09:32 AM
marius_buys Forum posts: 0 File comments: 1 Uploads: 0	Help needed getting the addon to work Hi I would love to use this addon on the pc/eu server but need some general have you switched it on assistance. Me and a couple of my officers tried but we just cant seem to get it to work. Am I missing something. I would love if someone could join me on my discord so I could screenshare in setting it up. Muach appreciated.

07/06/20, 11:14 AM
Baertram Super Moderator Forum posts: 4971 File comments: 6038 Uploads: 78	Please add the dependencies to your description of the addon so the users are able to see them outside of the game! e.g. LibAddonMenu-2.0 ShissuHistoryScanner (which is maybe one of the ShissusGuildTools parts? Can't find it as standalone addon -> So you need to mention they need Shissus Guild Tools!) Most probably this is the problem that Marius_buys got here. Thank you Without them the addon cannot load at all so it definately should be mentioned in the description! Last edited by Baertram : 07/06/20 at 11:24 AM.

08/24/20, 11:55 AM
Abuhusam Forum posts: 0 File comments: 2 Uploads: 0	Hi I'm A guild master with new update the week start in Tuesday can you please update the addon best regarda

08/30/20, 04:49 PM

peniku8

Forum posts: 1

File comments: 67

Uploads: 8

Originally Posted by Abuhusam

Hi
I'm A guild master
with new update the week start in Tuesday can you please update the addon
best regarda

There is no need for Auto Ranks to recieve an update. All time frames are based on either ATT, MM or SGT, which all recieved a respective update.

09/02/20, 11:20 AM
irs73 Forum posts: 0 File comments: 1 Uploads: 0	Is there possible to have sales minimun or fee on same rank?

09/04/20, 06:55 AM
Verbalinkontinenz Forum posts: 11 File comments: 247 Uploads: 2	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.

11/03/20, 10:03 AM

peniku8

Forum posts: 1

File comments: 67

Uploads: 8

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?

11/03/20, 10:05 AM

peniku8

Forum posts: 1

File comments: 67

Uploads: 8

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.

11/03/20, 01:12 PM

Verbalinkontinenz

Forum posts: 11

File comments: 247

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....

Last edited by Verbalinkontinenz : 11/03/20 at 01:13 PM.

11/04/20, 05:30 PM

peniku8

Forum posts: 1

File comments: 67

Uploads: 8

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?

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.

11/24/20, 08:06 PM
Sharlikran Forum posts: 644 File comments: 2021 Uploads: 15	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. Last edited by Sharlikran : 11/25/20 at 07:24 AM.

11/26/20, 06:10 PM

peniku8

Forum posts: 1

File comments: 67

Uploads: 8

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.

12/08/20, 03:59 PM
wolfstar Forum posts: 0 File comments: 255 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.

12/08/20, 05:38 PM

peniku8

Forum posts: 1

File comments: 67

Uploads: 8

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

12/08/20, 09:45 PM

Sharlikran

Forum posts: 644

File comments: 2021

Uploads: 15

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.

Last edited by Sharlikran : 12/08/20 at 09:47 PM.

Page 1 of 5

Last »

If you like this Addon, feel free to send me any amount of gold in game @peniku8 [PC-EU]

Report this File