Documentation
Your own bot
Create a Discord application, switch on the intents Graffiti needs, and run Graffiti under your own name and avatar.
A custom bot is a Discord application you create and own. Graffiti signs in as it and serves your server through it, with every module and setting exactly as before. It's part of Premium. Setup takes about five minutes, once.
1. Create the application
- Open the Discord Developer Portal and choose New Application. The name you give it is the name your members see.
- On General Information, add an app icon and a description. The icon becomes the bot's avatar.
2. Switch on the intents
Go to the Bot page and scroll to Privileged Gateway Intents. Switch on all three:
| Intent | Needed? | Why |
|---|---|---|
| Presence Intent | Recommended | Not used today. Switching it on now saves a trip back here if a future feature needs it. |
| Server Members Intent | Required | Welcomes, auto-roles, and spotting your bot arriving in your server. |
| Message Content Intent | Required | Link protection, anti-spam, counting and text commands all read messages. |
A bot with Message Content Intent switched off signs in perfectly and then silently does nothing. If your bot is online but ignoring scam links, check this first.
3. Copy the token
Still on the Bot page, press Reset Token and copy it. Discord shows it once. Treat it like a password: anyone with it can sign in as your bot.
4. Connect it to Graffiti
- On the dashboard, open your server and choose Custom bot.
- Paste the token and press Connect bot. Graffiti checks it with Discord, stores it encrypted, and never shows it again.
- Press Invite and add the bot to your server. There's nothing to confirm afterwards: the page notices the bot arriving and finishes by itself.
Once your bot is in, the server is assigned to it and Graffiti goes quiet there. Change the bot's status and status text from the same page; it applies immediately. The name and avatar come from the Developer Portal.
If something goes wrong
- Offline: Graffiti can't sign in as your bot. The token was probably reset; paste the new one under Replace the token. Graffiti serves your server in the meantime.
- Not in server: the bot is signed in but isn't in your server. Use the invite button again.
- Online but doing nothing: an intent is off. See step 2.
Removing the custom bot from the page hands the server straight back to Graffiti, with every setting kept.