To create new wiki account, please join us on #znc at freenode and ask admins to create a wiki account for you. You can say thanks to spambots for this inconvenience.

q

From ZNC
Jump to: navigation, search

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[edit]

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[edit]

set[edit]

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[edit]

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>][edit]

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[edit]

The cloak command tries to set usermode +x if you're not already cloaked.

status[edit]

<kroimon> status
<*q> Connected: yes
<*q> Cloaked: yes
<*q> Authed: yes

update[edit]

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.