Download
(251Kb)
Download
Updated: 07-18-11 07:02 PM
Pictures
File Info
Updated:07-18-11 07:02 PM
Created:06-15-11 12:54 AM
Downloads:3,674
Favorites:13
MD5:

TB Assimilator

Version: r344-release
by: Valana [More]

Disclaimer
While TB Assimilator implements safeguards to protect your account against in-game suspensions for spamming, please do understand that no system is infallible. Therefore, I cannot be held responsible for any sanctions taken against your account if you choose to download this add-on. USE AT YOUR OWN RISK!

I do take reports of suspensions and bans extremely seriously, however, and will take swift action to adjust the behavior of TB Assimilator.

If you are worried about getting your account suspended, try clearing out the sales pitch. This will send guild invitations without whispering players first.

Features
Description
Is your guild too small? Is your guild level too low? No matter your inadequacy, TB Assimilator is the solution! Seamlessly and effortlessly recruit 1000 members to level your guild to 25 for you, in no time!

Note: TB Assimilator is paused by default and you will need to start it manually by opening the configuration window.

Mass Recruiting
TB Assimilator constantly scans for guildless players, then sends them a customizable sales pitch (by default, it will include your tastiest perks, based on whether the potential recruit is still leveling or at max-level), followed by a guild invitation. It will recruit members up to a user-specified maximum (default: 925).

The very powerful search engine has the ability to discover every single guildless player on your faction and realm. No exceptions! Before you know it, your guild will have taken over your entire server!

TB Assimilator discovers guildless players as follows:

  • Periodic /who queries on various level ranges, and classes.
  • Players who speak on private channels (including the built-in General and Trade channels, but not /yell or /say).
  • Players who send you whispers.
  • Guild mates who request that you invite a friend to the guild.
  • Guild mates who request that you invite a friend to the guild.
  • Group members.
  • Players you target or mouseover.
  • Players who apply to your guild using the guild finder interface.
  • Your friends list.
  • Manual /who queries performed by the player.
Silent Operation
TB Assimilator works completely silently in the background. All unnecessary messages, such as invitation and "declined" messages, AFK / DND and Deadly Boss Mods responses, as well as outgoing sales pitches, are discarded. You are only notified when a new Zergling joins your ranks.

The add-on will also pause itself while you are in challenging content, such as rated PvP matches, or non-trivial raid instances.

Assimilation Rank
When a new Zergling is hatched, it is automatically promoted to a customizable rank, defaulting to the lowest guild rank. However, certain guilds reserve that rank as a "timeout" rank where members are unable to speak on guild chat, so setting a higher rank as the assimilation rank may prove useful in such cases.

You cannot set a rank that requires an authenticator as the assimilation rank.

Warning: any rank lower than the assimilation rank will be processed when kicking members from the guild!

Assimilation Date
TB Assimilator stores each Zergling' assimilation date within its internal database. You have the option of using public notes or officer notes to display those dates for easy reference.

Statistics
TB Assimilator keeps a record of your assimilation statistics, including how many Zerglings have been hatched, how many were sacrificed, and the day you first started running the add-on. These are displayed at the bottom of the configuration window.

Welcome Message
Make your freshly-spawned Zerglings feel at home! TB Assimilator can automatically welcome new members to your guild (default: enabled). If the Zergling leaves the hatchery too quickly, they will not be greeted.

Blacklist
You have the ability to prevent specific players from ever joining your guild for any reason. Maybe a former guild mate behaved like a jerk, or you want to avoid recruiting certain known spammers. TB Assimilator will not try to recruit those players automatically even if a guild mate requests it, and will warn you if you manually invite a blacklisted player.

Players marked with the "kick note" at the time you kick them from your guild (whether individually or through one of the /tba purge commands described below) will be added to your blacklist automatically.

No Spam
TB Assimilator only attempts to recruit players once, then avoids inviting them again for 14 days. If you really would rather avoid specific players, add them to your Ignore list, and TB Assimilator will always skip them.

Whispers and guild invitations are also sent staggered to avoid flooding chat channels. This behavior should hopefully help protect against in-game suspensions for spamming.

Multi-Guild Support
Do you play multiple alts in different guilds? Not a problem! **TB Assimilator** completely isolates its data on a per-guild basis. Even if you leave a guild and join a new one, the add-on will continue functioning correctly.

Slash Commands
/gkick
A new /gkick command allows you to remove Zerglings from your guild without having to scroll through pages of guild roster!

/tba
Bring up the standalone configuration panel with this command. You must enable TB Assimilator through this options menu after installation!

/tba c
This command brings up the configuration panel within the Blizzard Interface Options window.

/tba <player>
Use this command if you ever need to send both a sales pitch and guild invitation to a player manually for any reason.

/tba -<players>
This command will add the specified, punctuation-separated players to your blacklist, preventing them from being automatically invited to your guild. Any white spaces between the minus sign (-) and the name to blacklist will be stripped, so you can type the minus (-) followed by shift-clicking a player name from chat (which immediately prepends a space).

/tba f
This command will record any missing assimilation date (if applicable) and fix the guild ranks of any guild members at or below the assimilation rank. It is primarily useful when other guild officers are recruiting members manually.

/tba k
This command searches for inactive players at or below the assimilation rank and kicks them. The algorithm is fairly complex, and is based on level, guild contribution, and last date online. Players with the kick note are also sacrificed. The kicking process is only triggered manually, so do not use it if you intend to keep your Zerglings.

As always, the system messages are collapsed into a single list of players kicked for easier reference.

Note: The /tba purge commands will remove players up to the members target you specify in the configuration window, plus some extra to allow room for further guild growth.

/tba l
"Light" kicking mode will only sacrifice low level Zerglings with insufficient guild activity. This command is useful for removing bank alts and players who created an alt that tley logged in once.

/tba m
"Medium" kicking mode is slightly more aggressive than "Light" mode, and constitutes a good compromise between the regular purge and "Light" mode if you need more room for active members.

/tba a
This command sacrifices ALL Zerglings. Use with caution!

Note: The /tba purge commands will remove players up to the members target you specify in the configuration window, plus an additional 15% to allow room for further guild growth.

Officer Notes
A customized string (the "kick note") may be used to mark players you always want to kick via the '/tba k' command, ignoring their guild activity. Such players would also be blacklisted from rejoining your guild whenever you kick them from your guild. You set this string manually in the player's office note on a case-by-case basis.

Another string (the "keep note") may also be defined to mark players you want to keep despite low guild inactivity. This will not protect them against "/tba a" however. Promote such members to a higher rank if you wish to keep them as permanent members.

Requirements
TB Assimilator is disabled by default upon joining a new guild. The add-on must be configured throug the '/tba' command upon joining a new guild (including the first time after installation), and enabled by checking the Enabled checkbox.

Players running TB Assimilator must have guild invitation permission. The permission to promote will also be required if the assimilation rank is not the lowest rank within the guild. The permission to talk on guild chat is required to welcome new Zerglings, and the permission to edit guild notes is required for time stamping. Lastly, the permission to kick players is required to use the /tba purge commands.

It is recommended that only one player per guild run this add-on, to avoid spamming others with guild invitations and possibly getting reported for harassment.

Known Issues
On occasion, the game will complain that a player you are attempting to assimilate is already in a guild, when that is clearly not the case. Simply inform such players interested in joining your guild that logging out, then back in, usually resolves the issue.

Also, since WoW 4.1, players on trial accounts can no longer join guilds. There is no way for the add-on to determine whether a player is on a trial account; therefore you will occasionally receive a red error indicating "Feature not available for trial accounts." If the player asks you for an invitation, you will need to inform them that they cannot be invited until they upgrade their accounts.

Notice
TB Assimilator depends on TB Core. The latest release of TB Core is included with TB Assimilator so you do not need to download it separately.

Localizations
Localization for TB Assimilator is open. Please contribute your translations using the CurseForge contribution page.

Bugs and Requests
Please submit them using the CurseForge Tracker.

About the Author

I am a professional software engineer who plays World of WarCraft way too much and develops add-ons as a hobby (crazy, I know!). I have played the same character since the release of World of WarCraft, a hunter called Valana, in the Team BATTLE guild on the Mug'thol realm. I raid some, but my primary focus in this game is PvP.

r344-release:
* Guild invitations should no longer be sent out with every single whisper when using a blank sales pitch. For real this time.
* The purge commands work once again.
* There is now a button to cleanup the blacklist, removing players who are no longer a part of your realm and faction.
* It is now possible to blacklist multiple names from the command line, by delimiting them with punctuation. This was done primarily to ensure that names with dashes - could not be added.
* Players who whisper a guild invitation are immediately queried now, instead of going through the query process and getting a whisper followed by a delayed guild invitation.
* Friends who come online are now queried too (if applicable).
* Improved the dynamic sizing of the standalone configuration dialog based on the player's screen resolution and UI scale factor.
* Added a few more detection patterns for invitation requests.
* Increased the purge threshold back to 14 days.

r310-release:
* Implemented an adaptive throttling mechanism for outgoing whispers. This mechanism has a minimal impact when a small amount of players need to be invited to the guild, but increasingly reduces the rate at which whispers are sent out in busy situations. This does not affect players with an empty sales pitch.
* Fixed a bug that was causing players with an empty sales pitch to send a guild invitation to any player they whispered, on every single whisper.
* Vastly improved the handling of guild invitation requests received over whispers as well as guild chat. This should result in more requests being detected more accurately, as well as fewer false positives.
* Outgoing whispers are once again visible on invitation requests and on manual /tba commands. Will gauge user reactions.
* The "you tried to assimilate me..." addendum is now always tacked on to the first whisper from an invited player, without time restrictions. This is to allow players "already in a guild" to also display the addendum, since their whisper date is artificially back-dated (in order to allow them to be queried/invited again within 12 hours). Will evaluate whether the time restriction needs to be reinstated and a different workaround implemented.
* Players who log out before we can whisper or invite them can now be re-queried and re-invited immediately when they come back online.
* Allow players who have "already been invited to a guild" to be re-queried and re-invited after 12 hours (in case they decline).
* Guild applications are now treated as requests, bypassing the members target.
* A different message is now sent to guild applicants when trying to recruit them.
* Guild applicants now get a distinctive addendum if they whisper back.
* Incoming whispers are now always scanned for guild invitation requests for other players, in addition to guild invitation requests for the senders.
* Fixed a bug that was causing guild mates' data to be purged from the internal database after 10 days like everybody else's. Among other things, this resulted in demoted players being promoted back, in assimilation dates becoming reset if the user did not back them into guild notes, and in extending guild mates' do-not-invite period after they left the guild.
* New guild mates who were invited by someone else are now welcomed to the guild as well.
* New guild mates who log off immediately are no longer greeted.
* Made some corrections to the handling of DBM status responses.
* Trying to gkick a player who is not in our guild no longer produces an error.
* Other guilds' query data should once again be purged correctly.
* Errors while cleaning up other guilds' data should no longer prevent the add-on from starting.
* Miscellaneous tooltip corrections.

r272-release:
* Personal guild invitation requests must once again match "ginv" or "g inv" to avoid false positives, although this once again requires more manual action from the user.
* Guild applications are now treated as requests and bypass the members target.
* A different message is now sent to guild applicants when trying to recruit them.
* Guild applicants now get a distinctive addendum if they whisper back.
* Incoming whispers are now always scanned for guild invitation requests for other players, in addition to guild invitation requests for the senders.
* New guild mates who were invited by someone else are now welcomed to the guild as well.
* Made some corrections to the handling of DBM status responses.

r261-release:
* Added a blacklist. To use it, either open the configuration window by typing /tba, then filling in the text box; or add a player to it by typing /tba -<name>. Note the minus sign.
* Players on your blacklist will not be invited automatically by TB Assimilator, and the add-on will warn you if you attempt to invite them manually (although it will still let you do it).
* Kicking a player marked with the "kick note", either manually or through a purge command, will blacklist that player at the same time.
* Blacklisting a guild mate will mark them with the "kick note" if one is defined.
* The "ignored guild mates" alert now includes blacklisted guild mates as well, and is printed as a comma-delimited list rather than one per line.
* Guild invitation requests (through guild chat or whispers) will now be processed in rated PvP matches and in non-trivial raid instances.
* Guild applicants are now invited automatically if they are online.
* Guild invitations are now also guaranteed to only go out after the promotional whisper.
* Players who never receive automated whispers and guild invitations due to server throttling are now retried upon the next logon or UI reload.
* Added full support for sending players a guild invitation directly without a sales pitch by specifying a blank, custom sales pitch.
* When switching from the default sales pitch to a custom sales pitch, the custom sales pitch is now pre-filled with the default sales pitch, if it was previously blank. This ensures that users do not use a blank sales pitch by mistake.
* Data pertaining to /who queries are now stored per guild rather than globally for the faction/realm combination. This would allow a user to login to a different guild and attempt players who declined an invitation to the previous (possibly less appealing) guild.
* Added a login-time reminder to enable the add-on if it is disabled.
* The names of mass-kicked Zerglings are now printed alphabetically.
* The guild's experience data is now requested more frequently from the server, so that the guild level indicator is now always up-to-date.
* Assimilation time stamps should no longer get truncated in some rare situations.
* The configuration window has had options moved around or renamed. It also grows to accomodate larger screen sizes.
* Fixed a bug that was causing the sacrificial statistics to get incremented even when a Zergling failed to be kicked.
* Fixed numerous little bugs, notably with messages not being correctly hidden.

r197-release:
* Added a field to the players storage to prepare for a workaround to WoW's whisper throttling.
* Tested in WoW 4.2.

r194-release:
* The rate of assimilation should be back to roughly what it was in r56-beta.
* A notice is now printed to the chat frame when a new guild recruiting application arrives, or if there are any pending upon login.
* It is no longer possible to set an authenticator rank as the assimilation rank.
* Made the guild invitation request pattern (through whisper) more lenient. It now accepts "g inv", "inv", and variations, rather than just "ginv".
* Added a workaround for data migration issues experienced by some users upgrading from r56-beta.
* Fixed various errors when opening the configuration window under certain conditions.
* Fixed various errors with system messages not being filtered properly.
* Fixed various errors with outbound sales pitches not being filtered properly, mainly due to drunkenness. There was also a sequence of events that could cause custom sales pitches to always be shown.
* Attempted to fix an error with trying to build the default sales pitch for characters who have never been in a guild.
* The "you tried to assimilate me" addendum is now appended in every chat window.
* Ignored guildmates warnings are now printed more prominently.
* Guildless players are now made eligible for another invitation after 10 days, down from 14.
* Players "already in a guild" are made eligible for automatic invitation after 12 hours, down from 24.
* Players are now queried once every 12 hours at most, instead of once every 24 hours.

r174-release:
* Added a separate default sales pitch for level 1 guilds, since those do not actually have any perks to promote.
* Added the ability to specify a custom sales pitch. The maximum length of the custom sales pitch is 255, minus the number of 's's to allow for proper detection of drunken whispers. Checking the checkbox to use a custom sales pitch will pause the add-on, and Enabled will need to be re-checked. Also, setting a custom sales pitch containing %d will immediately whisper the sales pitch to the player, to verify the guild level substitution.
* Better support for regex-pattern characters in sales pitches.
* Guildless players who cannot be invited due to an "already in a guild" error are now reset the next day and the add-on will try to invite them again.
* Time stamps are now optional and disabled by default. The player also has the option to use Public or Officer Notes to store them.
* Better support for players playing multiple alts in different guilds. Among other things, player invite data are now stored on a per-guild basis to avoid issues across alts, or when leaving a guild and joining a new one. Data pertaining to other guilds will be erased within 4 months of not logging in to them.
* Automatic recruiting is now disabled by default. A message is printed to the chat window upon joining a new guild to remind the player to configure the add-on and enable it.
* The search engine should now comprehensively discover every guildless player on the server (especially level 85's). The tradeoff was that the algorithm is now slower. Improvements have been made to counteract this, and more will come in the next release.
* The add-on will now only promote Zergligns once to their assimilation rank. Therefore, if the player demotes a Zergling to the "timeout" rank, the add-on will no longer attempt to promote them back when a new Zergling is hatched, or even through the /tba f command.
* Added ChatThrottleLib to stagger whisper messages and avoid rejections from the server.
* TB Assimilator now pauses itself in any kind of rated PvP match, as well as non-trivial raid instances.
* Fixed numerous errors that popped up when not in a guild, as well as the statistics message.
* Fixed a number of bugs with system message filtering.
* The configuration panel is now disabled if the player does not have sufficient permissions to hatch new Zerglings.
* If the player cannot speak on guild chat, the option to welcome new Zerglings is disabled and no error message will be displayed.
* Added an error message when trying to use the purging /tba commands without sufficient permissions to sacrifice Zerglings.
* System messages were not being hidden as intended when automatically querying players who talk on open channels.
* Fixed a Lua error that was raised when using /tba to invite a guild member or oneself.
* If a player joins the guild, then leaves before whispering the player, "you tried to assimilate me" is appended instead of "you assimilated me".
* Fixed some logical errors in offline players guild purging.
* The lowest rank in the guild will now always display in the Assimilation Rank drop down, even if the player running the add-on is the lowest rank in the guild.
* Addresses many grammatical and clarity issues in the configuration tooltips.
* The "first run" time stamp is now applied when enabling the add-on for the first time in a new guild, rather than immediately upon joining.
* /tba c actually opens the Blizzard configuration menu now.
* The /tba purge commands will now purge an additional 15% of the members target, rather than purging just enough to match that value (in order to allow further growth).
* Invitation requests made on officer chat are now honored as well.
* Increased the default members target to 925 from 900.
* Fixed doubled % signs in catch phrases.

r56-beta:
* Initial public beta.
Post A Reply Comment Options
Unread 06-30-11, 05:03 PM  
litesung
A Flamescale Wyrmkin
 
litesung's Avatar

Forum posts: 130
File comments: 231
Uploads: 0
Suggestion for future features:

[ ] Option to not send out any whispers
[ ] Option to allow TBA to automatically expel/kick members who have X inactivity without user input. (Possibly TBA can scan every X Minutes or hours beginning x time after logging in) Basically allowing users to edit the criteria at which TBA will automatically expel members through in-game UI/settings.
Report comment to moderator  
Reply With Quote
Unread 06-27-11, 11:04 AM  
Valana
A Defias Bandit
 
Valana's Avatar
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 102
Uploads: 18
Thumbs up for the avatar :]

Originally posted by zork
We are the Borg. You will be assimilated. Your biological and technological distinctiveness will be added to our own. Resistance is futile.
__________________
Author of the TB Add-Ons Suite.
Report comment to moderator  
Reply With Quote
Unread 06-27-11, 02:27 AM  
zork
A Pyroguard Emberseer
 
zork's Avatar
AddOn Author - Click to view AddOns

Forum posts: 1740
File comments: 3728
Uploads: 77
We are the Borg. You will be assimilated. Your biological and technological distinctiveness will be added to our own. Resistance is futile.
__________________
| Simple is beautiful.
| WoWI AddOns | GitHub | Zork (WoW)

"I wonder what the non-pathetic people are doing tonight?" - Rajesh Koothrappali (The Big Bang Theory)
Last edited by zork : 06-27-11 at 02:27 AM.
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump:

Support AddOn Development!

You have just downloaded by the author . If you like this AddOn why not consider supporting the author? This author has set up a donation account. Donations ensure that authors can continue to develop useful tools for everyone.