Bir Discord4J botunu 24/7 barındırmak için onu hep açık kalan bir makinede çalıştırırsınız: durduğunda botu yeniden başlatan bir systemd servisi olan Linux VPS'te ya da PlayNHost Discord bot barındırma hizmetindeki bir bot planında (ayda US$1,99'dan başlayan fiyatlarla). Orada çalıştırılabilir tek bir jar yükler, token'ı yapıştırır ve Başlat'a basarsınız. Testimizde Discord4J 3.3.3 ile yazılmış bir bot Java 21'de yaklaşık 126 MB bellek kullandı ve başlatıldıktan 2,6 saniye sonra Discord'un yanıtını aldı. Discord4J bir kütüphanedir, program değildir; bu yüzden botunuzu önce kendi bilgisayarınızda bir jar'a derlersiniz. PlayNHost'taki adımlar:
- Discord bot barındırma sayfasında bir planda Sunucu oluştur'a tıklayın. Sipariş penceresinde Botunuz hangi platform için? sorusuna Discord yanıtını verin ve Java'yı seçin.
- Bilgisayarınızda botu aşağıdaki
pom.xmlile derleyin:mvn package, içinde Discord4J bulunantarget/bot.jardosyasını yazar. - Sunucunuzu panelde açın. Botunuzu kurun kartı, Genel bakış sayfasında Discord’a bağlan adımında açılır. İlk adımı olan Ne çalışır, Bu bot Java Bot çalıştırır. demelidir; kontrol etmek için bu adıma tıklayın, ardından Devam et'e tıklayın.
- Discord’a bağlan adımında token'ınızı Bot token’ınızı yapıştırın alanına yapıştırın, Bağlan'a, sonra Evet, devam'a tıklayın.
- İzinler adımında, Kodum bunu kullanıyor kutusunu yalnızca kodunuzun istediği ayrıcalıklı intent'ler için işaretleyin (aşağıdaki bot hiçbirini istemez), Bir Discord sunucusuna ekle'ye, sonra Devam'a tıklayın.
- Kodunuz adımında Dosya yükle'ye tıklayın ve
bot.jardosyasını ana klasöre yükleyin. - Bot sayfasında, Kod bölmesinde Giriş dosyası'nın
bot.jar, Çalışma ortamı'nın Java 21 (recommended) olduğunu kontrol edin; Java 17 veya 25 de olabilir. Giriş dosyası'nı değiştirirseniz yanındaki Kaydet'e tıklayın; yeni bir Çalışma ortamı seçtiğiniz anda kaydedilir. - Botu başlat'a tıklayın ve Console'u izleyin. Botunuz
Logged in as ...yazdırdığında kart Botunuz Discord’da çevrimiçi. der.
Botu ve token'ını oluşturma Discord botu nasıl oluşturulur ve token’ı nasıl alınır yazısında, Java bot türü genel olarak Java Discord botu nasıl barındırılır yazısında anlatılır. Bu sayfa Discord4J'nin kendisiyle ilgilidir: bir sunucuda neyi kullandığı ve barındırmadan önce bilmeniz gerekenler.
Ne ölçtük
| Kütüphane | Sürüm | Başlangıçtan sonra bellek | Başlatmadan Discord'un yanıtına | Jar boyutu |
|---|---|---|---|---|
| Discord4J | 3.3.3 | 126 MB | 2,6 sn | 37 MB |
| JDA | 6.7.0 | 91 MB | 1,5 sn | 19 MB |
| Yalnızca Java 21, kütüphanesiz | 21.0.12.1 | 38 MB | yok | 0,0 MB |
Nasıl: kendi node'umuzda, 1 GB'lık bir bot planı gibi kurulmuş tek kullanımlık bir konteynerde (Java 21 imajı ve Java bot türümüzün tam java komutu) her bot sahte bir token'la giriş yaptı ve Discord bunu reddetti; bellek, o yanıttan 15 saniye sonraki kalıcı bellektir, başlangıç süresi başlatmadan yanıta kadar geçen süredir ve her değer 2 ile 4 arasındaki çalıştırmaların medyanıdır.
Bunlar taban değerlerdir: sunucu yok, önbellekte üye yok, henüz açık bir gateway oturumu yok. Kendi kodunuz ve botunuzun bulunduğu sunucu sayısı bunlara eklenir; başlatma betiği de Java heap'inin planın yüzde 80'ine kadar büyümesine izin verir (aşağıya bakın). Sayıları Discord bot barındırma sayfasındaki planlarla karşılaştırın ve botunuzun ne yaptığına göre seçin.
Minimal bir Discord4J botu
Bir /ping slash komutu kaydeder, ona Pong! ile yanıt verir, token'ı DISCORD_TOKEN'dan okur (panelin ona verdiği ad) ve bir hazır satırı yazdırır. Ayrıcalıklı intent gerektirmez. İki dosya:
pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>bot</artifactId>
<version>1.0</version>
<properties>
<maven.compiler.release>17</maven.compiler.release>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>com.discord4j</groupId>
<artifactId>discord4j-core</artifactId>
<version>3.3.3</version>
</dependency>
</dependencies>
<build>
<finalName>bot</finalName>
<plugins>
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<version>3.7.1</version>
<configuration>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef>
</descriptorRefs>
<appendAssemblyId>false</appendAssemblyId>
<archive>
<manifest>
<mainClass>Bot</mainClass>
</manifest>
</archive>
</configuration>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
src/main/java/Bot.java
import discord4j.core.DiscordClient;
import discord4j.core.event.domain.interaction.ChatInputInteractionEvent;
import discord4j.core.event.domain.lifecycle.ReadyEvent;
import discord4j.discordjson.json.ApplicationCommandRequest;
import discord4j.rest.http.client.ClientException;
import reactor.core.publisher.Mono;
public class Bot {
public static void main(String[] args) {
String token = System.getenv("DISCORD_TOKEN");
if (token == null || token.isBlank()) {
System.out.println("No DISCORD_TOKEN found. Paste your bot token on the Bot page, then restart.");
System.exit(1);
}
ApplicationCommandRequest ping = ApplicationCommandRequest.builder()
.name("ping")
.description("Replies with Pong!")
.build();
try {
DiscordClient.create(token).withGateway(gateway -> {
// Creating a command that already exists updates it, so this is safe on every start.
Mono<Void> register = gateway.getRestClient().getApplicationId()
.flatMap(appId -> gateway.getRestClient().getApplicationService()
.createGlobalApplicationCommand(appId, ping))
.then();
Mono<Void> ready = gateway.on(ReadyEvent.class, event -> Mono.fromRunnable(() ->
System.out.println("Logged in as " + event.getSelf().getUsername())))
.then();
Mono<Void> commands = gateway.on(ChatInputInteractionEvent.class, event -> {
if (event.getCommandName().equals("ping")) {
return event.reply("Pong!");
}
return Mono.empty();
}).then();
return register.and(ready).and(commands);
}).block();
} catch (RuntimeException e) {
if (ClientException.isStatusCode(401).test(e)) {
System.out.println("Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart.");
} else {
e.printStackTrace();
}
System.exit(1);
}
}
}
Maven 3.9 ve JDK 17 veya daha yenisiyle derleyin:
mvn package
java -jar target/bot.jar
İkinci satır bilgisayarınızda bir testtir: token olmadan No DISCORD_TOKEN found. yazdırır ve durur; bu da jar'ın başladığını ve ana sınıfını bulduğunu kanıtlar. target/bot.jar dosyasını yükleyin. maven-assembly-plugin'in jar-with-dependencies ayarı Discord4J'yi ve ihtiyaç duyduğu her şeyi bu tek jar'a koyar; Gradle kullananlar aynısını Shadow eklentisiyle elde eder. maven.compiler.release 17, panelin sunduğu üç Java sürümünün hepsinde çalışan bir jar üretir.
Logged in as ... satırı, Genel bakış sayfasındaki çipi Discord’da çevrimiçi durumuna getirir. Botu Bir Discord sunucusuna ekle ile davet edin, sonra /ping'i deneyin: Discord botunuzu bir sunucuya nasıl davet edersiniz.
Token yanlışsa
Testimizde, sahte bir token'la Discord4J'nin girişi şu hatayla başarısız oldu:
ClientException: GET /gateway/bot returned 401 Unauthorized with response {code=0, message=401: Unauthorized}
Yukarıdaki bot, reddedilen bir token'ı (HTTP 401) yakalar ve stack trace yerine Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart. yazdırır, ardından 1 çıkış koduyla durur. Sahte token'la çalıştırdığımızda önce üç SLF4J: uyarı satırı geldi; ilki SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder". ile başlıyor. Bunlar token'la değil, loglamayla ilgilidir (aşağıda Loglar'a bakın). Düzeltmek için Discord Developer Portal'ı, uygulamanızı, Bot bölümünü açın ve Reset Token'a tıklayın; Discord yeni token'ı yalnızca bir kez gösterir. Bizim Bot sayfamızda, Discord bölmesinde Token’ı değiştir'e tıklayın, token'ı yapıştırın, Token’ı kaydet'e, sonra Şimdi yeniden başlat'a tıklayın. Discord kayıtlı token'ın kontrolünü reddederse bölme Discord kabul etmedi gösterir.
Bir sunucuda Discord4J hakkında bilmeniz gerekenler
- Sürümler: Discord4J 3.3.3, 19 Ağustos 2026'da çıktı. 3.3 serisi güncel olandır, 3.2 yalnızca bakım alır. Discord4J 3.3.3 Java 8 için derlenmiştir; bu yüzden panelin sunduğu her Çalışma ortamı (Java 17, 21 veya 25) onu çalıştırır; seçtiğiniz çalışma ortamından yeni olmayan bir
releaseile derleyin. - Tek jar, sunucuya hiçbir şey kurulmaz. Java bot türünde Git kaynağı ve Paketler alanı yoktur:
java -jarkomutunu Giriş dosyası'nız üzerinde başlatır, bu yüzden botunuzun kullandığı her şey jar'ın içinde olmalıdır. Botu güncellemek için yeni bir jar yükleyin. - Bellek sınırı: başlatma betiği Java'yı
-XX:MaxRAMPercentage=80.0ve G1 çöp toplayıcıyla çalıştırır; böylece heap planınızın belleğinin yüzde 80'ine kadarını kullanabilir ve işlemin geri kalanına yer kalır. Heap dolarsa Javajava.lang.OutOfMemoryErroryazdırır ve panel Botunuzun belleği yetmedi gösterir. - Intent'ler: Discord4J, siz başkalarını seçmedikçe ayrıcalıklı olmayan tüm intent'lerle bağlanır. Discord4J README'sindeki
!pingörneği mesaj metnini okur; bu da ayrıcalıklı Message Content intent'ini gerektirir: Developer Portal'da açın, koddaDiscordClient.create(token).gateway().setEnabledIntents(IntentSet.nonPrivileged().or(IntentSet.of(Intent.MESSAGE_CONTENT)))ile isteyin ve İzinler adımımızda onun için Kodum bunu kullanıyor kutusunu işaretleyin. O olmadan Discord bota boş mesaj metni gönderir; doğrudan mesajlar ve bottan söz eden mesajlar hariç. Yukarıdaki gibi bir slash komutu bunların hiçbirine ihtiyaç duymaz. Bkz. Discord botunuzdaki "Used disallowed intents" hatasını düzeltin. - Loglar: Discord4J, jar'da SLF4J varsa SLF4J kullanan Reactor üzerinden loglar ve Discord4J, SLF4J'yi kendisiyle getirir. Arkasında bir loglama kütüphanesi yoksa, yukarıdaki
pom.xml'de olduğu gibi, SLF4J başlangıçta üç uyarı satırı yazdırır, sonuncusuSLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details., ardından Discord4J'nin kendi log satırlarını, hatalar dahil, atar.System.outsatırlarınız yine de Console'da görünür. Discord4J'nin satırlarını görmek için bir loglama kütüphanesi ekleyin; Discord4J belgeleri Logback'i önerir. main()bekletilmeli. Discord4J reaktiftir: girişi, bir şey ona abone olunca bağlanan birMono'dur. README'sindeki örneklermain()'igateway.onDisconnect().block()ile ya dablock()ile (withGateway(...)üzerinde) bitirir; bunlar bot bağlıyken bekler. Yukarıdaki botwithGateway(...).block()kullanır.- Komutları her başlangıçta kaydetmek sorun değildir. Discord, uygulamanızın zaten kullandığı bir adla komut oluşturmayı o komutun güncellenmesi sayar; bu yüzden yukarıdaki bot
/pingkopyaları biriktirmez. - Çökmeler: bot kapandığında, yukarıdaki botun reddedilen bir token'da yaptığı gibi, panel onu hemen yeniden başlatır. Bundan sonra bir dakika içinde yine durursa durmuş kalır ve Console nedenini söyler.
Linux VPS'te kendiniz barındırın
Jar'ı kendi bilgisayarınızda derlediğiniz için VPS'in yalnızca bir Java çalışma zamanına ihtiyacı vardır. Debian 13 veya Ubuntu 24.04'te Java 21 kurun; Debian 12 Java 17 ile gelir ve o da yukarıdaki jar'ı çalıştırır:
sudo apt update
sudo apt install openjdk-21-jre-headless
java -version
Bot için bir kullanıcı oluşturun ve jar'ı sunucuya kopyalayın (örneğin scp ile), sonra kendi klasörüne:
sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp bot.jar /opt/mybot/
sudo chown -R mybot: /opt/mybot
Token'ı kodunuzun dışında, yalnızca root'un okuyabildiği bir dosyada tutun:
sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env
/etc/systemd/system/mybot.service dosyasını oluşturun:
[Unit]
Description=Discord4J bot
Wants=network-online.target
After=network-online.target
[Service]
User=mybot
WorkingDirectory=/opt/mybot
EnvironmentFile=/etc/mybot.env
ExecStart=/usr/bin/java -XX:MaxRAMPercentage=80.0 -jar /opt/mybot/bot.jar
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
Şimdi ve her açılışta başlatın, sonra çıktısını izleyin:
sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f
Restart=always, bot çıktıktan veya çöktükten 5 saniye sonra onu yeniden başlatır, ama onu systemctl stop ile durdurduktan sonra başlatmaz. Bir VPS'te -XX:MaxRAMPercentage tüm makinenin belleğinden bir paydır; orada başka programlar da çalışıyorsa düşürün. Güncellemek için yeni jar'ı eskisinin üzerine kopyalayın ve sudo systemctl restart mybot çalıştırın.
Kendi sunucunuz mu, bot planı mı
Kendi yönettiğiniz bir VPS'te şunlar size aittir:
- İşletim sistemi güncellemeleri ve güvenliği, ayrıca Java yükseltmeleri.
- Her yeni jar'ı, servis dosyasını, token dosyasını ve izinlerini kopyalamak.
- Botun neden durduğunu anlamak için
journalctlokumak. - Botunuzun sakladığı her şeyin yedekleri.
Karşılığında bir VPS üzerine kurduğunuz her şeyi çalıştırır.
PlayNHost bot planında bunları panel sizin için yapar:
- Bir seçiciden Java 17, 21 veya 25; heap sınırı ve çöp toplayıcı ayarlı olarak.
- Kaydedilmeden önce Discord ile kontrol edilen, şifreli saklanan ve koduna
DISCORD_TOKENolarak verilen token. - Seçtiğiniz izinlerle bir davet bağlantısı ve Developer Portal'ınızda hangilerinin açık olduğunu kontrol eden bir Ayrıcalıklı intent’ler kartı.
- Bir çökmeden sonra botu yeniden başlatma ve belleği bittiğinde Console'un üstünde bir banner.
- Tarayıcıdan yükleme ve panelden yedekler.
Sık sorulan sorular
Discord4J botum çevrimiçi ama !ping hiçbir şey yapmıyor. Neden?
Çünkü mesaj metni boş. Discord4J varsayılan olarak yalnızca ayrıcalıklı olmayan intent'leri ister ve sunucularda mesaj metnini okumak, ayrıcalıklı bir intent olan Message Content'i gerektirir. Developer Portal'da açın ve yukarıda gösterildiği gibi setEnabledIntents ile isteyin ya da bu sayfadaki botta olduğu gibi /ping gibi bir slash komutu kullanın; o ayrıcalıklı intent gerektirmez.
PlayNHost'ta Discord4J mi JDA mı?
İkisi de aynı Java bot türünde, aynı türde bir jar'dan çalışır. Yukarıdaki tabloda her biri için ölçtüğümüz bellek var. Asıl fark stildir: Discord4J Reactor üzerine kuruludur, yani Mono ve Flux zincirlersiniz; JDA ise dinleyiciler ve callback'ler kullanır. Kodunu okumayı daha kolay bulduğunuzu seçin. JDA adımları: Java Discord botu nasıl barındırılır.
Discord4J için hangi Java sürümünü seçmeliyim?
Önerilen Java 21; kendi kodunuz 25 gerektirmiyorsa. Discord4J'nin kendisi Java 8'den itibaren çalışır, yani sınır derlerken kullandığınız release'dir: sunucunun çalıştırdığından daha yeni bir Java için derlenmiş jar UnsupportedClassVersionError ile durur. Daha yeni bir Çalışma ortamı seçin ya da daha düşük bir release ile derleyin.
Discord4J jar'ım neden bu kadar büyük?
Çünkü her şeyi içerir: Discord4J, Reactor'ı, Netty'yi, Jackson'ı ve kendi ses modüllerini getirir; jar-with-dependencies derlemesi hepsini paketler. Testimizdeki jar 37 MB idi. Bu, planınızdaki disk alanıdır; çalışan botun kullandığı bellek yukarıdaki tablodadır.
Discord4J botunuzu gece gündüz çalıştırmaya hazır mısınız? Planlara Discord bot barındırma sayfasından bakın.



