Inhalt
Warum eine fertige JAR
Für Java installiert der Server beim Start keine Pakete und führt weder Maven noch Gradle aus. Er startet nur die JAR-Datei, die du hochlädst. Deshalb muss alles, was dein Bot braucht, in dieser Datei stehen: JDA oder Javacord, ihre Abhängigkeiten und ein Logging-Paket.
JAR mit allen Abhängigkeiten bauen
- Mit Gradle nutzt du das Shadow-Plugin und baust mit shadowJar.
- Mit Maven nutzt du das maven-shade-plugin oder das maven-assembly-plugin mit „jar-with-dependencies“.
- Im Manifest muss Main-Class auf deine Startklasse zeigen, sonst meldet Java „no main manifest attribute“.
Hochladen und eintragen
- Lade die JAR-Datei unter Dateien & Backups › Dateien hoch oder per SFTP.
- Trage unter Bot › Bot-Einstellungen bei JAR-Datei den Dateinamen ein (Standard: bot.jar). Er muss auf .jar enden.
- Wähle dort die Java-Version, mit der du gebaut hast.
- Starte den Bot. Die Konsole zeigt die Ausgaben deines Programms.

Java 17, 21 oder 25
Zur Wahl stehen Java 17, 21 und 25 (jeweils LTS). Die gewählte Laufzeit muss mindestens so neu sein wie die Java-Version, mit der du gebaut hast. Ist sie älter, startet die JVM die Klassen nicht und meldet UnsupportedClassVersionError. Baust du zum Beispiel mit Java 21, wähle Java 21 oder 25.
Arbeitsspeicher der JVM
Der Server startet java -Xms64M -XX:MaxRAMPercentage=90.0 -jar mit deiner Datei. Die JVM darf also bis zu 90 Prozent des Arbeitsspeichers deines Tarifs belegen. Zeigt die Übersicht dauerhaft fast vollen Speicher, braucht dein Bot einen größeren Tarif.
Der Token in JDA
Lies den Token mit System.getenv("DISCORD_TOKEN") und übergib ihn an JDA oder Javacord, bei JDA zum Beispiel mit JDABuilder.createDefault(System.getenv("DISCORD_TOKEN")).build(). Trage ihn im Feld Discord-Bot-Token ein, siehe Bot-Token eintragen.
Kein Beispiel-Bot, kein Git
Anders als bei Node.js und Python legt die Installation keinen Beispiel-Bot an, sondern die Datei LIES-MICH.txt mit den Schritten. Die Git-Felder gibt es bei Java nicht. Eine neue Version spielst du ein, indem du die JAR-Datei unter Dateien mit gleichem Namen ersetzt und den Bot neu startest.
Typische Meldungen bei Java
- JAR-Datei … nicht gefunden: Der Name in den Bot-Einstellungen passt nicht zur hochgeladenen Datei. Der Server bleibt an, startet aber den Bot nicht.
- no main manifest attribute: Die JAR hat keine Main-Class. Baue sie mit Shadow oder Shade.
- UnsupportedClassVersionError: Die gewählte Java-Version ist älter als die Version, mit der du gebaut hast.
- NoClassDefFoundError: Eine Bibliothek fehlt in der JAR, weil sie beim Bauen nicht mit eingepackt wurde.
Fertige Vorlage auf GitHub
Als Ausgangspunkt gibt es eine freie Vorlage für Java (JDA): discord-bot-starter-java. Sie enthält Slash-Befehle, Beispielbefehle, ein Dockerfile und eine ausführliche Anleitung auf Deutsch (MIT-Lizenz). Du kannst sie auch ohne VentroHosting nutzen.
Häufige Fragen
Gibt es für Java einen Beispiel-Bot?
Nein. Java-Bots müssen vor dem Start gebaut werden; deshalb lädst du deine fertige JAR-Datei hoch. Die Datei LIES-MICH.txt auf dem Server fasst die Schritte zusammen.
Wie aktualisiere ich meinen Java-Bot?
Lade die neue JAR-Datei unter Dateien hoch, ersetze die alte mit gleichem Namen und starte den Bot neu.
Wie viel Arbeitsspeicher darf mein Java-Bot nutzen?
Die JVM darf bis zu 90 Prozent des Arbeitsspeichers deines Tarifs belegen. Braucht dein Bot mehr, wechselst du in der Übersicht unter „Laufzeit & Tarif“ auf einen größeren Tarif.
Unsere Empfehlung: Bot Plus
1 GB RAM für 2,99 € pro 30 Tage, ohne Abo. Nach der Bezahlung wird der Server automatisch eingerichtet.