To create new wiki account, please join us on #znc at Libera.Chat and ask admins to create a wiki account for you. You can say thanks to spambots for this inconvenience.
q
This module is a part of ZNC. This module is shipped with ZNC by default. If you have the right "LoadMod" you can activate it with /znc LoadMod q The code for this module can be found here. |
This module allows you to authenticate with Q when connecting to QuakeNet, either with the standard AUTH command or the CHALLENGEAUTH mechanism which prevents sending your password in cleartext.
In addition to that, it can activate QuakeNet's hidden host functionality (usermode +x) and request voice and op from Q when you join a channel (like Q's autoop flag +a and autovoice +g) or get deopped/devoiced (like Q's protect +p).
Usage
Arguments
This network module takes two optional arguments. The arguments are your username and password for Q.
Read loading modules to learn more about loading modules.
Commands
set
First, you have to set your Q username and password.
For this and for changing any other settings, there is a set
command.
/msg *q set <setting> <value>
The following settings are available:
Setting | Type | Description |
---|---|---|
Username | String | Your Q username. |
Password | String | Your Q password. |
UseHiddenHost | Boolean | Whether to cloak your hostname (+x) automatically on connect. |
UseChallenge | Boolean | Whether to use the CHALLENGEAUTH mechanism to avoid sending passwords in cleartext. |
RequestPerms | Boolean | Whether to request voice/op from Q on join/devoice/deop. |
get
To list your current configuration, use the get
(or list
) command.
<kroimon> get <*q> +---------------+---------+ <*q> | Setting | Value | <*q> +---------------+---------+ <*q> | Username | kroimon | <*q> | Password | ***** | <*q> | UseHiddenHost | true | <*q> | UseChallenge | true | <*q> | RequestPerms | true | <*q> +---------------+---------+
The password is never shown here to prevent abuse.
auth [<username> <password>]
The auth command allows you to auth yourself manually (for example after setting your username and password for the first time).
This command takes two optional parameters: <username> <password>
. The given values will be set as you Q username and password in the settings, too.
cloak
The cloak
command tries to set usermode +x if you're not already cloaked.
status
<kroimon> status <*q> Connected: yes <*q> Cloaked: yes <*q> Authed: yes
update
This command re-requests your current auth state and your channel flags from Q.
Usually you will only need this command after changing your channel flags.