Getting Started

Adding NullKit to your server

Sign in with Discord, pick a server and invite the bot.

Adding NullKit takes two steps. Sign in with Discord so the dashboard knows which servers you run, then invite the bot to one of them.

Before you start#

You need the Manage Server permission in the server you want to add NullKit to, or you need to own it. The dashboard only ever lists servers where one of those is true, so if a server is missing from your list, that is almost always why.

Sign in#

Press Continue with Discord anywhere on the site.

Discord will ask you to authorise NullKit. The sign-in requests two things: your basic profile, and the list of servers you are in. It does not give the site access to your messages, and it never posts as you.

Once you are back, you land on your server list.

Your server list#

The list is split in two.

  • Servers with NullKit installed. Select one to open its dashboard.
  • Servers without it. Each has an Add NullKit button.

The list is fetched from Discord rather than stored, so a server you were given access to a minute ago appears after a refresh. Opening that server's dashboard can lag slightly behind the list, by up to a minute.

Invite the bot#

Add NullKit opens Discord's authorisation screen for that one server, with the server already selected so you cannot add it to the wrong place by accident.

NullKit asks for the Administrator permission.

Administrator is a broad permission: it lets the bot do anything in the server. That is what the invite link currently requests. If it is more than you want to grant, you can reduce the bot's role in Server Settings → Roles after it joins, but features that need a permission you removed will stop working.

Three permissions are worth knowing about, because losing them makes a feature fail quietly rather than show an error:

  • Manage Server lets the bot read your invite list. Without it, invite rewards cannot tell who invited whom, and every join records as unattributed.
  • Create Private Threads is needed in the channels you use for tickets and for applications. Both of those open as private threads.
  • Add Reactions is needed in a counting channel.

After it joins#

The bot records the server the moment it joins. Go back to your server list, refresh, and it will have moved into the installed group. Select it to open the dashboard.

NullKit does not build anything in your server by itself. There are no ticket categories, no panels posted and no application types until you create them. Other settings start on their defaults, which the dashboard shows you.

Next: The dashboard.