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: Difference between revisions
DarthGandalf (talk | contribs) template was missing |
m added link to old Q source code |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:q}} | {{DISPLAYTITLE:q}} | ||
{{ | |||
{{ambox | type = delete | text = '''Q is retired'''.<br/> | |||
<small>The Q module has been retired from ZNC version 1.8. Convince QuakeNet to start supporting [[sasl]], or use [[perform]] instead. If you wanted to compile/load Q like a third-party module, you can get the last version [https://raw.githubusercontent.com/znc/znc/8d309bbb3dc6bef558a2ffe4f523a0467dda8057/modules/q.cpp here] if you still need it.</small>}} | |||
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. | 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. | ||
| Line 7: | Line 11: | ||
== Usage == | == Usage == | ||
{{Module arguments | {{Module arguments | ||
| type = network | |||
| count = two optional | | count = two optional | ||
| extra = The arguments are your username and password for Q. | | extra = The arguments are your username and password for Q. | ||
Latest revision as of 10:26, 22 June 2020
 |
Q is retired. The Q module has been retired from ZNC version 1.8. Convince QuakeNet to start supporting sasl, or use perform instead. If you wanted to compile/load Q like a third-party module, you can get the last version here if you still need it. |
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.