Use your own Discord bot

With the branded bot add-on, everything LonexOne does in Discord comes from a bot you own, with your community's name and picture. Members see your bot giving out roles, setting nicknames, posting logs and sending messages, not LonexOne's.

Your bot does everything LonexOne's bot does:

• Gives out and removes roles, and sets nicknames from the roster.
• Posts logs, news, applications and training sessions to your channels.
• Sends members their Discord messages.
• Tracks time in voice patrol channels as shifts.
• Answers the /player and /action commands and the attendance buttons on training sessions.

Before you start#

• Only the community's owner can add it.
• It costs $5 a month, added to the invoice you already get on the 1st. The rest of the current month is charged on your next invoice.
• If your plan is sponsored, you'll be asked to add a card first.
• Connect your Discord servers first. See Connect your Discord server.

Make your bot#

1. Open the Discord Developer Portal and click New Application. The name you give it is your bot's name.
2. On General Information, upload the picture you want the bot to have.
3. Open the Bot page and turn on Server Members Intent. Without it, new members don't get their roles until they visit your site.
4. Still on the Bot page, click Reset Token and copy the token. Keep it secret: anyone with it can control your bot.

You don't need to set an interactions URL or anything else in the Developer Portal.

Switch to your bot#

1. In your control panel, open Discord servers and click Your own bot. You can also get there from Billing.
2. Click Add for $5.00/month.
3. Paste the token into Bot token and click Save. LonexOne checks it with Discord first.
4. Under Your servers, click Add to server next to each server and approve it in Discord.
5. In each server, open Server Settings → Roles and drag your bot's role above every role it gives out.

Once your bot is in a server, LonexOne's bot leaves it, so the two never both change roles or log the same shift.

If your bot stops working#

If Discord stops accepting your bot, for example because the token was reset or the bot was deleted, the owner gets a Discord message from the LonexOne bot and Your own bot shows Not working. Until it's fixed, roles, nicknames, log posts and messages aren't sent. LonexOne's bot doesn't step in, so your members never see a different bot by surprise.

To fix it, reset the token in the Developer Portal and paste the new one into Replace the token. If someone removed the bot from a server, add it back with Add to server.

Switch it off#

Click Switch off under Billing on the Your own bot page. Your bot keeps working until the end of the month you've paid for, and isn't on your next invoice. You can click Keep it until then to carry on without a new charge.

Before it ends, add LonexOne's bot back to your servers from Discord servers, so roles and logs carry on.

To stop using your bot straight away, click Remove with your bot's name. LonexOne's bot is used again from then on, so add it back to your servers.

Something not working?#

Saving the token says Discord didn't accept it. Copy the token again from the Bot page. If you've lost it, click Reset Token to get a new one.

It says the bot is already used by another community. Each community needs its own bot. Make a new application in the Developer Portal.

Roles aren't being given out. Your bot's role needs to be above the roles it gives out. Drag it up in Server Settings → Roles.

New members don't get their roles straight away. Turn on Server Members Intent on the bot's Bot page in the Developer Portal.