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

From ZNC
Jump to navigation Jump to search
Zarthus (talk | contribs)
No edit summary
m added link to old Q source code
 
Line 3: Line 3:


{{ambox | type = delete | text = '''Q is retired'''.<br/>
{{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. You can go back through the git history to re-obtain the module if you still need it.</small>}}
<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.

Latest revision as of 10:26, 22 June 2020


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.