Je Discord-bot uploaden en starten

Je zet je bot online door je bestanden te uploaden, je token in een .env-bestand te zetten en de server je pakketten te laten installeren. Daarna start je hem in de console. Dit artikel gaat uit van een bot in Node.js met discord.js; de verschillen voor Python en Java staan in de vragen onderaan.

Wat heb je nodig?

• Je botcode met een package.json, en package-lock.json als je die hebt.
• Het token van je bot uit het Discord Developer Portal.
• De naam van je startbestand, bijvoorbeeld index.js.

Welke taal en versie kies je?

Open je bot in het gamepanel en ga naar Startup. Kies onder Discord Bot Runtime voor Node.js Bot; het gamepanel zet dan zelf de juiste Docker Image. Kies bij Docker Image Node.js 24 of 26: volgens de eigen documentatie vraagt discord.js 14.27 om Node.js 24.17.0 of nieuwer. Vul bij Startup File je startbestand in.

Hoe upload je je bestanden?

1. Ga naar File managers, klik op Upload en kies Upload Folder voor je projectmap. Via SFTP kan het ook.
2. Zorg dat package.json in de hoofdmap staat.
3. Upload de map node_modules niet. Die maakt de server zelf.

Hoe bewaar je je token veilig?

Zet je token nooit in je code. Open Bot Studio en kies Env Editor. Klik op Add Variable, noem hem TOKEN, plak je token als waarde en klik op Save .env. Zo komt het in het bestand .env in de hoofdmap. In je code laad je het met het pakket dotenv: require('dotenv').config(), en daarna gebruik je process.env.TOKEN.

Hoe installeer je je pakketten en start je de bot?

1. Ga naar Settings en kies Reinstall Server. Je eigen bestanden blijven staan.
2. De server leest je package.json en installeert je pakketten. Met een package-lock.json krijg je precies de versies daaruit.
3. Ga naar Console en klik op Start als de installatie klaar is.
4. Zie je de melding die je bot bij het inloggen geeft, bijvoorbeeld Logged in as ..., dan is hij online. Hij blijft draaien als je het gamepanel sluit.

Bijwerken gaat zo: stop je bot, upload de gewijzigde bestanden en start weer. Heb je pakketten toegevoegd in package.json, doe dan eerst opnieuw Reinstall Server.

Wat doe je als je bot niet start?

Alles wat je bot meldt, zie je in de console. Zoek de eerste foutmelding. Staat er Cannot find module met de naam van je eigen startbestand, dan klopt Startup File niet. Staat er de naam van een pakket, dan is de installatie niet gelukt: doe Reinstall Server opnieuw en kijk in de console waar het misgaat. Over intents en foutcodes van Discord lees je meer in Je Discord-bot 24/7 online houden.

Welke fouten maken mensen vaak?

• node_modules van je eigen computer uploaden. Onze bots draaien op Linux-servers met ARM-processors. Pakketten met eigen gecompileerde code van een Windows-pc werken daar niet. Laat de server ze installeren.
• Pakketten onder devDependencies. Die slaat de installatie over. Zet wat je bot nodig heeft onder dependencies.
• Je token in je code of op GitHub. Is hij uitgelekt, klik dan in het Discord Developer Portal op Reset Token en zet het nieuwe token in .env.