Sticky I've got a ZNC. And now?

    • I've got a ZNC. And now?

      (This thread is a continuation of I want a ZNC. What shall I do?)


      you’ve just got a Centravi ZNC. First of all, let’s say what features your ZNC has.

      Protect nick overtake
      Your ZNC is connected to a server permanently (excluding downtimes, maintenance and so on). It means your nick is protected from overtake – you have this nick for 24 hours per day and there’s no way for anyone how to reach your nick.

      Private Messages logged
      This point is connected to the above-mentioned. If you’re still online, people can send you the private messages. When you connect to your ZNC, you will receive them all.

      Channels kept and talk logged
      You’ve joined a channel. You don’t have to join all channels again because your ZNC is still connected. If you haven’t left and you’re still in, you can also log the conversation in the channel.

      Real IP hidden
      Since you use our ZNC you will get a host ‘’ which hides your real IP.

      I suppose that your helper asked you to auth yourself. If not, do it now, please.

      Now, I'll show you how to set your ZNC step by step.

      ZNC commands
      ZNC modules
      Problems with connection
    • ZNC commands

      You can use two ways to communicate with your ZNC.
      /msg *status command
      or in some clients
      /znc command

      The main command for ZNC is help.
      So use /msg *status help or /znc help. You will see this list.

      In the following list all occurences of <#chan> support wildcards (* and ?)
      (Except ListNicks)
      | Command | Arguments | Description |
      | Version | | Print which version of ZNC this is |
      | ListMods | | List all loaded modules |
      | ListAvailMods | | List all available modules |
      | ListChans | | List all channels |
      | ListNicks | <#chan> | List all nicks on a channel |
      | ListClients | | List all clients connected to your ZNC user |
      | ListServers | | List all servers |
      | AddServer | [[+]port] [pass] | Add a server to the list |
      | RemServer | [port] [pass] | Remove a server from the list |
      | Enablechan | <#chan> | Enable the channel |
      | Detach | <#chan> | Detach from the channel |
      | Topics | | Show topics in all your channels |
      | PlayBuffer | <#chan> | Play back the buffer for a given channel |
      | ClearBuffer | <#chan> | Clear the buffer for a given channel |
      | ClearAllChannelBuffers | | Clear the channel buffers |
      | SetBuffer | <#chan> [linecount] | Set the buffer count for a channel |
      | Jump [server] | | Jump to the next or the specified server |
      | Disconnect | [message] | Disconnect from IRC |
      | Connect | | Reconnect to IRC |
      | Uptime | | Show for how long ZNC has been running |
      | LoadMod | | Load a module |
      | UnloadMod | | Unload a module |
      | ReloadMod | | Reload a module |
      | ShowMOTD | | Show ZNC's message of the day |

      You can see a little explanation behind the name of command. I’d like to extend some:

      | Name | Status | Conf | Buf | Modes | Users | @ | + |
      | @+#centravi | Joined | | 50 | +CMcntz | 385 | 29 | 216 |

      Total: 37 - Joined: 36 - Detached: 0 - Disabled: 1

      The first column shows a name of the channel and your status in, @ means op, + means voice and no character means no op and no voice. The second one is the status of channel in your ZNC – joined or disabled. Buf means buffer so how many lines are logged from this channel. Column modes shows active modes in the channel. The last ones are number of users, opped users and voiced users.

      | @ | + | Nick | Ident | Host |
      | @ | + | Geeek | Geeek | Geeek.user.OnlineGamesNet |
      | | + | victor | victor | |

      This command show all users in a channel but it’s not effective for joined users after mode +D is set. You see it shows channel status, ident and hostname.

      This command allows you to set how many lines in the channel will be logged – max 2000 lines. Use it /msg *status setbuffer #CHANNEL [NUMBER], for the maximum of lines and for all channels use /msg *status setbuffer * 2000.

      Detach funtion is able to help you when you must be in a channel but you don’t like it in the list of channels you are in. Using /msg *status detach #CHANNEL you hide the channel for you but you are still in. To cancel detach just join the channel (automatically enable the channel and join it).

      This is a good feature if you want to hide #centravi in your list of channels. Do you think there is just spam and it annoys you?
      Use /detach #centravi and the channel will disappear. Don't forget you still stay in but you don't see it which means you will be able to join your maximum of channels minus one - #centavi.

      To get back use /join #centravi
      You will see some lines which are saved by your ZNC after joining. If you don't want to see them anymore when you join then use /znc setbuffer #centravi 0.

      Afterwards you can do /detach #centravi again and it will disappear again. :)
    • ZNC modules

      Have you ever wanted to change your nick while you’re offline, set a message as an aswer for queries while you’re offline? If you answer yes, then go on with reading.

      Main commands we’ll use: ListMods, ListAvailMods, LoadMod, UnloadMod, ReloadMod

      Let’s divide this topic into four parts – loading, setting, unloading, reloading.


      If we want to work with a module we must load it at first. For this function there is a command /msg *status loadmod [NAME].

      Command /msg *status ListMods shows already loaded modules.

      Command /msg *status ListAvailMods shows all modules you may load. Loaded ones are marked with a star.

      User modules:
      | Name | Description |
      | Detachall | Adds /detachall and /znc detachall commands. |
      | Kicklog | Log kick messages when you are kicked |
      | *admin | Dynamic configuration of users/settings through IRC |
      | amsgfilter | Excludes channels from amsgs |
      | antiidle | Hides your real idle time |
      | autoattach | Reattaches you to channels on activity. |
      | autocycle | Rejoins channels to gain Op if you're the only user left |
      | autoop | Auto op the good guys |
      | *autoreply | Reply to queries when you are away |
      | autovoice | Auto voice the good guys |
      | away | You don't need this module, ZNC works ok without it |
      | *awaynick | Change your nick while you are away |
      | block_motd | Block the MOTD from IRC so it's not sent to your client(s). |
      | bouncedcc | Bounce DCC module |
      | buffextras | Add joins, parts etc. to the playback buffer |
      | cert | Use a ssl certificate to connect to a server |
      | chansaver | Keep config up-to-date when user joins/parts |
      | charset | Normalizes character encodings. |
      | clearbufferonmsg | Clear all channel buffers whenever the user does something |
      | clientnotify | Notifies you when another IRC client logs into or out of your account.
      Configurable. |
      | crypt | Encryption for channel/private messages |
      | ctcpflood | Don't forward CTCP floods to clients |
      | dcc | This module allows you to transfer files to and from ZNC |
      | disconkick | Kicks the client from all channels when the connection to the IRC server is lost |
      | email | Monitors Email activity on local disk /var/mail/user |
      | fakeonline | Fakes online status of ZNC *-users. |
      | flooddetach | Detach channels when flooded |
      | highlightattach | Reattaches you to a detached channel when someone mentions your nick in it. |
      | keepnick | Keep trying for your primary nick |
      | keyremember | Remember channel keys for reconnects |
      | *kickrejoin | Autorejoin on kick |
      | leavechans | Automaticaly leave chans and inform users on disconnect |
      | listsockets | List active sockets |
      | nickserv | Auths you with NickServ |
      | notes | Keep and replay notes |
      | perform | Keeps a list of commands to be executed when ZNC connects to IRC. |
      | q | Auths you with QuakeNet's Q bot. |
      | quitaway | Set away message on quit (from quit message) |
      | raw | View all of the raw traffic |
      | route_replies | Send replies (e.g. to /who) to the right client only |
      | sample | To be used as a sample for writing modules |
      | savebuff | Stores channel buffers to disk, encrypted |
      | schat | Secure cross platform (:P) chat system |
      | send_raw | Lets you send some raw IRC lines as/to someone else |
      | *simple_away | Auto away when last client disconnects |
      | simple_disconnect | Auto disconnect from server when last client disconnects |
      | stickychan | configless sticky chans, keeps you there very stickily even |
      | translate | Translation of conversation using Google |
      | twitter | Implements a simple twitter client. |
      | watch | Copy activity from a specific user into a separate window |

      Because this is a standard list of modules some of them you can’t use. Like Q – only on QuakeNet network, email – you don’t have any centravi e-mail, modules with CTCP and DCC – available only for admins etc.


      I’d like to describe here the modules which I find the most useful:

      This module answers queries when you’re offline.
      /msg *autoreply set [MESSAGE]

      Awaynick exactly does what its name says. It sets a different nick when you’re offline.
      /msg *awaynick set [NICK]
      Use /msg *awaynick set %nick%|ZNC and your awaynick will be your actual nick but with a |ZNC in the end.

      This module makes your ZNC joining a channel when kicked. You can set a time in seconds until it rejoins.
      /msg *kickrejoin setdelay [NUMBER]

      It provides to set a reason of your away that is shown in /whois. You also set a time in seconds to active the away after you disconnected.
      /msg *simple_away reason [TEXT]
      /msg *simple_away settimer [NUMBER]

      You can research all modules. One command may help you a lot. You can use /msg *module help to see a help for setting the module if available.


      We can simply unload a module using command /msg *status unloadmod [NAME].


      Have you loaded and set a module, then unloaded it and now you’d like to have it back? So simply use /msg *status reloadmod [NAME].
    • WebInterFace

      WebInterFace is a feature for setting your ZNC via your web browser.

      You can log in with your auth account name and ZNC password. The link is

      For 9001 >>>
      For 9002 >>>
      For 9003 >>>
      And so on. If you don’t know the number of your port, ask a supporter for it.

      After entering this side, fill up the boxes.

      Then click to Your settings.

      The first part is Authentification.

      Username is your auth account name and you can’t change it but the thing you can change is your ZNC password. Write a new one and confirm it in the second box. If you change it here, you must change it in your client as well (ask a supporter if needed)
      You can set Allowed IPs to connect to your ZNC as well – one entry per line.

      Go on to IRC Information.

      Nickname is your nick on IRC when you’re online and connected to your ZNC. Alt. Nickname is a nick you get if the first nickname is already in use. Ident is same as your auth account name and you can change it.
      StatusPrefix is a character of begginning of commands. It affects commands inside your client - /msg [character]status or /msg [character]module. So if + is set you use /msg +status or /msg +module.
      The content of Realname is up to you. Quit Message is shown as a reason when your ZNC quits. Servers is a box that shows available servers. Remember, OnlineGamesNet network is the only one allowed.

      The next step – Modules.

      You can see a list of modules with a short description. Some of the them are also links to ZNC wikipedia where they are explained. Ticked modules are loaded. You can easily tick one to load it (then you must save it with the Save button in the bottom).

      Now about Channels.

      You can add/edit/del a channel here. Adding one will make your ZNC join it, same for deleting (but leaving in this case ;)). There are also some features of the channels. The box Modes in Default Channel Settings has got a simply function. When you join an empty channel with your ZNC you will automatically set these modes for example +tnC.
      Buffer Size is a number of logged lines for all joined channels. The maximum is 2000 lines.
      The part Flags consists of serveral options. Keep buffer will keep the last logs and show them with the new ones. Multi Clients allows you to connect to your ZNC from more clients. Each logged line has got its own time stamp. Append Timestamps sets that the time shown in the end of line and Prepend Timestamps sets that the time is shown in the beggining of the line.

      The last part is ZNC Behavior.

      Timestamp Format sets what format of time will be shown in each line. This option means hours, minutes and seconds. Timezone Offset is a feature for setting a different GMT. Our time is GTM +1. Join Tries is a number of how many times ZNC tries to rejoin a channel before it disables it. Max Joins means how many channels your ZNC tries to rejoin at same time.

      CTCP Replies box is for fake answers. If someone requests the version of your IRC client this option can show a fake answer. For example VERSION Don’t be so curious cause it makes my furious. Skin is a template of WebInterFace. You can choose one you like the most. SAVE is a button that saves what you changed.
    • Now some information about Login-on-Connect or the short form – LoC.
      LoC is a feature developed by the OnlineGamesNet. It allows you to login to your AuthServ account before being introduced to the network.

      What does it mean?
      If you auth before being introduced to the network you are able to get your fakehost and other users can’t see your real host and you can use your special privileges on the network.

      What privileges can I have? What are the advantages?
      There are some privileges for teamlers of GameForge games whitch help them to do their work. The main is that they can join more channels than users. How many channels they can join is set by their position (GM,GO,GA,BA,TM...).
      But there are some privileges for users too. You can join 25 channels instead of 20.
      If your ZNC will ever reconnect you don't have to auth because you connect to the network with your auth name and password. You will also add all 3 OnlineGamesNet servers so if one fails you will already authed reconnect to another one.

      Sounds good. How can I set it? (important note: read to end)
      For LoC you have to change the setting of the server, because you have to set the server password. The server password here means your name and password to AuthServ.

      There are two possibilities how to set LoC:

      1. In your client
        Connect to your ZNC and type:
        /msg *status loadmod admin (if it's not loaded)
        /msg *admin setloc YourAuthNAME YourAuthPASSWORD
        using an example with account named Webcam and password 5499:
        /msg *admin setloc Webcam 5499

        After setting LoC you will reconnect.

      2. Via WebInterFace

        Log in to your WebInterFace and scroll down to part Servers.
        There you will see your server and port. The only thing you must add is your auth account and auth password - here with a colon between your name and your password.

      Basically, you can see there this content.

      Now add all three servers with the password (+7776 means a SSL).
      Using the example datas:

      Then click on the Save button and make your ZNC jump by typing this command in it /znc jump.

      That's it.
    • Problems with connection

      The last step here will explain you the most often problems with connection and their solution.

      If you cannot connect to your client or have another issues and need help, you can use this link to connect to our public channel. Click on Connect, then auth yourself and make a ticket via /msg Centravi support I need help.

      1. Invalid password

        Error:[quote]* Connect retry #1 (9003)
        • Invalid Password[/quote]Description: The password of the Centravi ZNC server is wrong or your ZNC has been deleted.

        Solution: Contact the support and request a new password or more information.

      2. Connection aborted

        Error: [quote]<*status> Some module aborted the connection attempt
        <*identfile> Aborting connection, another user is currently connecting and using the ident spoof file[/quote]Description: This happens when one of the OnlineGamesNet servers goes off and then back and the ZNCs try to connect. Because there are many ZNCs on one port connecting to the same server, it aborts your connection.

        Solution: If you set (LoC for) all servers (look above in this thread), you can try to use /znc jump. If it doesn't work, there is only one solution - you must wait.

      3. No server password

        Error:[quote]* Connecting to (9003)
        from - *** You need to send your password. Try /quote PASS :[/quote]Description: Your client tries to connect to your ZNC but the information of the server aren't completed.

        Solution: Open your list of servers and look there the CentZNC server up. Find the box Password or Server Password
        and type there YourAuthName:YourZNCPASSWORD. If you don't remember your ZNC password, contact the support.

      4. ZNC is blocked by the administraion

        Error:[quote]* Connect retry #1 (9003)
        • Your account has been disabled. Contact your administrator.[/quote]Description: Your ZNC has been blocked due to a violation of our rules or due to another reason.

        Solution: See the team list and contact an admin.

      If your problem isn't described here, don't worry and don't hesitate to contact our support for help.