JiralRandomCompanion is for automatically summoning a companion using the new companion interface of WoW 3.0. It creates an Addon Interface panel, accessable via the standard Options/Interface/Addons, that lists all the companions your character currently knows. For each companion there is a check box that indicates whether or not the companion can be randomly selected in the automatic summoning process. There is also a button on each line that will allow you to call that companion, or dismiss it if it is currently summoned. At the bottom of the panel there are buttons to allow the user to enable or disable all companions ability to be summoned by the automatic process. And finally there is a button that enables/disables the auto-summoning process itself.
The automatic summoning process should summon a companion when you don't have one. Except when you are in a PvP zone, stealthed, casting or channeling a spell, or mounted.
The eligibility of each companion and whether or not the automatic summoning process is active is saved between sessions on a per-character basis.
In addition to the auto-summoning there now exists two means of manually summoning a random companion. You can use the slash command "/jrs" to randomly summon one of your eligble companions. Note, if you have a companion out the "/jrs" command will summon a different companion. You can also pass "dismiss" (i.e., "/jrs dismiss") to dismiss your companion. And finally, there is now key bindings available for both the random summon and dismiss.
Note: For those folks still working on their Shattered Sun Offensive reputation (or just doing the dailies), the automatic summoning process is disabled in the Throne of Kul'jaden.
Much credit for this belongs to Tekkub. I reverse engineered his Ampere and Kennel Addons to create this one. But as I touched this last, any issues with it belong to me and not Tekkub.
02-13-10 - Updated TOC, no changes to code
09-04-25 - Updated TOC, no changes to code