view mod_muc_reserve_nick_pattern/README.md @ 6475:d5b9da8c94ae

muc_reserve_nick_pattern and muc_restrict_nick: beta status and mention each other.
author Menel <menel@snikket.de>
date Tue, 17 Mar 2026 20:18:32 +0100
parents fe081789f7b5
children
line wrap: on
line source

---
labels:
- 'Stage-Beta'
summary: 'Require MUC occupant nicknames to not match some patterns'
---

Introduction
============

This checks the nickname of a joining user against a configurable list of
[Lua patterns](https://www.lua.org/manual/5.2/manual.html#6.4.1), and prevents
them from joining if it matches any of them.

Note the similar module: [mod_muc_restrict_nick]

Configuration
=============

Load it under a muc component.
There is a single configuration option, `muc_reserve_nick_patterns` and the
default is `{}` - i.e. allow everything.

Compatibility
=============

Requires Prosody 0.11 or higher.