Economy- und Levelsystem mit Discord.js erstellen
In dieser Anleitung erweitern Sie Ihren discord.js-v14-Bot um ein Levelsystem, in dem Mitglieder beim Schreiben von Nachrichten XP (Erfahrungspunkte) sammeln, sowie um ein Economy-System mit Befehlen für die tägliche Belohnung, das Senden von Coins (virtuelle Währung innerhalb des Servers) und eine Rangliste. Da die Daten in SQLite gespeichert werden, gehen sie bei einem Neustart des Bots nicht verloren; Schutzmaßnahmen gegen XP-Farming per Spam, negative Kontostände und Datenverlust sind bereits im Code enthalten.
Bevor Sie beginnen
- Ein funktionierender Bot: Die Anleitung baut auf der Struktur aus Discord-Bot mit Discord.js v14 von Grund auf erstellen auf: Der Ordner
commands/,deploy-commands.js,.env,npm startundnpm run deploymüssen vorhanden sein. - Node.js: Verwenden Sie die aktuelle LTS-Version (Long Term Support); die aktuelle Version des Pakets
better-sqlite3erfordert mindestens Node.js 22 (node -v). - Projektpfad: Damit es keine Probleme gibt, falls das Paket kompiliert werden muss, verlangt die Dokumentation von better-sqlite3 einen Projektpfad ohne Leerzeichen; auch Sonderzeichen wie
%,$können Probleme verursachen. Geeignete Pfade sind zum Beispiel unter WindowsC:\botlar\discord-bot, unter Linux/home/bot/discord-bot. - Berechtigungen: Die Berechtigung „Kanal ansehen“ in den Kanälen, in denen XP vergeben werden, „Nachrichten senden“ für die Level-Ankündigung und „Rollen verwalten“ (Manage Roles) für Rollenbelohnungen.
- Unterbrechungsfreier Betrieb: XP werden nur gesammelt, solange der Bot läuft; deshalb ist es sinnvoll, den Bot auf einem VDS zu betreiben. Die Pakete von Discord Bot VDS bieten 4 CPU, 2–4 GB RAM und 30–40 GB NVMe-Speicher.
1. better-sqlite3 installieren und die Datenbank vorbereiten
Variablen liegen im Arbeitsspeicher und werden bei jedem Neustart des Bots gelöscht; XP und Kontostand müssen deshalb in eine Datenbank geschrieben werden. better-sqlite3 arbeitet mit einer einzigen Datei, benötigt keinen separaten Datenbankserver, führt Abfragen synchron aus (das Ergebnis kommt direkt zurück, ohne await zu benötigen) und unterstützt Transaktionen. Führen Sie im Projektordner denselben Befehl aus, unter Windows in PowerShell, unter Linux in der SSH-Sitzung:
npm install better-sqlite3
Das Paket wird für gängige Plattformen vorkompiliert ausgeliefert; bei den meisten Installationen sind keine Build-Tools nötig. Legen Sie im Stammverzeichnis des Projekts die Datei db.js an:
const path = require('node:path');
const Database = require('better-sqlite3');
const db = new Database(path.join(__dirname, 'veri.db'));
db.pragma('journal_mode = WAL');
db.exec(`CREATE TABLE IF NOT EXISTS uyeler (
guild_id TEXT NOT NULL,
user_id TEXT NOT NULL,
xp INTEGER NOT NULL DEFAULT 0, -- Fortschritt im aktuellen Level
seviye INTEGER NOT NULL DEFAULT 0,
bakiye INTEGER NOT NULL DEFAULT 0,
son_xp INTEGER NOT NULL DEFAULT 0, -- Zeitstempel (ms)
son_gunluk INTEGER NOT NULL DEFAULT 0,
PRIMARY KEY (guild_id, user_id)
)`);
const ekle = db.prepare(`INSERT INTO uyeler (guild_id, user_id) VALUES (?, ?)
ON CONFLICT (guild_id, user_id) DO NOTHING`);
const oku = db.prepare('SELECT * FROM uyeler WHERE guild_id = ? AND user_id = ?');
// Legt den Eintrag an, falls er fehlt, und gibt immer die aktuelle Zeile zurück
function uye(guildId, userId) {
ekle.run(guildId, userId);
return oku.get(guildId, userId);
}
module.exports = { db, uye };
Für jedes Mitglied wird auf jedem Discord-Server (Guild) eine eigene Zeile geführt; die Economys verschiedener Server vermischen sich nicht. Discord-IDs sind 64-Bit-Werte, die JavaScript-Zahlen nicht exakt darstellen können; deshalb werden sie als TEXT gespeichert. __dirname sorgt dafür, dass immer dieselbe Datei veri.db verwendet wird, egal aus welchem Ordner der Bot gestartet wird. WAL (Write-Ahead Logging) ist der Modus, den die Dokumentation für die Performance empfiehlt; löschen Sie die daneben entstehenden Dateien veri.db-wal und veri.db-shm nicht. Weitere Optionen finden Sie in der Anleitung Datenbanken in Discord-Bots.
2. XP für Nachrichten vergeben
Legen Sie im Stammverzeichnis des Projekts die Datei xp.js an. Ist die Wartezeit abgelaufen, gibt der Code dem Mitglied zufällig 15–25 XP; erreichen die XP die Schwelle gerekenXp(s), zieht der Code die Schwelle ab, lässt das Mitglied ein Level aufsteigen und vergibt Coins:
const { Events } = require('discord.js');
const { db, uye } = require('./db');
const AYAR = {
xpMin: 15,
xpMax: 25,
beklemeMs: 60_000, // höchstens einmal pro Minute XP für dasselbe Mitglied
seviyeParasi: 50, // Coins pro Levelaufstieg
rolOdulleri: { 5: 'Aktives Mitglied', 10: 'Stammgast' },
};
const gerekenXp = (s) => 5 * s * s + 50 * s + 100;
const kaydet = db.prepare(`UPDATE uyeler
SET xp = ?, seviye = ?, bakiye = bakiye + ?, son_xp = ?
WHERE guild_id = ? AND user_id = ?`);
async function mesajIsle(message) {
if (message.author.bot || !message.inGuild()) return;
const simdi = Date.now();
const k = uye(message.guildId, message.author.id);
if (simdi - k.son_xp < AYAR.beklemeMs) return;
let xp = k.xp + AYAR.xpMin + Math.floor(Math.random() * (AYAR.xpMax - AYAR.xpMin + 1));
let seviye = k.seviye;
while (xp >= gerekenXp(seviye)) {
xp -= gerekenXp(seviye);
seviye++;
}
const odul = (seviye - k.seviye) * AYAR.seviyeParasi;
kaydet.run(xp, seviye, odul, simdi, message.guildId, message.author.id);
if (seviye === k.seviye) return;
await message.channel
.send(`${message.author} hat Level ${seviye} erreicht und ${odul} Coins erhalten!`)
.catch(console.error);
const rolAdi = AYAR.rolOdulleri[seviye];
const rol = rolAdi && message.guild.roles.cache.find((r) => r.name === rolAdi);
if (rol && message.member) await message.member.roles.add(rol);
}
function xpSistemi(client) {
// Datenbank- oder Berechtigungsfehler sollen den Bot nicht abstürzen lassen, sondern protokolliert werden
client.on(Events.MessageCreate, (message) => {
mesajIsle(message).catch(console.error);
});
}
module.exports = { xpSistemi, gerekenXp };
index.js: Nehmen Sie GuildMessages in die Intent-Liste auf und binden Sie das System vor der Zeile client.login ein:
const { xpSistemi } = require('./xp');
const client = new Client({
intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages],
});
xpSistemi(client);
GuildMessages ist kein privilegierter (privileged) Intent. Da wir den Nachrichtentext nicht lesen, wird auch MessageContent nicht benötigt: Ohne diese Berechtigung kommt das Nachrichtenereignis trotzdem an, nur die Inhaltsfelder sind leer. Auch das offizielle Währungssystem-Beispiel der discord.js-Anleitung verwendet nur Guilds und GuildMessages. Wenn Sie einen Filter hinzufügen, der den Inhalt prüft, etwa um kurzen Nachrichten keine XP zu geben, müssen Sie im Code GatewayIntentBits.MessageContent ergänzen und im Developer Portal auf der Seite „Bot“ im Abschnitt „Privileged Gateway Intents“ den Schalter „Message Content Intent“ aktivieren. Ist der Schalter deaktiviert, kann sich ein Bot, der diesen Intent anfordert, wegen des Fehlers [DisallowedIntents] nicht verbinden; Bots auf 100 oder mehr Servern benötigen für diese Berechtigung eine Freigabe von Discord.
Nachrichten von Bots werden nicht gezählt, und dasselbe Mitglied erhält höchstens einmal pro Minute XP; 20 Nachrichten, die innerhalb einer Minute hintereinander geschrieben werden, zählen als eine Nachricht. Da der Zeitpunkt für die Wartezeit in der Datenbank gespeichert wird, wird er auch bei einem Neustart des Bots nicht zurückgesetzt. Weil zwischen Lesen und Schreiben kein await steht, können zwei Nachrichten, die beim selben Bot-Prozess eintreffen, ihre Aktualisierungen nicht gegenseitig überschreiben. Ein im Event-Listener nicht abgefangener Fehler (ein abgelehntes Promise) kann den Node.js-Prozess beenden; deshalb werden Fehler in mesajIsle mit .catch(console.error) protokolliert.
3. Rollenbelohnungen einrichten
rolOdulleri ist eine Zuordnung „Level: Rollenname“. Legen Sie die Rollen vorher auf dem Server an; der Bot sucht im Cache, den der Intent Guilds füllt, nach der Rolle mit dem passenden Namen. Wenn Sie den Namen einer Rolle ändern, passen Sie ihn deshalb auch im Code an. In der Rollenhierarchie von Discord kann der Bot nur Rollen vergeben, die unterhalb seiner eigenen höchsten Rolle liegen. Verschieben Sie die Rolle des Bots in der Rollenliste unter „Servereinstellungen“ → „Rollen“ über die Belohnungsrollen. Die Rolle wird nur in dem Moment vergeben, in dem das Level erreicht wird; eine Belohnung, die Sie später zur Liste hinzufügen, erhalten Mitglieder, die dieses Level bereits überschritten haben, nicht automatisch. Details finden Sie in der Discord-Dokumentation zu Berechtigungen.
4. Economy-Befehle hinzufügen
Der Befehlslader der Vorlage liest jeden Ordner unter commands; legen Sie den Ordner commands/ekonomi an. gunluk.js vergibt alle 24 Stunden 100 Coins und zeigt einem Mitglied, das noch warten muss, die verbleibende Zeit in einer nur für dieses sichtbaren (ephemeral) Antwort an:
const { SlashCommandBuilder, MessageFlags, time, TimestampStyles } = require('discord.js');
const { db, uye } = require('../../db');
const GUN = 24 * 60 * 60 * 1000;
const MIKTAR = 100;
const ode = db.prepare(`UPDATE uyeler SET bakiye = bakiye + ?, son_gunluk = ?
WHERE guild_id = ? AND user_id = ?`);
module.exports = {
data: new SlashCommandBuilder().setName('gunluk').setDescription('Vergibt die tägliche Coin-Belohnung.'),
async execute(interaction) {
if (!interaction.inGuild()) return interaction.reply('Funktioniert nur auf Servern.');
const k = uye(interaction.guildId, interaction.user.id);
const simdi = Date.now();
if (simdi - k.son_gunluk < GUN) {
const sonraki = time(new Date(k.son_gunluk + GUN), TimestampStyles.RelativeTime);
return interaction.reply({ content: `Nächste Belohnung: ${sonraki}`, flags: MessageFlags.Ephemeral });
}
ode.run(MIKTAR, simdi, interaction.guildId, interaction.user.id);
await interaction.reply(`${MIKTAR} Coins gutgeschrieben. Kontostand: ${k.bakiye + MIKTAR}`);
},
};
gonder.js führt Abbuchung und Gutschrift in einer einzigen Transaktion aus: Wird in der Funktion ein Fehler geworfen, macht better-sqlite3 alle Änderungen rückgängig. Die Transaktionsfunktion darf nicht async sein; verwenden Sie darin kein await. Die Bedingung bakiye >= ? verhindert negative Kontostände auf Datenbankebene; setMinValue(1) verhindert auf Discord-Seite die Eingabe von null oder negativen Beträgen.
const { SlashCommandBuilder, MessageFlags } = require('discord.js');
const { db, uye } = require('../../db');
const dus = db.prepare(`UPDATE uyeler SET bakiye = bakiye - ?
WHERE guild_id = ? AND user_id = ? AND bakiye >= ?`);
const ekle = db.prepare('UPDATE uyeler SET bakiye = bakiye + ? WHERE guild_id = ? AND user_id = ?');
const transfer = db.transaction((guildId, gonderen, alici, miktar) => {
uye(guildId, alici);
if (dus.run(miktar, guildId, gonderen, miktar).changes === 0) throw new Error('YETERSIZ');
ekle.run(miktar, guildId, alici);
});
module.exports = {
data: new SlashCommandBuilder()
.setName('gonder')
.setDescription('Sendet Coins an ein anderes Mitglied.')
.addUserOption((o) => o.setName('kisi').setDescription('Empfänger').setRequired(true))
.addIntegerOption((o) => o.setName('miktar').setDescription('Betrag').setRequired(true).setMinValue(1)),
async execute(interaction) {
if (!interaction.inGuild()) return interaction.reply('Funktioniert nur auf Servern.');
const hedef = interaction.options.getUser('kisi');
const miktar = interaction.options.getInteger('miktar');
const gizli = (content) => interaction.reply({ content, flags: MessageFlags.Ephemeral });
if (hedef.bot || hedef.id === interaction.user.id) return gizli('Ungültiger Empfänger.');
try {
transfer(interaction.guildId, interaction.user.id, hedef.id, miktar);
} catch (e) {
if (e.message !== 'YETERSIZ') throw e;
return gizli('Ihr Kontostand reicht nicht aus.');
}
await interaction.reply(`${interaction.user} → ${hedef}: ${miktar} Coins`);
},
};
profil.js und siralama.js sind wie gunluk.js aufgebaut (data und execute); db und uye holen Sie mit require('../../db'). profil.js liest mit uye() die Zeile und zeigt Level, Fortschritt xp/gerekenXp(seviye) und Kontostand als Antwort an; gerekenXp holen Sie mit require('../../xp'). In siralama.js verhindert allowedMentions: { parse: [] }, dass die Mitglieder in der Liste benachrichtigt werden:
// commands/ekonomi/siralama.js – innerhalb von execute
const satirlar = db
.prepare(`SELECT user_id, seviye, bakiye FROM uyeler
WHERE guild_id = ? ORDER BY seviye DESC, xp DESC LIMIT 10`)
.all(interaction.guildId)
.map((r, i) => `${i + 1}. <@${r.user_id}> | Level ${r.seviye} | ${r.bakiye} Coins`);
await interaction.reply({ content: satirlar.join('\n') || 'Noch keine Einträge.', allowedMentions: { parse: [] } });
Registrieren Sie anschließend die Befehle mit npm run deploy und starten Sie den Bot neu. Details finden Sie in der Anleitung Slash-Befehle (/) hinzufügen.
5. Die Datenbank sichern
Bei VDS-Diensten sind automatische Backups nicht enthalten; geht veri.db verloren, sind alle Level und Kontostände weg. Verwenden Sie statt des Kopierens der laufenden Datei die Methode backup(); laut Dokumentation kann die Datenbank während des Backups weiter genutzt werden. Fügen Sie in index.js die Zeile const { db } = require('./db'); hinzu (fs und path sind in der Vorlage bereits definiert):
// am Ende von index.js: alle 24 Stunden ein Backup
const yedekKlasoru = path.join(__dirname, 'yedekler');
fs.mkdirSync(yedekKlasoru, { recursive: true });
setInterval(() => {
db.backup(path.join(yedekKlasoru, `veri-${Date.now()}.db`)).catch(console.error);
}, 24 * 60 * 60 * 1000);
Das erste Backup wird 24 Stunden nach dem Start des Bots erstellt. Löschen Sie alte Backups von Zeit zu Zeit und lagern Sie Kopien außerhalb des Servers; eine geeignete Möglichkeit ist, sie per SFTP in den Cloud-Backup-Speicher hochzuladen.
Beispieleinstellungen und Levelkurve
| Einstellung | Beispielwert | Wirkung |
|---|---|---|
xpMin / xpMax | 15 / 25 | XP pro gezählter Nachricht; durchschnittlich 20 |
beklemeMs | 60000 | Mindestens 1 Minute zwischen zwei XP-Vergaben an dasselbe Mitglied |
seviyeParasi | 50 | Coins pro Level |
MIKTAR (gunluk.js) | 100 | Tägliche Belohnung |
gerekenXp(s) | 5s² + 50s + 100 | Wie schnell die Schwelle mit dem Level steigt |
Mit diesen Werten sieht der Fortschritt des aktivsten Mitglieds, dessen Nachrichten einmal pro Minute gezählt werden, ungefähr so aus:
| Level | Schwelle des letzten Schritts | XP gesamt | Gezählte Nachrichten | Kürzeste Dauer |
|---|---|---|---|---|
| 1 | 100 | 100 | ≈5 | ≈5 Minuten |
| 5 | 380 | 1.150 | ≈58 | ≈1 Stunde |
| 10 | 955 | 4.675 | ≈234 | ≈4 Stunden |
| 20 | 2.855 | 23.850 | ≈1.193 | ≈20 Stunden |
| 30 | 5.755 | 67.525 | ≈3.376 | ≈56 Stunden |
Erhöhen Sie auf aktiven Servern den Wert beklemeMs oder die Koeffizienten; senken Sie in kleinen Communitys die Schwellen.
Häufige Fehler
- Die XP steigen überhaupt nicht: Fehlt
GuildMessagesin der Intent-Liste oder darf der Bot den Kanal nicht sehen, kommt das Nachrichtenereignis nicht an. Ist beides in Ordnung, denken Sie an die Wartezeit: Beim Testen wird nur eine Nachricht pro Minute gezählt. TypeError: db.add is not a function: Ältere Beispiele, einschließlich der früheren Version dieser Seite, nutzen die alte synchrone API von quick.db. Im aktuellen quick.db wird eine Instanz mitconst { QuickDB } = require('quick.db')erstellt, die Methoden erfordernawait, undbetter-sqlite3wird separat installiert. Der Code in dieser Anleitung verwendet quick.db nicht; statt alten Code zu portieren, ist es einfacher, auf die hier gezeigte Struktur umzusteigen.- Die Installation von better-sqlite3 meldet einen node-gyp-Fehler: Dieser Fehler tritt auf, wenn keine vorkompilierte Datei gefunden wird und das Paket kompiliert werden soll. Prüfen Sie die Node.js-Version (mindestens 22) und den Projektpfad. Löschen Sie unter Windows
node_modulesund den Ordner.node-gypin Ihrem Benutzerordner und installieren Sie neu; fehlen Build-Tools, führen Sieinstall_tools.batim Node.js-Ordner aus. DiscordAPIError[50013]: Missing Permissions: Tritt der Fehler beim Vergeben einer Rolle auf, steht die Rolle des Bots unter der Belohnungsrolle oder ihm fehlt die Berechtigung „Rollen verwalten“; tritt er bei der Ankündigung auf, darf der Bot in diesem Kanal keine Nachrichten senden.- Die Daten wurden zurückgesetzt: Wurde der Pfad relativ (
'veri.db') angegeben, entsteht eine neue, leere Datei, wenn der Bot aus einem anderen Ordner gestartet wird. Verwenden Sie__dirnameund verschieben Sie die alte Datei an die richtige Stelle. SQLITE_BUSY(database is locked) oder doppelte Level-Nachricht: Es laufen zwei Instanzen des Bots gleichzeitig (z. B. eine in PM2 und eine in einem offenen Terminal). SQLite erlaubt jeweils nur einen schreibenden Zugriff; beenden Sie die überzählige Instanz.
Häufig gestellte Fragen
quick.db, better-sqlite3 oder MongoDB?
Für einen Bot, der auf einem einzigen VDS läuft, reicht SQLite aus. Auch quick.db läuft standardmäßig auf better-sqlite3, sein GitHub-Repository ist jedoch archiviert (schreibgeschützt), es sind also keine neuen Versionen und Fehlerbehebungen zu erwarten; in einem neuen Projekt ist es solider, better-sqlite3 direkt zu verwenden. Wenn Sie den Bot auf mehreren Maschinen betreiben wollen, wechseln Sie zu einem Datenbankserver wie PostgreSQL, MySQL oder MongoDB.
Kann ich XP für die Zeit im Sprachkanal vergeben?
Ja. Fügen Sie den Intent GuildVoiceStates hinzu und lauschen Sie auf das Ereignis Events.VoiceStateUpdate; speichern Sie den Zeitpunkt, wenn ein Mitglied den Kanal betritt, und fügen Sie beim Verlassen XP pro Minute hinzu. Wenn Sie den Eintrittszeitpunkt in der Datenbank statt im Arbeitsspeicher speichern, geht die Zeit bei einem Neustart des Bots nicht verloren.
Wie füge ich einen Shop hinzu?
urunler und envanter: Legen Sie diese Tabellen an und führen Sie beim Kauf das Abbuchen vom Kontostand und das Hinzufügen zum Inventar wie bei /gonder in einer einzigen Transaktion aus. Das offizielle Währungssystem-Beispiel in der discord.js-Anleitung zeigt die Shop-Logik mit Sequelize. Um ein Produkt aus einer Liste auswählen zu lassen, können Sie die Menüstruktur aus der Anleitung Buttons und Auswahlmenüs (Select Menu) verwenden nutzen.
Verwandte Anleitungen
- Discord-Bot mit Discord.js v14 von Grund auf erstellen
- Slash-Befehle (/) mit Discord.js v14 hinzufügen
- Datenbanken in Discord-Bots: SQLite, PostgreSQL, MySQL, MongoDB
- Discord-Bot 24/7 auf dem VDS online halten: PM2, systemd und NSSM
- Buttons und Auswahlmenüs (Select Menu) in Discord.js v14 verwenden
Weitere Bot-Anleitungen finden Sie auf der Seite Discord-Bot-Anleitungen.
Kommentare0
Noch keine Kommentare
Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.
Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.