Extended Bans - Revision history

Nero: /* Examples of IRC Ban Modes */

2025-07-04T11:19:48Z

Examples of IRC Ban Modes

← Older revision		Revision as of 11:19, 4 July 2025
Line 27:		Line 27:

	<pre>		<pre>
	/mode #channel +b m:U:!@*abc.def.12.34.IP		/mode #channel +b m:U:!@abc.def.12.34.IP
	</pre>		</pre>
	''This sets a mute ban for users connecting from the host <code>abc.def.12.34.IP</code>, representing a cloaked or formatted IP.		''This sets a mute ban for users connecting from the host <code>abc.def.12.34.IP</code>, representing a cloaked or formatted IP.

Nero: /* Examples of IRC Ban Modes */

2025-07-04T11:19:26Z

Examples of IRC Ban Modes

← Older revision		Revision as of 11:19, 4 July 2025
Line 29:		Line 29:
	/mode #channel +b m:U:!@*abc.def.12.34.IP		/mode #channel +b m:U:!@*abc.def.12.34.IP
	</pre>		</pre>
	''This sets a mute ban for users connecting from the ~~IP 123~~.45.67.89.		''This sets a mute ban for users connecting from the host <code>abc.def.12.34.IP</code>, representing a cloaked or formatted IP.
	The <code>m:U:</code> prefix means ~~they~~ must ~~be using~~ a registered nickname to speak — otherwise, they are muted.''		The <code>m:U:</code> prefix means users must have a registered nickname to speak — otherwise, they are muted.''

	<pre>		<pre>
	/mode #channel +b m:!@abcd1234.fake.mask.0000.ffff.IP		/mode #channel +b m:!@abcd1234.fake.mask.0000.ffff.IP
	</pre>		</pre>
	''This is a general mute ban for all users from ~~that~~ IP, ~~whether registered or not~~.		''This is a general mute ban for all users from the host <code>abcd1234.fake.mask.0000.ffff.IP</code>, simulating a cloaked IPv6 address.
	~~No one~~ from ~~123.45.67.89 can speak~~ in the channel.''		All users from this host are muted in the channel, regardless of nickname registration.''

	<pre>		<pre>
	/mode #channel +b !@user123.cust-99.fakeisp-net.example		/mode #channel +b !@user123.cust-99.fakeisp-net.example
	</pre>		</pre>
	''This is a full ban.		''This is a full ban for users connecting from the hostname <code>user123.cust-99.fakeisp-net.example</code>, a fake example of an ISP-style rDNS.
	~~Anyone from 123.45.67.89 is blocked from joining the channel entirely.''~~		Users matching this host will be completely unable to join the channel.''

	~~=== Acting Extended Bans ===~~

	~~Acting extended bans restrict actions~~ users ~~can perform. These can include preventing a user from speaking in a channel (requires the <code>muteban</code> module) or~~ from ~~changing their nickname (requires~~ the <code>~~nonicks~~</code> ~~module)~~. ~~Acting extbans can also~~ be ~~combined with matching extbans~~.
	</div>		</div>
	</div>		</div>

Nero: /* Examples of IRC Ban Modes */

2025-07-04T11:18:22Z

Examples of IRC Ban Modes

← Older revision		Revision as of 11:18, 4 July 2025
Line 48:		Line 48:
	Acting extended bans restrict actions users can perform. These can include preventing a user from speaking in a channel (requires the <code>muteban</code> module) or from changing their nickname (requires the <code>nonicks</code> module). Acting extbans can also be combined with matching extbans.		Acting extended bans restrict actions users can perform. These can include preventing a user from speaking in a channel (requires the <code>muteban</code> module) or from changing their nickname (requires the <code>nonicks</code> module). Acting extbans can also be combined with matching extbans.
	</div>		</div>
			</div>
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-

Nero: /* Examples */

2025-07-04T11:16:18Z

Examples

← Older revision		Revision as of 11:16, 4 July 2025
Line 19:		Line 19:
	<div style="background: linear-gradient(90deg, #f4f6fb, #eef2f7); color: #333; padding: 15px; margin-top: 20px; border-radius: 10px; box-shadow: 0 3px 6px rgba(0, 0, 0, 0.15);">		<div style="background: linear-gradient(90deg, #f4f6fb, #eef2f7); color: #333; padding: 15px; margin-top: 20px; border-radius: 10px; box-shadow: 0 3px 6px rgba(0, 0, 0, 0.15);">

	=== Examples ===		== Examples of IRC Ban Modes ==

	* <code>+b <ban></code> or <code>+e <ban></code>		Below are some examples to help explain different types of bans that can be applied to users in an IRC channel:

	</~~div~~>		* <code>+b <ban></code> sets a ban.
			* <code>+e <ban></code> sets an exception (unbans someone from an existing ban).

			<pre>
			/mode #channel +b m:U:!@*abc.def.12.34.IP
			</pre>
			''This sets a mute ban for users connecting from the IP 123.45.67.89.
			The <code>m:U:</code> prefix means they must be using a registered nickname to speak — otherwise, they are muted.''

			<pre>
			/mode #channel +b m:!@abcd1234.fake.mask.0000.ffff.IP
			</pre>
			''This is a general mute ban for all users from that IP, whether registered or not.
			No one from 123.45.67.89 can speak in the channel.''

			<pre>
			/mode #channel +b !@user123.cust-99.fakeisp-net.example
			</pre>
			''This is a full ban.
			Anyone from 123.45.67.89 is blocked from joining the channel entirely.''

	=== Acting Extended Bans ===		=== Acting Extended Bans ===

Nero at 21:43, 4 Haziran 2025

2025-06-04T21:43:21Z

← Older revision		Revision as of 21:43, 4 Haziran 2025
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	<div style="background: linear-gradient(90deg, #f4f6fb, #eef2f7); padding: 20px; border-radius: 10px; margin-bottom: 20px; box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; line-height: 1.6;">		<div style="background: linear-gradient(90deg, #f4f6fb, #eef2f7); padding: 20px; border-radius: 10px; margin-bottom: 20px; box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; line-height: 1.6;">

	== 👤 Extended Bans ==		== 👤 Extended Bans ==

	Extended bans (<code>extbans</code>) are divided into two types:		Extended bans (<code>extbans</code>) are divided into two types:

Nero at 21:39, 4 Haziran 2025

2025-06-04T21:39:28Z

← Older revision		Revision as of 21:39, 4 Haziran 2025
Line 1:		Line 1:
	= ~~Extended Bans =~~		__NOTOC__
			<div style="background: linear-gradient(90deg, #f4f6fb, #eef2f7); padding: 20px; border-radius: 10px; margin-bottom: 20px; box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1); font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; line-height: 1.6;">

	Extended bans (extbans) are divided into two types:		== 👤 Extended Bans ==
	* '''Matching extbans''': These match on users in additional ways.
			Extended bans (<code>extbans</code>) are divided into two types:

			* '''Matching extbans''': These match on users in additional ways beyond the standard nick!user@host mask.
	* '''Acting extbans''': These restrict users in various ways beyond standard bans.		* '''Acting extbans''': These restrict users in various ways beyond standard bans.

	Some list modes, like channel mode `b` (ban), typically use a `<nick>!<user>@<~~host~~>` mask. These modes can be extended to support alternate forms of matching and actions.		Some list modes, like channel mode <code>b</code> (ban), typically use a <code><nick>!<user>@<host></code> mask. These modes can be extended to support alternate forms of matching and actions.

			To use an extban, set <code>+b <ban></code> or <code>+e <ban></code> with the extban mask instead of the usual <code>nick!user@host</code> mask to ban or exempt users. Ban exceptions on acting extbans prevent users from matching the extban or corresponding channel mode.

			Matching extbans can also be used for invite exceptions by setting <code>+I <extban></code>.

			=== 🔧 Usage ===

			<code>MODE <channel> +\|-<modes> [<params>]</code>

			<div style="background: linear-gradient(90deg, #f4f6fb, #eef2f7); color: #333; padding: 15px; margin-top: 20px; border-radius: 10px; box-shadow: 0 3px 6px rgba(0, 0, 0, 0.15);">

			=== Examples ===

	~~To use an extban, set `~~+b <~~ban~~>` or `+e <~~ban~~>~~` with the extban mask instead of the usual nick!user@host mask to ban or exempt users. Ban exceptions on acting extbans prevent users from matching the extban or corresponding channel mode.~~		* <code>+b <ban></code> or <code>+e <ban></code>

	~~Matching extbans can also be used for '''invite exceptions''' by setting `+I~~ <~~extban~~>`.		</div>

	== Acting Extended Bans ==		=== Acting Extended Bans ===

	Acting extended bans restrict actions users can perform. These can include preventing a user from speaking in a channel (requires the `muteban` module) or from changing their nickname (requires the `nonicks` module). Acting extbans can also be combined with matching extbans.		Acting extended bans restrict actions users can perform. These can include preventing a user from speaking in a channel (requires the <code>muteban</code> module) or from changing their nickname (requires the <code>nonicks</code> module). Acting extbans can also be combined with matching extbans.
			</div>

	{\| class="wikitable"		{\| class="wikitable"

Nero at 11:55, 7 December 2024

2024-12-07T11:55:25Z

← Older revision		Revision as of 11:55, 7 December 2024
Line 156:		Line 156:

	* [InspIRCd Documentation, Extended Bans](https://docs.inspircd.org/3/extended-bans/)		* [InspIRCd Documentation, Extended Bans](https://docs.inspircd.org/3/extended-bans/)

			<div style="background: #f2f2f2; color: #333; padding: 20px; border-radius: 10px; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1); margin-top: 20px; font-family: 'Roboto', sans-serif;">
			<h3 style="color: #2980b9;">Need Help?</h3>
			<p>If you have questions or need assistance:</p>
			<ul style="list-style: none; padding: 0; color: #2c3e50;">
			<li style="margin-bottom: 10px;">* Join the help channel: '''[https://kiwiirc.hybridirc.com/#help #Help]'''</li>
			<li style="margin-bottom: 10px;">* Visit [https://www.hybridirc.com/help/extended-bans/ Extended Bans].</li>
			<li style="margin-bottom: 10px;">or contact us via e-mail at: support@hybridirc.com</li>
			</ul>
			</div>

Nero: Protected "Extended Bans" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2024-12-06T22:39:40Z

Protected "Extended Bans" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision	Revision as of 22:39, 6 December 2024
(No difference)

Nero: Created page with "= Extended Bans = Extended bans (extbans) are divided into two types: * '''Matching extbans''': These match on users in additional ways. * '''Acting extbans''': These restrict users in various ways beyond standard bans. Some list modes, like channel mode `b` (ban), typically use a `!@` mask. These modes can be extended to support alternate forms of matching and actions. To use an extban, set `+b ` or `+e ` with the extban mask instead of..."

2024-12-06T22:39:34Z

Created page with "= Extended Bans = Extended bans (extbans) are divided into two types: * '''Matching extbans''': These match on users in additional ways. * '''Acting extbans''': These restrict users in various ways beyond standard bans. Some list modes, like channel mode `b` (ban), typically use a `<nick>!<user>@<host>` mask. These modes can be extended to support alternate forms of matching and actions. To use an extban, set `+b <ban>` or `+e <ban>` with the extban mask instead of..."

New page

= Extended Bans =

Extended bans (extbans) are divided into two types:
* '''Matching extbans''': These match on users in additional ways.
* '''Acting extbans''': These restrict users in various ways beyond standard bans.

Some list modes, like channel mode `b` (ban), typically use a `<nick>!<user>@<host>` mask. These modes can be extended to support alternate forms of matching and actions.

To use an extban, set `+b <ban>` or `+e <ban>` with the extban mask instead of the usual nick!user@host mask to ban or exempt users. Ban exceptions on acting extbans prevent users from matching the extban or corresponding channel mode.

Matching extbans can also be used for '''invite exceptions''' by setting `+I <extban>`.

== Acting Extended Bans ==

Acting extended bans restrict actions users can perform. These can include preventing a user from speaking in a channel (requires the `muteban` module) or from changing their nickname (requires the `nonicks` module). Acting extbans can also be combined with matching extbans.

{| class="wikitable"
|-
! Name
! Character
! Ban Syntax
! Description
|-
| blockinvite
| A
| A:<mask>
| Bans <mask> from using the `/INVITE` command.
|-
| blockcaps
| B
| B:<mask>
| Bans <mask> from sending messages with excessive capitalization.
|-
| noctcp
| C
| C:<mask>
| Bans <mask> from sending CTCP messages.
|-
| blockcolor
| c
| c:<mask>
| Bans <mask> from sending messages with IRC formatting codes.
|-
| mute
| m
| m:<mask>
| Bans <mask> from speaking in the channel.
|-
| nonick
| N
| N:<mask>
| Bans <mask> from changing their nickname in the channel.
|-
| partmsg
| p
| p:<mask>
| Bans <mask> from sending a `/PART` message.
|-
| nokick
| Q
| Q:<mask>
| Bans users from using the `/KICK` command if matching <mask>.
|-
| stripcolor
| S
| S:<mask>
| Strips IRC formatting codes from messages sent by <mask>.
|-
| nonotice
| T
| T:<mask>
| Bans <mask> from sending `/NOTICE` messages.
|}

A ban given to an '''Acting extban''' can either use a nick!user@host mask (unless otherwise specified), matched like a normal ban, or a '''Matching extban'''.

Additionally, a '''redirect ban''' is a special type of acting extban:

{| class="wikitable"
|-
! Name
! Description
|-
| Redirect
| `n!u@h#channel` will redirect the banned user to `#channel` when they try to join (requires the `banredirect` module).
|}

== Matching Extended Bans ==

Matching extbans allow matching against extended user attributes, such as connection class (requires the `classban` module) or TLS (SSL) fingerprint (requires the `sslmodes` module).

{| class="wikitable"
|-
! Name
! Character
! Ban Syntax
! Description
|-
| realmask
| a
| a:<pattern>
| Matches nick!user@host+real mask against <pattern>.
|-
| country
| G
| G:<pattern>
| Matches the country code of the user's connection.
|-
| channel
| j
| j:<pattern>
| Checks if users are in a channel matching <pattern>.
|-
| class
| n
| n:<pattern>
| Checks if users are in a connect class matching <pattern>.
|-
| oper
| O
| O:<pattern>
| Checks if users are logged into an operator account matching <pattern>.
|-
| realname
| r
| r:<pattern>
| Checks if users have a real name matching <pattern>.
|-
| account
| R
| R:<pattern>
| Checks if users are logged into a services account matching <pattern>.
|-
| server
| s
| s:<pattern>
| Checks if users are on a server matching <pattern>.
|-
| unauthed
| U
| U:<pattern>
| Matches users not logged into a services account.
|-
| gateway
| w
| w:<pattern>
| Matches the name of the gateway WebIRC users are connecting from.
|-
| sslfp
| z
| z:<pattern>
| Checks if users have a TLS (SSL) client certificate with a fingerprint matching <pattern>.
|}

== References ==

* [InspIRCd Documentation, Extended Bans](https://docs.inspircd.org/3/extended-bans/)