POE::C...utoJoin(3pm)

💖 NAME 💖

POE::Component::IRC::Plugin::AutoJoin — a PoCo-IRC plugin that literally keeps you on your favorite channels 💅 (and yes bestie, this whole page is from the POE::C...utoJoin(3pm) manual, we're in perl-doc land 🫶)

---

🌸 SYNOPSIS 🌸

Copied exactly, char for char, no notes:

use POE qw(Component::IRC::State Component::IRC::Plugin::AutoJoin);

my $nickname = 'Chatter';
my $server = 'irc.blahblahblah.irc';

my %channels = (
    '#Blah'   => '',
    '#Secret' => 'secret_password',
    '#Foo'    => '',
);

POE::Session->create(
    package_states => [
        main => [ qw(_start irc_join) ],
    ],
);

$poe_kernel->run();

sub _start {
    my $irc = POE::Component::IRC::State->spawn(
        Nick => $nickname,
        Server => $server,
    ) or die "Oh noooo! $!";

    $irc->plugin_add('AutoJoin', POE::Component::IRC::Plugin::AutoJoin->new( Channels => \%channels ));
    $irc->yield(register => qw(join);
    $irc->yield(connect => { } );
}

sub irc_join {
    my $chan = @_[ARG1];
    $irc->yield(privmsg => $chan => "hi $channel!");
}

---

✨ DESCRIPTION ✨

So. POE::Component::IRC::Plugin::AutoJoin is a POE::Component::IRC plugin 💖 and its whole personality is: you will not be left hanging in an empty channel.

If you get disconnected, the plugin will join all the channels you were on the next time it gets connected to the IRC server. Iconic behavior honestly 👑

It can also rejoin a channel if the IRC component gets kicked from it. And the way it keeps track of channel keys?? Obsessed — so it will be able to rejoin keyed channels in case of reconnects/kicks 🔑

Now. If a POE::Component::IRC::Plugin::NickServID plugin has been added to the IRC component, then AutoJoin will wait for a reply from NickServ before joining channels on connect. Patient queen behavior 🎀

⚠️ One requirement bestie, no skipping: this plugin requires the IRC component to be POE::Component::IRC::State or a subclass thereof. Not optional. It's giving "must be at least this tall to ride" 😭

---

🎀 METHODS 🎀

💅 new

Takes the following optional arguments:

• 'Channels' — either an array reference of channel names, or a hash reference keyed on channel name, containing the password for each channel 🌸 By default it uses the channels the component is already on if you are using POE::Component::IRC::State.
• 'RejoinOnKick' — set this to 1 if you want the plugin to try to rejoin a channel (once) if you get kicked from it. Default is 0. So by default it just… watches you get kicked 🙈
• 'Rejoin_delay' — the time, in seconds, to wait before rejoining a channel after being kicked (if 'RejoinOnKick' is on). Default is 5. A little dramatic pause before the comeback ✨
• 'Retry_when_banned' — if you can't join a channel due to a ban, set this to the number of seconds to wait between retries. Default is 0 (disabled). F in the chat for the ban 💀
• 'NickServ_delay' — how long (in seconds) to wait for a reply from NickServ before joining channels. Default is 5. Giving NickServ her moment 🫶

Returns a plugin object suitable for feeding to POE::Component::IRC's plugin_add method. That's the whole point fr fr 💖

---

👑 AUTHOR 👑

Hinrik Örn Sigurðsson, hinrik.sig@gmail.com — thank you for your service bestie 🌈⭐

---

okay that's the whole page, nothing skipped, nothing invented 🧚 this one's perl v5.40.1, dated 2025-08-21, straight from the POE::C...utoJoin(3pm) manual 💜 slay, go rejoin your channels 💅