GettingStarted

Bryan Drewery edited this page Jan 5, 2018 · 19 revisions

Overview

Wraith uses HUBs to link leaf bots together. Only the leaf bots connect to IRC. Bots have 2 configurations, the PackConfig and the BotConfig. The PackConfig defines what pack it is, what hubs you have, who the owner is and your encryption keys. Your first task is to create 1 PackConfig and to save this somewhere safe. Next you will setup your hubs. Then you will setup the leaf bots. If you follow all of the directions and suggestions, you should be finished very quickly.

Wraith binaries are 'initialized' with a PackConfig and can never be re-initialized. This binds the binary to your botnet. After the binary is initialized, you configure its BotConfig to tell the binary what bots and vhosts it should use from that shell.

From there, you can control your entire botnet via telnetting directly to a HUB. You can also .relay to a hub via a leaf bot, and get on a (+c chathub) leaf bot via DCC chat. Once on a hub, most commands control the net as a whole. For example, '''+chan''', '''+user''' and '''chanset''' will automatically sync all changes with all other bots on the botnet. Controlling individual bots can be achieved with '''botcmd.''' All commands are documented in '''help.'''

Configure a PackConfig

Create a pack.cfg according to http://wraith.botpack.net/wiki/PackConfig. This should contain only a list of hubs you plan to setup and should remain the same for every bot that you setup. This is a 1-time step. Save this file somewhere safe as you will need it for every bot you setup in the future.

Setup Hubs

Do this on each shell that you want to run a hub on.

  1. Download or compile a wraith binary for use as a hub with ./configure && make && cp wraith hub
  2. Initialize the binary with your PackConfig
$ ./hub -Q
[now paste in your pack config when prompted]
  1. Enter bot config
$ export EDITOR=nano
or
$ setenv EDITOR nano
$ ./hub -C
  1. Enter binary password
  2. Add the hub information at the top or bottom. Nothing else needs to change.
hubnick IP
  1. Save+exit
  2. Run hub
$ ./hub
[pack] -hub- initiated (42371)

Connect to Hub

  1. Telnet This should be done over SSH on a local connection to the hub's system.
telnet hubip hubport
  1. When presented with a blank link, enter your username and then your password
myusername
Enter your password
[password]
Connected to hub, running [pack] Wraith v1.4.3-385-g9fe105a(d) (1365199376)
  1. Set your console settings
.console +mcobeus

Setup Leaf bots

Do this on each shell you want to run bots on.

  1. Download or compile a wraith binary for use a leaf with ./configure && make
  2. Initialize the binary with your PackConfig
$ ./wraith -Q
[now paste in your pack config when prompted]
  1. Enter bot config
$ export EDITOR=nano
or
$ setenv EDITOR nano
$ ./wraith -C
  1. Enter binary password
  2. Add each bot that should run on this shell only
botnick IP
botnick2 IP2
  1. Save+exit
  2. Run bots
$ ./wraith
[pack] -botnick- initiated (41552)
[pack] -botnick2- initiated (34723)
  1. Look on Hub connection, it will tell you what to do to add the leaf bot.
[16:15:57] Telnet connection: somehost.com[10.11.23.54]/18424
[16:15:58] Refused bryan@somehost.com (invalid bot handle: botnick) (Add with '.newleaf botnick -telnet!bryan@somehost.com')
.newleaf botnick -telnet!bryan@somehost.com
Added new leaf: botnick
Added host '-telnet!bryan@somehost.com' to leaf: botnick
Bot config line (prefix host with '+' if ipv6):
botnick * somehost.com
Saving userfile...
[16:16:44] Telnet connection: somehost.comg[10.11.23.54]/19044
[16:16:45] Sending encrypted link handshake to botnick...
[16:16:45] Linked to botnick.
*** Linked to botnick.
  1. The bot will automatically connect to EFNet

Next steps

  1. Read over the help for hub-only commands
.help
  1. Read over leaf-only commands
.bl help
  1. Read over help for channel flags, user flags, and settings
.help chaninfo
.help whois
.help set
  1. Assign some bots to do DNS lookups on hosts to match bans, handle floods, handle limits, assign voices/ops. Note that this will no longer be needed in 1.5.
.chattr somebot +rfly
  1. Assign a bot to allow DCC Chat
.chattr somebot +c
  1. Customize your botnet
.set realname This is the realname all bots will use
.chanset default +voice
.chattr myuser +v

IRC

If you have any further questions feel free to ask in #wraith on EFnet. Be warned though that we expect that you have read all of the necessary documentation first.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.