# This Source Code Form is subject to the terms of the Mozilla Public # License, v. 2.0. If a copy of the MPL was not distributed with this # file, You can obtain one at http://mozilla.org/MPL/2.0/. package Plugins::RestrictedMod; # purpose: provides restricted moderation abilities to voiced users. # They are allowed to ban/mute/kick only users that are not admins, # whitelisted, or autoop/autovoice. This is useful for, e.g., IRCnet # configurations where +v users are recognized as "semi-trusted" in # order to provide assistance in combating heavy spam and drone traffic. use warnings; use strict; use feature 'unicode_strings'; use Carp (); use Storable qw/dclone/; sub new { Carp::croak("Options to " . __FILE__ . " should be key/value pairs, not hash reference") if ref $_[1] eq 'HASH'; my ($class, %conf) = @_; my $self = bless {}, $class; $self->initialize(%conf); return $self; } sub initialize { my ($self, %conf) = @_; $self->{pbot} = $conf{pbot} // Carp::croak("Missing pbot reference to " . __FILE__); $self->{pbot}->{commands}->register(sub { $self->modcmd(@_) }, 'mod', 0); $self->{pbot}->{commands}->set_meta('mod', 'help', 'Provides restricted moderation abilities to voiced users. They can kick/ban/etc only users that are not admins, whitelisted, voiced or opped.'); $self->{pbot}->{capabilities}->add('chanmod', 'can-mod', 1); $self->{pbot}->{capabilities}->add('chanmod', 'can-voice', 1); $self->{pbot}->{capabilities}->add('chanmod', 'can-devoice', 1); $self->{commands} = { 'help' => { subref => sub { $self->help(@_) }, help => "Provides help about this command. Usage: mod help ; see also: mod help list" }, 'list' => { subref => sub { $self->list(@_) }, help => "Lists available mod commands. Usage: mod list" }, 'kick' => { subref => sub { $self->kick(@_) }, help => "Kicks a nick from the channel. Usage: mod kick " }, 'ban' => { subref => sub { $self->ban(@_) }, help => "Bans a nick from the channel. Cannot be used to set a custom banmask. Usage: mod ban " }, 'mute' => { subref => sub { $self->mute(@_) }, help => "Mutes a nick in the channel. Usage: mod mute " }, 'unban' => { subref => sub { $self->unban(@_) }, help => "Removes bans set by moderators. Cannot remove any other types of bans. Usage: mod unban " }, 'unmute' => { subref => sub { $self->unmute(@_) }, help => "Removes mutes set by moderators. Cannot remove any other types of mutes. Usage: mod unmute " }, 'kb' => { subref => sub { $self->kb(@_) }, help => "Kickbans a nick from the channel. Cannot be used to set a custom banmask. Usage: mod kb " }, }; } sub unload { my ($self) = @_; $self->{pbot}->{commands}->unregister('mod'); $self->{pbot}->{capabilities}->remove('chanmod'); } sub help { my ($self, $stuff) = @_; my $command = $self->{pbot}->{interpreter}->shift_arg($stuff->{arglist}) // 'help'; if (exists $self->{commands}->{$command}) { return $self->{commands}->{$command}->{help}; } else { return "No such mod command '$command'. I can't help you with that."; } } sub list { my ($self, $stuff) = @_; return "Available mod commands: " . join ', ', sort keys %{$self->{commands}}; } sub generic_command { my ($self, $stuff, $command) = @_; my $channel = $stuff->{from}; if ($channel !~ m/^#/) { $channel = $self->{pbot}->{interpreter}->shift_arg($stuff->{arglist}); if (not defined $channel or $channel !~ /^#/) { return "Must specify channel from private message. Usage: mod $command "; } } return "I do not have OPs for this channel. I cannot do any moderation here." if not $self->{pbot}->{chanops}->can_gain_ops($channel); return "Voiced moderation is not enabled for this channel. Use `regset $channel.restrictedmod 1` to enable." if not $self->{pbot}->{registry}->get_value($channel, 'restrictedmod'); my $hostmask = "$stuff->{nick}!$stuff->{user}\@$stuff->{host}"; my $admin = $self->{pbot}->{users}->loggedin_admin($channel, $hostmask); my $voiced = $self->{pbot}->{nicklist}->get_meta($channel, $stuff->{nick}, '+v'); return "You must be voiced (usermode +v) or an admin to use this command." if not $voiced and not $admin; my $target = $self->{pbot}->{interpreter}->shift_arg($stuff->{arglist}); if (not defined $target) { return "Missing target. Usage: mod $command "; } if ($command eq 'unban') { my $reason = $self->{pbot}->{chanops}->checkban($channel, $target); if ($reason =~ m/moderator ban/) { $self->{pbot}->{chanops}->unban_user($target, $channel, 1); return ""; } else { return "I don't think so. That ban was not set by a moderator."; } } elsif ($command eq 'unmute') { my $reason = $self->{pbot}->{chanops}->checkmute($channel, $target); if ($reason =~ m/moderator mute/) { $self->{pbot}->{chanops}->unmute_user($target, $channel, 1); return ""; } else { return "I don't think so. That mute was not set by a moderator."; } } my $target_nicklist; if (not $self->{pbot}->{nicklist}->is_present($channel, $target)) { return "$stuff->{nick}: I do not see anybody named $target in this channel."; } else { $target_nicklist = $self->{pbot}->{nicklist}->{nicklist}->{lc $channel}->{lc $target}; } my $target_user = $self->{pbot}->{users}->find_user($channel, $target_nicklist->{hostmask}); if ((defined $target_user and $target_user->{level} > 0 or $target_user->{autoop} or $target_user->{autovoice}) or $target_nicklist->{'+v'} or $target_nicklist->{'+o'} or $self->{pbot}->{antiflood}->whitelisted($channel, $target_nicklist->{hostmask})) { return "I don't think so." } if ($command eq 'kick') { $self->{pbot}->{chanops}->add_op_command($channel, "kick $channel $target Have a nice day!"); $self->{pbot}->{chanops}->gain_ops($channel); } elsif ($command eq 'ban') { $self->{pbot}->{chanops}->ban_user_timed("$stuff->{nick}!$stuff->{user}\@$stuff->{host}", "doing something naughty (moderator ban)", $target, $channel, 3600 * 24, 1); } elsif ($command eq 'mute') { $self->{pbot}->{chanops}->mute_user_timed("$stuff->{nick}!$stuff->{user}\@$stuff->{host}", "doing something naughty (moderator mute)", $target, $channel, 3600 * 24, 1); } return ""; } sub kick { my ($self, $stuff) = @_; return $self->generic_command($stuff, 'kick'); } sub ban { my ($self, $stuff) = @_; return $self->generic_command($stuff, 'ban'); } sub mute { my ($self, $stuff) = @_; return $self->generic_command($stuff, 'mute'); } sub unban { my ($self, $stuff) = @_; return $self->generic_command($stuff, 'unban'); } sub unmute { my ($self, $stuff) = @_; return $self->generic_command($stuff, 'unmute'); } sub kb { my ($self, $stuff) = @_; my $result = $self->ban(dclone $stuff); # note: using copy of $stuff to preserve $stuff->{arglist} for $self->kick($stuff) return $result if length $result; return $self->kick($stuff); } sub modcmd { my ($self, $from, $nick, $user, $host, $arguments, $stuff) = @_; my $command = $self->{pbot}->{interpreter}->shift_arg($stuff->{arglist}) // ''; $command = lc $command; if (grep { $_ eq $command } keys %{$self->{commands}}) { return $self->{commands}->{$command}->{subref}->($stuff); } else { my $commands = join ', ', sort keys %{$self->{commands}}; if ($from !~ m/^#/) { return "Usage: mod [arguments]; commands are: $commands; see `mod help ` for more information."; } else { return "Usage: mod [arguments]; commands are: $commands; see `mod help ` for more information."; } } } 1;